Schnittstelle: NORM - BA Version 2012.00

Dieses Dokument beschreibt die AbaConnect-Schnittstelle BA der Applikation NORM .


Allgemeine Informationen

Allgemeine Informationen zur Schnittstelle.

AbaConnect Schnittstellen Information
Applikation:NORM
Schnittstellen-Name:Kalkulationsansatz
ID:BA ( BA )
Version:2012.00


Mögliche Export- und Import-Funktionen der Schnittstelle

Export / Import Funktionen
Export:XML
Import:XML


Zusätzliche Informationen zur Schnittstelle

Zusatzinformation
Stammdaten.
Siehe Comment des Feldes RECART.
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:Kalkulationsansatz
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>NORM</Application>
      <Id>BA</Id>
      <MapId>AbaDefault</MapId>
      <Version>2012.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>
      <CalculationRateHeader mode='SAVE'>
          <!-- Hier können spezifische Datenfelder für die AbaConnect Schnittstelle definiert werden. -->
      </CalculationRateHeader>
    </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"  "-aNORM"  "-version2012.00"  "-M7777"  "-acidBA"  "-mapidAbaDefault"  "-datamodeXML"  "-responseYES"  "-responsefileX:\response.xml"  "-exportfileX:\data.xml"

Import :
abaconnectimportconsole.exe "/USRuser" "/PWxxx"  "-aNORM"  "-version2012.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
CalculationRateHeaderKalkulationsansatz---Nein
    CalculationRateHeaderFieldsFelderCalculationRateHeader--Nein
        - IDIDCalculationRateHeaderFieldsText10Nein
        - RateTypeAnsatztypCalculationRateHeaderFieldsNummer2Nein
        - AverageSalaryProposalVorschlag MittellohnCalculationRateHeaderFieldsText10Nein
        - StandardNPK-StandardCalculationRateHeaderFieldsBoolean-Nein
        - AutomaticProjectTransferAutomatische Übernahme ins ProjektCalculationRateHeaderFieldsBoolean-Nein
        - ModificationDateDatum PreismutationCalculationRateHeaderFieldsDatum/Zeit-Nein
        - DataYearDatenjahrCalculationRateHeaderFieldsNummer4Nein
    CalculationRateHeaderTextKalkulationsansatz-KopftextCalculationRateHeader--Nein
        CalculationRateHeaderTextFieldsFelderCalculationRateHeaderText--Nein
            - LanguageCodeSpracheCalculationRateHeaderTextFieldsText6Nein
            - DesignationBezeichnungCalculationRateHeaderTextFieldsText60Nein
    CalculationRateItemKalkulationsansatz-PositionCalculationRateHeader--Nein
        CalculationRateItemFieldsFelderCalculationRateItem--Nein
            - ItemNumberPositions-Nr.CalculationRateItemFieldsNummer4Nein
            - ItemTypePositions-TypCalculationRateItemFieldsNummer2Nein
            - RecognitionTypeErkennungstypCalculationRateItemFieldsNummer2Nein
            - PosTypeInfoPos-Typ InfoCalculationRateItemFieldsNummer2Nein
            - ItemNumberReferenceBezugCalculationRateItemFieldsNummer4Nein
            - CalcGroupKalkulationsgruppeCalculationRateItemFieldsNummer8Nein
            - ValueWertCalculationRateItemFieldsNummer4Nein
            - ItemTotalPositions-TotalCalculationRateItemFieldsNummer6Nein
            - TotalTotalCalculationRateItemFieldsNummer6Nein
            - ExampleBeispielCalculationRateItemFieldsNummer12Nein
            - ItemAndRecognitionTypePositionstypCalculationRateItemFieldsText100000Nein
        CalculationRateItemTextKalkulationsansatz-PositionstextCalculationRateItem--Nein
            CalculationRateItemTextFieldsFelderCalculationRateItemText--Nein
                - LanguageCodeSpracheCalculationRateItemTextFieldsText6Nein
                - DesignationBezeichnungCalculationRateItemTextFieldsText60Nein



Detaillierte Feld-Informationen

Detaillierte Beschreibung der Schnittstellen-Felder.

Felder
XML Element Name:CalculationRateHeaderFields
Parent Element:CalculationRateHeader
Feld Typ:Type[ 15 ]
Action Typ:Import und Export
Feld Länge:   -Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:


ID
XML Element Name:ID
Parent Element:CalculationRateHeaderFields
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   10Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Ansatztyp
XML Element Name:RateType
Parent Element:CalculationRateHeaderFields
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   2Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Vorschlag Mittellohn
XML Element Name:AverageSalaryProposal
Parent Element:CalculationRateHeaderFields
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   10Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

