Schnittstelle: PROJ - N44 Version 2010.00

Dieses Dokument beschreibt die AbaConnect-Schnittstelle N44 der Applikation PROJ .


Allgemeine Informationen

Allgemeine Informationen zur Schnittstelle.

AbaConnect Schnittstellen Information
Applikation:PROJ
Schnittstellen-Name:Ansätze
ID:N44 ( NStamm )
Version:2010.00


Mögliche Export- und Import-Funktionen der Schnittstelle

Export / Import Funktionen
Export:XML
Import:XML


Zusätzliche Informationen zur Schnittstelle

Zusatzinformation
Die Ansatzfindung erfolgt nach der Regel:
Suche nach
 LeArtNr = NBW.LeArtNr
 Tarif = NPO.TarifNr
Wenn kein Ansatz gefunden, dann suche nach
 LeArtNr = NBW.LeArtNr
 Tarif = 0
Wenn kein Ansatz gefunden, dann suche nach
 LeArtNr = 0
 Tarif = NPO.TarifNr
Wenn kein Ansatz gefunden, dann suche nach
 LeArtNr = 0
 Tarif = 0

Es wird immer zuerst versucht der Projektspezifische Ansatz zu lesen, wenn dieser nicht gefunden wird, dann allgemeine.

Wenn kein Ansatz gefunden und der Ansatz vom Mitarbeiter geholt wird, dann werden die obigen Schritte mit der Mitarbeitergruppe wiederholt.

Wenn kein Ansatz gefunden und der Ansatz der Kostenstelle, des Kunden, der Anlage, der Mitabeitergruppe oder des Projekts gesucht wird, dann werden die obigen Schritte mit Key = 0 wiederholt.

Bsp. Suche des Ansatzes eines Mitarbeiters:
1. Suche nach projektspezifischem Mitarbeiteransatz
2. Suche nach Mitarbeiteransatz
3. Suche nach projektspezifischem Mitarbeitergruppenansatz
4. Suche nach Mitarbeitergruppenansatz
5. Suche nach Ansatz von Mitarbeitergruppe 0
Höchste Feld Revision für dieser Schnittstelle : 0



Mapping Informationen

Im Folgenden werden die Informationen über das Mapping angezeigt.

Mapping Informationen
Mapping ID:AbaDefault
Mapping Name:Ansätze
Beschreibung:



Beispiel AbaConnect XML-Struktur

Es folgt ein Beispiel einer XML Header-Struktur. Diese Information kann man auch in einer AbaConnect XML-Exportdatei anschauen, die über die ABACUS AbaConnect Maske exportiert wurde.

AbaConnect XML-Struktur
<?xml version='1.0' encoding='UTF-8'?>
<AbaConnectContainer>
  <TaskCount>1</TaskCount>
  <Task>
    <Parameter>
      <Application>PROJ</Application>
      <Id>N44</Id>
      <MapId>AbaDefault</MapId>
      <Version>2010.00</Version>
      <!-- Achtung : Die Mandantennummer ist optional und bedeutet, dass die Daten nur in den definierten Mandanten importiert werden können -->
      <!-- Die Option Mandant hat nur beim Datenimport einen Einfluss. Dies kann in den AbaConnect Export-Einstellungen konfiguriert werden. -->
      <!-- Die Mandantennummer wird standardmässig nicht in die Export-Datei geschrieben -->
      <Mandant>7777</Mandant>
    </Parameter>
    <Transaction>
      <ProjectRate mode='SAVE'>
          <!-- Hier können spezifische Datenfelder für die AbaConnect Schnittstelle definiert werden. -->
      </ProjectRate>
    </Transaction>
  </Task>
</AbaConnectContainer>



Beispiel AbaConnect Command Line

Es folgen Beispiele für die AbaConnect Command Line. Ab ABACUS V2010 wird AbaConnect Command Line mit den Programmen abaconnectexportconsole.exe und abaconnectimportconsole.exe, anstatt abajvm.exe, ausgeführt. Detaillierte Informationen über AbaConnect Command Line sind auf der ABACUS Homepage zu finden.

AbaConnect Command Line
Export :
abaconnectexportconsole.exe "/USRuser" "/PWxxx"  "-aPROJ"  "-version2010.00"  "-M7777"  "-acidN44"  "-mapidAbaDefault"  "-datamodeXML"  "-responseYES"  "-responsefileX:\response.xml"  "-exportfileX:\data.xml"

