Interface: ADRE - Correspondence address Version 2021.00

This documentation describes the AbaConnect Interface Correspondence address for the ADRE Application.


General Information

General information about the AbaConnect interface.

AbaConnect Interface Information
Application :ADRE
Interface Name :Correspondence address
ID :CorrespondenceAddress ( FlatIntf )
Version :2021.00
Status:Productive


Displays the possible import and export features for this interface.

Export / Import Modus
Export :XML
Import :XML


Displays additional information for this interface.

Additional Information

                                  Highest field Revision for this interface : 2



Mapping Information

The following displays the Mapping details for this interface.

Mapping Information
Mapping ID :AbaDefault
Mapping Name :Correspondence address
Description :

                



Example AbaConnect XML Structure

The following is an example of an XML Header structure. This information is also visible in an AbaConnect XML Export file, that has been exported via the Abacus AbaConnect User Interface.

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>
      <!-- Attention : The client number (Mandant) is optional and implies that the data can only be imported into specified client (Mandant) -->
      <!-- The Client Option (Mandant) only has an influence when importing data. It can be configured in the AbaConnect Export Settings. -->
      <!-- By default, the client number (Mandant) is not written to the export file -->
      <Mandant>7777</Mandant>
    </Parameter>
    <Transaction>
      <ATAData mode='SAVE'>
          <!-- The specific data fields for the AbaConnect interface are included here. -->
      </ATAData>
    </Transaction>
  </Task>
</AbaConnectContainer>



Example AbaConnect Command Line

The following includes examples of AbaConnect Command Line. The AbaConnect Command Line is executed with the abaconnectexportconsole.exe and abaconnectimportconsole.exe programmes. The AbaConnect Command Line must be run direct on the Abacus server. More detailed information about AbaConnect Command Line is available on the Abacus Homepage. The following examples serve as starting point for creating a simple 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. : For importing XML data, it is not necessary to specify the Interface ID and Mapping on the Command Line. This information is contained in the XML Import file.



Mapping Structure

The following displays a simplified mapping structure for this interface.
The XML-Element and Parent-Name are always in english. Click on the row to display additional information.

XML Element Name Field Name Parent Name Type Length Mandatory
ATADataCorrespondence address---No
    - GuidCorresp. addr. keyATADataGUID36No
    - AddressNumberAddressNo.ATADataNumber10No
    - ValidFromValid fromATADataDate-No
    - AANMainSubjectUses Address fromATADataNumber10No
    - HasNoAddressHas no addressATADataBoolean-No
    - Line2Line 2ATADataText50No
    - Line3Line 3ATADataText50No
    - Line4Line 4ATADataText50No
    - Line5Line 5ATADataText50No
    - ZIPZIPATADataText15No
    - CityCityATADataText50No
    - StateStateATADataText50No
    - CountryCountryATADataText4No
    - StreetStreetATADataText50No
    - HouseNumberHouse numberATADataText9No
    - LatitudeLatitudeATADataNumber12No
    - LongitudeLongitudeATADataNumber12No
    - PostalCodeSupplementPTT supplementATADataNumber2No
    - DwellingNumbernombre de logementsATADataText12No
    - BuildingNumberIdentificateur de bâtimentATADataNumber10No
    - AddressAdditionAddress supplementATADataText60No
    - StreetAdditionStreet addendumATADataText60No
    - PostOfficeBoxTextMailbox textATADataText20No
    - PostOfficeBoxNumberMailbox numberATADataText15No
    - MunicipalityCodeMunicipality codeATADataText16No
    - OpenLocationCodeOpen Location CodeATADataText15No
    - StreetHouseNumberStreet / house numberATADataText60No
    - PostOfficeBoxTextNumberMailbox text / Mailbox numberATADataText35No



Field Information

The following is a detailed description of the fields used in this interface.

Corresp. addr. key
XML Element Name:Guid
Parent Element:ATAData
Field Type:GUID
Action Type:Import und Export
Field Length:   36Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "GUID")
                    

AddressNo.
XML Element Name:AddressNumber
Parent Element:ATAData
Field Type:Nummer
Action Type:Import und Export
Field Length:   10Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "INR")
                    

Valid from
XML Element Name:ValidFrom
Parent Element:ATAData
Field Type:Datum (2000-03-20)
Action Type:Import und Export
Field Length:   -Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "GUELTIG_AB")
                    

Uses Address from
XML Element Name:AANMainSubject
Parent Element:ATAData
Field Type:Nummer
Action Type:Import und Export
Field Length:   10Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "AAN_OBERSUBJEKT")
                    

Has no address
XML Element Name:HasNoAddress
Parent Element:ATAData
Field Type:Boolean (true oder false)
Action Type:Import und Export
Field Length:   -Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "HAS_NO_ADDRESS")
                    