NPK-Standard
XML Element Name:Standard
Parent Element:CalculationRateHeaderFields
Feld Typ:Boolean (true oder false)
Action Typ:Import und Export
Feld Länge:   -Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Automatische Übernahme ins Projekt
XML Element Name:AutomaticProjectTransfer
Parent Element:CalculationRateHeaderFields
Feld Typ:Boolean (true oder false)
Action Typ:Import und Export
Feld Länge:   -Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Datum Preismutation
XML Element Name:ModificationDate
Parent Element:CalculationRateHeaderFields
Feld Typ:Datum/Zeit (2006-08-08T10:16:54.509+02:00)
Action Typ:nur für Export
Feld Länge:   -Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Datenjahr
XML Element Name:DataYear
Parent Element:CalculationRateHeaderFields
Feld Typ:Nummer
Action Typ:nur für Export
Feld Länge:   4Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Kalkulationsansatz-Kopftext
XML Element Name:CalculationRateHeaderText
Parent Element:CalculationRateHeader
Feld Typ:ID
Action Typ:Import und Export
Feld Länge:   -Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Stammdaten

Felder
XML Element Name:CalculationRateHeaderTextFields
Parent Element:CalculationRateHeaderText
Feld Typ:Type[ 15 ]
Action Typ:Import und Export
Feld Länge:   -Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:


Sprache
XML Element Name:LanguageCode
Parent Element:CalculationRateHeaderTextFields
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   6Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Bezeichnung
XML Element Name:Designation
Parent Element:CalculationRateHeaderTextFields
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   60Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Kalkulationsansatz-Position
XML Element Name:CalculationRateItem
Parent Element:CalculationRateHeader
Feld Typ:ID
Action Typ:Import und Export
Feld Länge:   -Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Stammdaten.
Der Kopf im Stamm ist in BOS.RECART=KALKANSATZ.
Die zu den Positionen gehörenden Texte im Stamm sind in BOW.RECART=KALKANSATZPOS.
Die Positionen im Projekt sind in BLZ.

Felder
XML Element Name:CalculationRateItemFields
Parent Element:CalculationRateItem
Feld Typ:Type[ 15 ]
Action Typ:Import und Export
Feld Länge:   -Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:


Positions-Nr.
XML Element Name:ItemNumber
Parent Element:CalculationRateItemFields
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   4Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Positions-Typ
XML Element Name:ItemType
Parent Element:CalculationRateItemFields
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   2Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Erkennungstyp
XML Element Name:RecognitionType
Parent Element:CalculationRateItemFields
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   2Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Pos-Typ Info
XML Element Name:PosTypeInfo
Parent Element:CalculationRateItemFields
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   2Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Bezug
XML Element Name:ItemNumberReference
Parent Element:CalculationRateItemFields
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   4Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Kalkulationsgruppe
XML Element Name:CalcGroup
Parent Element:CalculationRateItemFields
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   8Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Wert
XML Element Name:Value
Parent Element:CalculationRateItemFields
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   4Dezimal-Stellen:   4Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Positions-Total
XML Element Name:ItemTotal
Parent Element:CalculationRateItemFields
Feld Typ:Nummer
Action Typ:nur für Export
Feld Länge:   6Dezimal-Stellen:   4Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Total
XML Element Name:Total
Parent Element:CalculationRateItemFields
Feld Typ:Nummer
Action Typ:nur für Export
Feld Länge:   6Dezimal-Stellen:   4Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Beispiel
XML Element Name:Example
Parent Element:CalculationRateItemFields
Feld Typ:Nummer
Action Typ:nur für Export
Feld Länge:   12Dezimal-Stellen:   8Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Positionstyp
XML Element Name:ItemAndRecognitionType
Parent Element:CalculationRateItemFields
Feld Typ:Text
Action Typ:nur für Export
Feld Länge:   100000Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Kalkulationsansatz-Positionstext
XML Element Name:CalculationRateItemText
Parent Element:CalculationRateItem
Feld Typ:ID
Action Typ:Import und Export
Feld Länge:   -Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Stammdaten

Felder
XML Element Name:CalculationRateItemTextFields
Parent Element:CalculationRateItemText
Feld Typ:Type[ 15 ]
Action Typ:Import und Export
Feld Länge:   -Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:


Sprache
XML Element Name:LanguageCode
Parent Element:CalculationRateItemTextFields
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   6Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Bezeichnung
XML Element Name:Designation
Parent Element:CalculationRateItemTextFields
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   60Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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