Schnittstelle: ADRE - CorrespondenceAddress Version 2021.00

Dieses Dokument beschreibt die AbaConnect-Schnittstelle CorrespondenceAddress der Applikation ADRE .

Allgemeine Informationen

Allgemeine Informationen zur Schnittstelle.

AbaConnect Schnittstellen Information
Applikation:ADRE
Schnittstellen-Name:Anschrift
ID:CorrespondenceAddress ( FlatIntf )
Version:2021.00


Mögliche Export- und Import-Funktionen der Schnittstelle

Export / Import Funktionen
Export:XML
Import:XML


Zusätzliche Informationen zur Schnittstelle

Zusatzinformation 

                                  Höchste Feld Revision für dieser Schnittstelle : 2		
            

        

        

        

        

        
Mapping Informationen

        
Im Folgenden werden die Informationen über das Mapping angezeigt.

        

            

                Mapping Informationen
            

        

        

            

                Mapping ID:AbaDefault
            

            

                Mapping Name:Anschrift
            

            

                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>ADRE</Application>
                    

                                              <Id>CorrespondenceAddress</Id>
                    

                                              <MapId>AbaDefault</MapId>
                    

                                              <Version>2021.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>
                    

                                                  <ATAData mode='SAVE'>
                    

                                                      <!-- Hier können spezifische Datenfelder für die AbaConnect Schnittstelle definiert werden.  -->
                    

                                                  </ATAData>
                    

                                            </Transaction>
                    

                                          </Task>
                    

                                      </AbaConnectContainer>
              		
            

        

        

        

        
        

        
Beispiel AbaConnect Command Line

        
Es folgen Beispiele für die AbaConnect Command Line. AbaConnect Command Line wird mit den Programmen
                abaconnectexportconsole.exe und abaconnectimportconsole.exe ausgeführt.  Die AbaConnect Command Line muss direkt auf dem Abacus Server ausgeführt werden.
                Detaillierte Informationen über AbaConnect Command Line sind auf der Abacus Homepage zu finden.  Die folgenden Beispiele dienen als Ausgangspunkt für die Erstellung einer einfachen Command Line.
            

        

            

                AbaConnect Command Line
            

            

                Export :
                    

                                            abaconnectexportconsole.exe "/USRuser" "/PWxxx"
                           "-aADRE"
                           "-version2021.00"
                           "-M7777"
                           "-acidCorrespondenceAddress"
                           "-mapidAbaDefault"
                           "-datamodeXML"
                         "-responseYES"
                         "-responsefileX:\response.xml"
                         "-exportfileX:\data.xml"
                    

                    

                    Import :
                    

                                            abaconnectimportconsole.exe "/USRuser" "/PWxxx"
                           "-aADRE"
                           "-version2021.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
            
            

            

                + ATADataAnschrift---Nein
            

            

                
                  
          - GuidAnschriftenschlüsselATADataGUID36Nein
            

            

                
                  
          - AddressNumberAdressNrATADataNummer10Nein
            

            

                
                  
          - ValidFromGültig abATADataDatum-Nein
            

            

                
                  
          - AANMainSubjectBenutzt Anschrift vonATADataNummer10Nein
            

            

                
                  
          - HasNoAddressHat keine AnschriftATADataBoolean-Nein
            

            

                
                  
          - Line2Zeile 2ATADataText50Nein
            

            

                
                  
          - Line3Zeile 3ATADataText50Nein
            

            

                
                  
          - Line4Zeile 4ATADataText50Nein
            

            

                
                  
          - Line5Zeile 5ATADataText50Nein
            

            

                
                  
          - ZIPPostleitzahlATADataText15Nein
            

            

                
                  
          - CityOrtATADataText50Nein
            

            

                
                  
          - StateStaatATADataText50Nein
            

            

                
                  
          - CountryLandATADataText4Nein
            

            

                
                  
          - StreetStrasseATADataText50Nein
            

            

                
                  
          - HouseNumberHausnummerATADataText9Nein
            

            

                
                  
          - LatitudeBreitengradATADataNummer12Nein
            

            

                
                  
          - LongitudeLängengradATADataNummer12Nein
            

            

                
                  
          - PostalCodeSupplementPTT ZusatzATADataNummer2Nein
            

            

                
                  
          - DwellingNumberWohnungsnummerATADataText12Nein
            

            

                
                  
          - BuildingNumberGebäudeidentifikatorATADataNummer10Nein
            

            

                
                  
          - AddressAdditionAdresszusatzATADataText60Nein
            

            

                
                  
          - StreetAdditionStrassenzusatzATADataText60Nein
            

            

                
                  
          - PostOfficeBoxTextPostfach TextATADataText20Nein
            

            

                
                  
          - PostOfficeBoxNumberPostfach NummerATADataText15Nein
            

            

                
                  
          - MunicipalityCodeGemeindecodeATADataText16Nein
            

            

                
                  
          - OpenLocationCodeOpen Location CodeATADataText15Nein
            

            

                
                  
          - StreetHouseNumberStrasse / HausnummerATADataText60Nein
            

            

                
                  
          - PostOfficeBoxTextNumberPostfach Text / Postfach NummerATADataText35Nein
            

            
        

        

        

        
        

        