Import :
abaconnectimportconsole.exe "/USRuser" "/PWxxx"  "-aPROJ"  "-version2010.00"  "-M7777"  "-datamodeXML"  "-responseYES"  "-responsefileX:\response.xml"  "-importfileX:\data.xml"

N.B. : Beim Import von XML-Daten muss die Schnittstellen-ID und das Mapping auf der Command Line nicht angegeben werden. Diese Information ist in der XML Import-Datei enthalten.



Mapping Felder / Struktur

Die folgende Tabelle zeigt die Daten des Mappings in vereinfachter Form an.
Das XML-Element und der Parent-Name werden immer in Englisch geschrieben. Mit einem Mausklick auf eine Zeile werden zusätzliche Informationen angezeigt.

XML Element Name Feld Name Parent Name Typ Feld Länge Zwingend
ProjectRateAnsätze---Ja
    - RecordTypeAnsatzartProjectRateNummer4Ja
    - CodeCodeProjectRateNummer12Ja
    - ServiceCodeLeistungsartProjectRateNummer8Ja
    - TariffTarifProjectRateNummer12Ja
    - DateDatumProjectRateDatum-Ja
    - CurrencyWährungProjectRateText3Ja
    - InternalRateDefinitionDefinition Feld Ansatz internProjectRateNummer2Nein
    - InternalRateAnsatz internProjectRateNummer12Nein
    - ExternalRateDefinitionDefinition Feld Ansatz externProjectRateNummer2Nein
    - ExternalRateAnsatz externProjectRateNummer12Nein
    - BaseRateBasisansatzProjectRateNummer12Nein



Detaillierte Feld-Informationen

Detaillierte Beschreibung der Schnittstellen-Felder.

Ansatzart
XML Element Name:RecordType
Parent Element:ProjectRate
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   4Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   4
Beschreibung:

            (Den internen Feld ID für dieses Element ist "Dataset")

Code
XML Element Name:Code
Parent Element:ProjectRate
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   12Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   4
Beschreibung:

            (Den internen Feld ID für dieses Element ist "Key")

Leistungsart
XML Element Name:ServiceCode
Parent Element:ProjectRate
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   8Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   4
Beschreibung:

            (Den internen Feld ID für dieses Element ist "LeArtNr")

Tarif
XML Element Name:Tariff
Parent Element:ProjectRate
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   12Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   4
Beschreibung:

            (Den internen Feld ID für dieses Element ist "Tarif")

Datum
XML Element Name:Date
Parent Element:ProjectRate
Feld Typ:Datum (2000-03-20)
Action Typ:Import und Export
Feld Länge:   -Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   4
Beschreibung:

            (Den internen Feld ID für dieses Element ist "Datum")

Währung
XML Element Name:Currency
Parent Element:ProjectRate
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   3Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   4
Beschreibung:

            (Den internen Feld ID für dieses Element ist "ISOCode")

Definition Feld Ansatz intern
XML Element Name:InternalRateDefinition
Parent Element:ProjectRate
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   2Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   4
Beschreibung:
Wie soll der Ansatz berechnet werden ?
(Den internen Feld ID für dieses Element ist "AsIntDef")

Ansatz intern
XML Element Name:InternalRate
Parent Element:ProjectRate
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   12Dezimal-Stellen:   4Zwingendes Feld:   NeinRevision:   0Ascii ID :   4
Beschreibung:

            (Den internen Feld ID für dieses Element ist "AnsatzInt")
Als Dezimaltrenner muss ein Punkt verwendet werden. Dies gemäss dem XML Standard von W3C.

Definition Feld Ansatz extern
XML Element Name:ExternalRateDefinition
Parent Element:ProjectRate
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   2Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   4
Beschreibung:
Wie soll der Ansatz berechnet werden ?
(Den internen Feld ID für dieses Element ist "AsExtDef")

Ansatz extern
XML Element Name:ExternalRate
Parent Element:ProjectRate
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   12Dezimal-Stellen:   4Zwingendes Feld:   NeinRevision:   0Ascii ID :   4
Beschreibung:

            (Den internen Feld ID für dieses Element ist "AnsatzExt")
Als Dezimaltrenner muss ein Punkt verwendet werden. Dies gemäss dem XML Standard von W3C.

Basisansatz
XML Element Name:BaseRate
Parent Element:ProjectRate
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   12Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   4
Beschreibung:
Von hier wird der Basisansatz bezogen. 
Basisansätze sind die Ansätze mit Tarif und Le.-Art = 0
(Den internen Feld ID für dieses Element ist "RelKey")