Line 2
XML Element Name:Line2
Parent Element:ATAData
Field Type:Text
Action Type:Import und Export
Field Length:   50Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "ZEILE2")
                    

Line 3
XML Element Name:Line3
Parent Element:ATAData
Field Type:Text
Action Type:Import und Export
Field Length:   50Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "ZEILE3")
                    

Line 4
XML Element Name:Line4
Parent Element:ATAData
Field Type:Text
Action Type:Import und Export
Field Length:   50Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "ZEILE4")
                    

Line 5
XML Element Name:Line5
Parent Element:ATAData
Field Type:Text
Action Type:Import und Export
Field Length:   50Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "ZEILE5")
                    

ZIP
XML Element Name:ZIP
Parent Element:ATAData
Field Type:Text
Action Type:Import und Export
Field Length:   15Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "PLZ")
                    

City
XML Element Name:City
Parent Element:ATAData
Field Type:Text
Action Type:Import und Export
Field Length:   50Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "ORT")
                    

State
XML Element Name:State
Parent Element:ATAData
Field Type:Text
Action Type:Import und Export
Field Length:   50Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "STAAT")
                    

Country
XML Element Name:Country
Parent Element:ATAData
Field Type:Text
Action Type:Import und Export
Field Length:   4Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "LAND")
                    

Street
XML Element Name:Street
Parent Element:ATAData
Field Type:Text
Action Type:Import und Export
Field Length:   50Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "STREET")
                    

House number
XML Element Name:HouseNumber
Parent Element:ATAData
Field Type:Text
Action Type:Import und Export
Field Length:   9Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "HOUSE_NUMBER")
                    

Latitude
XML Element Name:Latitude
Parent Element:ATAData
Field Type:Nummer
Action Type:Import und Export
Field Length:   12Decimal Places:   8Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "LATITUDE")
                    
The decimal separator for numbers must be represented with a point, as defined by the XML standards from W3C.

Longitude
XML Element Name:Longitude
Parent Element:ATAData
Field Type:Nummer
Action Type:Import und Export
Field Length:   12Decimal Places:   8Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "LONGITUDE")
                    
The decimal separator for numbers must be represented with a point, as defined by the XML standards from W3C.

PTT supplement
XML Element Name:PostalCodeSupplement
Parent Element:ATAData
Field Type:Nummer
Action Type:Import und Export
Field Length:   2Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "PTT_ZUSATZ")
                    

nombre de logements
XML Element Name:DwellingNumber
Parent Element:ATAData
Field Type:Text
Action Type:Import und Export
Field Length:   12Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "DWELLING_NUMBER")
                    

Identificateur de bâtiment
XML Element Name:BuildingNumber
Parent Element:ATAData
Field Type:Nummer
Action Type:Import und Export
Field Length:   10Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "BuildingNumber")
                    

Address supplement
XML Element Name:AddressAddition
Parent Element:ATAData
Field Type:Text
Action Type:Import und Export
Field Length:   60Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "AddressAddition")
                    

Street addendum
XML Element Name:StreetAddition
Parent Element:ATAData
Field Type:Text
Action Type:Import und Export
Field Length:   60Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "StreetAddition")
                    

Mailbox text
XML Element Name:PostOfficeBoxText
Parent Element:ATAData
Field Type:Text
Action Type:Import und Export
Field Length:   20Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "PostOfficeBoxText")
                    

Mailbox number
XML Element Name:PostOfficeBoxNumber
Parent Element:ATAData
Field Type:Text
Action Type:Import und Export
Field Length:   15Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

                                  (The internal field ID for this element is "PostOfficeBoxNumber")
                    

Municipality code
XML Element Name:MunicipalityCode
Parent Element:ATAData
Field Type:Text
Action Type:Import und Export
Field Length:   16Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   2
Description:

                                  (The internal field ID for this element is "MunicipalityCode")
                    

Open Location Code
XML Element Name:OpenLocationCode
Parent Element:ATAData
Field Type:Text
Action Type:Import und Export
Field Length:   15Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   3
Description:

                                  (The internal field ID for this element is "OpenLocationCode")
                    

Street / house number
XML Element Name:StreetHouseNumber
Parent Element:ATAData
Field Type:Text
Action Type:Import und Export
Field Length:   60Decimal Places:   0Mandatory Field:   NoRevision:   1Ascii ID :   1
Description:

                                  (The internal field ID for this element is "StreetHouseNumber")
                    

Mailbox text / Mailbox number
XML Element Name:PostOfficeBoxTextNumber
Parent Element:ATAData
Field Type:Text
Action Type:Import und Export
Field Length:   35Decimal Places:   0Mandatory Field:   NoRevision:   2Ascii ID :   1
Description:

                                  (The internal field ID for this element is "PostOfficeBoxTextNumber")