Detaillierte Feld-Informationen

        
Detaillierte Beschreibung der Schnittstellen-Felder.

        
        

            

                Anschriftenschlüssel
            

        

        

            

                XML Element Name:Guid
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:GUID
            

        

        

            

                Action Typ:Import und Export
            

        

        

            

                Feld Länge:
           
          36Dezimal-Stellen:
           
          0Zwingendes Feld:
           
          NeinRevision:
           
          0Ascii ID :
           
          -
            

        

        

            

                Beschreibung:
                    

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

                		
            

        

        

        
        

            

                AdressNr
            

        

        

            

                XML Element Name:AddressNumber
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:Nummer
            

        

        

            

                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 "INR")
                    

                		
            

        

        

        
        

            

                Gültig ab
            

        

        

            

                XML Element Name:ValidFrom
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:Datum (2000-03-20)
            

        

        

            

                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 "GUELTIG_AB")
                    

                		
            

        

        

        
        

            

                Benutzt Anschrift von
            

        

        

            

                XML Element Name:AANMainSubject
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:Nummer
            

        

        

            

                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 "AAN_OBERSUBJEKT")
                    

                		
            

        

        

        
        

            

                Hat keine Anschrift
            

        

        

            

                XML Element Name:HasNoAddress
            

            

                Parent Element:ATAData
            

        

        

            

                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 "HAS_NO_ADDRESS")
                    

                		
            

        

        

        
        

            

                Zeile 2
            

        

        

            

                XML Element Name:Line2
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:Text
            

        

        

            

                Action Typ:Import und Export
            

        

        

            

                Feld Länge:
           
          50Dezimal-Stellen:
           
          0Zwingendes Feld:
           
          NeinRevision:
           
          0Ascii ID :
           
          -
            

        

        

            

                Beschreibung:
                    

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

                		
            

        

        

        
        

            

                Zeile 3
            

        

        

            

                XML Element Name:Line3
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:Text
            

        

        

            

                Action Typ:Import und Export
            

        

        

            

                Feld Länge:
           
          50Dezimal-Stellen:
           
          0Zwingendes Feld:
           
          NeinRevision:
           
          0Ascii ID :
           
          -
            

        

        

            

                Beschreibung:
                    

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

                		
            

        

        

        
        

            

                Zeile 4
            

        

        

            

                XML Element Name:Line4
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:Text
            

        

        

            

                Action Typ:Import und Export
            

        

        

            

                Feld Länge:
           
          50Dezimal-Stellen:
           
          0Zwingendes Feld:
           
          NeinRevision:
           
          0Ascii ID :
           
          -
            

        

        

            

                Beschreibung:
                    

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

                		
            

        

        

        
        

            

                Zeile 5
            

        

        

            

                XML Element Name:Line5
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:Text
            

        

        

            

                Action Typ:Import und Export
            

        

        

            

                Feld Länge:
           
          50Dezimal-Stellen:
           
          0Zwingendes Feld:
           
          NeinRevision:
           
          0Ascii ID :
           
          -
            

        

        

            

                Beschreibung:
                    

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

                		
            

        

        

        
        

            

                Postleitzahl
            

        

        

            

                XML Element Name:ZIP
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:Text
            

        

        

            

                Action Typ:Import und Export
            

        

        

            

                Feld Länge:
           
          15Dezimal-Stellen:
           
          0Zwingendes Feld:
           
          NeinRevision:
           
          0Ascii ID :
           
          -
            

        

        

            

                Beschreibung:
                    

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

                		
            

        

        

        
        

            

                Ort
            

        

        

            

                XML Element Name:City
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:Text
            

        

        

            

                Action Typ:Import und Export
            

        

        

            

                Feld Länge:
           
          50Dezimal-Stellen:
           
          0Zwingendes Feld:
           
          NeinRevision:
           
          0Ascii ID :
           
          -
            

        

        

            

                Beschreibung:
                    

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

                		
            

        

        

        
        

            

                Staat
            

        

        

            

                XML Element Name:State
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:Text
            

        

        

            

                Action Typ:Import und Export
            

        

        

            

                Feld Länge:
           
          50Dezimal-Stellen:
           
          0Zwingendes Feld:
           
          NeinRevision:
           
          0Ascii ID :
           
          -
            

        

        

            

                Beschreibung:
                    

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

                		
            

        

        

        
        

            

                Land
            

        

        

            

                XML Element Name:Country
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:Text
            

        

        

            

                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 "LAND")
                    

                		
            

        

        

        
        

            

                Strasse
            

        

        

            

                XML Element Name:Street
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:Text
            

        

        

            

                Action Typ:Import und Export
            

        

        

            

                Feld Länge:
           
          50Dezimal-Stellen:
           
          0Zwingendes Feld:
           
          NeinRevision:
           
          0Ascii ID :
           
          -
            

        

        

            

                Beschreibung:
                    

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

                		
            

        

        

        
        

            

                Hausnummer
            

        

        

            

                XML Element Name:HouseNumber
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:Text
            

        

        

            

                Action Typ:Import und Export
            

        

        

            

                Feld Länge:
           
          9Dezimal-Stellen:
           
          0Zwingendes Feld:
           
          NeinRevision:
           
          0Ascii ID :
           
          -
            

        

        

            

                Beschreibung:
                    

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

                		
            

        

        

        
        

            

                Breitengrad
            

        

        

            

                XML Element Name:Latitude
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:Nummer
            

        

        

            

                Action Typ:Import und Export
            

        

        

            

                Feld Länge:
           
          12Dezimal-Stellen:
           
          8Zwingendes Feld:
           
          NeinRevision:
           
          0Ascii ID :
           
          -
            

        

        

            

                Beschreibung:
                    

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

                                Als Dezimaltrenner muss ein Punkt verwendet werden. Dies gemäss dem XML Standard von W3C.
                    

                		
            

        

        

        
        

            

                Längengrad
            

        

        

            

                XML Element Name:Longitude
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:Nummer
            

        

        

            

                Action Typ:Import und Export
            

        

        

            

                Feld Länge:
           
          12Dezimal-Stellen:
           
          8Zwingendes Feld:
           
          NeinRevision:
           
          0Ascii ID :
           
          -
            

        

        

            

                Beschreibung:
                    

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

                                Als Dezimaltrenner muss ein Punkt verwendet werden. Dies gemäss dem XML Standard von W3C.
                    

                		
            

        

        

        
        

            

                PTT Zusatz
            

        

        

            

                XML Element Name:PostalCodeSupplement
            

            

                Parent Element:ATAData
            

        

        

            

                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 "PTT_ZUSATZ")
                    

                		
            

        

        

        
        

            

                Wohnungsnummer
            

        

        

            

                XML Element Name:DwellingNumber
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:Text
            

        

        

            

                Action Typ:Import und Export
            

        

        

            

                Feld Länge:
           
          12Dezimal-Stellen:
           
          0Zwingendes Feld:
           
          NeinRevision:
           
          0Ascii ID :
           
          -
            

        

        

            

                Beschreibung:
                    

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

                		
            

        

        

        
        

            

                Gebäudeidentifikator
            

        

        

            

                XML Element Name:BuildingNumber
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:Nummer
            

        

        

            

                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 "BuildingNumber")
                    

                		
            

        

        

        
        

            

                Adresszusatz
            

        

        

            

                XML Element Name:AddressAddition
            

            

                Parent Element:ATAData
            

        

        

            

                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 "AddressAddition")
                    

                		
            

        

        

        
        

            

                Strassenzusatz
            

        

        

            

                XML Element Name:StreetAddition
            

            

                Parent Element:ATAData
            

        

        

            

                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 "StreetAddition")
                    

                		
            

        

        

        
        

            

                Postfach Text
            

        

        

            

                XML Element Name:PostOfficeBoxText
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:Text
            

        

        

            

                Action Typ:Import und Export
            

        

        

            

                Feld Länge:
           
          20Dezimal-Stellen:
           
          0Zwingendes Feld:
           
          NeinRevision:
           
          0Ascii ID :
           
          -
            

        

        

            

                Beschreibung:
                    

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

                		
            

        

        

        
        

            

                Postfach Nummer
            

        

        

            

                XML Element Name:PostOfficeBoxNumber
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:Text
            

        

        

            

                Action Typ:Import und Export
            

        

        

            

                Feld Länge:
           
          15Dezimal-Stellen:
           
          0Zwingendes Feld:
           
          NeinRevision:
           
          0Ascii ID :
           
          -
            

        

        

            

                Beschreibung:
                    

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

                		
            

        

        

        
        

            

                Gemeindecode
            

        

        

            

                XML Element Name:MunicipalityCode
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:Text
            

        

        

            

                Action Typ:Import und Export
            

        

        

            

                Feld Länge:
           
          16Dezimal-Stellen:
           
          0Zwingendes Feld:
           
          NeinRevision:
           
          0Ascii ID :
           
          2
            

        

        

            

                Beschreibung:
                    

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

                		
            

        

        

        
        

            

                Open Location Code
            

        

        

            

                XML Element Name:OpenLocationCode
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:Text
            

        

        

            

                Action Typ:Import und Export
            

        

        

            

                Feld Länge:
           
          15Dezimal-Stellen:
           
          0Zwingendes Feld:
           
          NeinRevision:
           
          0Ascii ID :
           
          3
            

        

        

            

                Beschreibung:
                    

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

                		
            

        

        

        
        

            

                Strasse / Hausnummer
            

        

        

            

                XML Element Name:StreetHouseNumber
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:Text
            

        

        

            

                Action Typ:Import und Export
            

        

        

            

                Feld Länge:
           
          60Dezimal-Stellen:
           
          0Zwingendes Feld:
           
          NeinRevision:
           
          1Ascii ID :
           
          1
            

        

        

            

                Beschreibung:
                    

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

                		
            

        

        

        
        

            

                Postfach Text / Postfach Nummer
            

        

        

            

                XML Element Name:PostOfficeBoxTextNumber
            

            

                Parent Element:ATAData
            

        

        

            

                Feld Typ:Text
            

        

        

            

                Action Typ:Import und Export
            

        

        

            

                Feld Länge:
           
          35Dezimal-Stellen:
           
          0Zwingendes Feld:
           
          NeinRevision:
           
          2Ascii ID :
           
          1
            

        

        

            

                Beschreibung:
                    

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