Interface: IMMO - Version 2017.00

This documentation describes the AbaConnect Interface for the IMMO Application.


General Information

General information about the AbaConnect interface.

AbaConnect Interface Information
Application :IMMO
Interface Name :
ID :HeatingIncidentalCostBaseMeter ( HeatingIncidentalCostBaseMeter )
Version :2017.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 : 1



Mapping Information

The following displays the Mapping details for this interface.

Mapping Information
Mapping ID :AbaDefault
Mapping Name :
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>IMMO</Application>
      <Id>HeatingIncidentalCostBaseMeter</Id>
      <MapId>AbaDefault</MapId>
      <Version>2017.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>
      <MeterData mode='SAVE'>
          <!-- The specific data fields for the AbaConnect interface are included here. -->
      </MeterData>
    </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"  "-aIMMO"  "-version2017.00"  "-M7777"  "-acidHeatingIncidentalCostBaseMeter"  "-mapidAbaDefault"  "-datamodeXML"  "-responseYES"  "-responsefileX:\response.xml"  "-exportfileX:\data.xml"

Import :
abaconnectimportconsole.exe "/USRuser" "/PWxxx"  "-aIMMO"  "-version2017.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
MeterData---No
    - RealEstateNumberMeterDataNumber12No
    - MeterNumberMeterDataNumber6No
    - MeterTypeMeterDataNumber4No
    - HeatingCostSwitchMeterDataBoolean-No
    - WarmWaterCostSwitchMeterDataBoolean-No
    - SettlementTypeMeterDataNumber12No
    - LogMeterValuesMeterDataNumber4No
    - InactiveSwitchMeterDataBoolean-No
    - InactiveFromMeterDataDate-No
    - OverrideMeteringCompanyMeterDataBoolean-No
    - OverrideTypeMeterDataNumber2No
    - OverrideNumberMeterDataNumber12No
    - MeteringCompanyNumberMeterDataNumber6No
    - HeatingCostSettlementNumberMeterDataText50No
    - CreationDateMeterDataDate/Time-No
    - CreationUserNameMeterDataText50No
    - ModificationDateMeterDataDate/Time-No
    - ModificationUserNameMeterDataText50No
    - OverrideSelectionMeterDataBoolean-No
    - WaterCostsSwitchMeterDataBoolean-No
    - AbsoluteValueSwitchMeterDataBoolean-No
    DesignationDataMeterData--No
        - LanguageDesignationDataText6Yes
        - DesignationDesignationDataText4096Yes
    OverrideSelectionListMeterData--No
        - ConnectionTypeOverrideSelectionListNumber4No
        - RefNumOverrideSelectionListNumber12No



Field Information

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

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

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

XML Element Name:MeterNumber
Parent Element:MeterData
Field Type:Nummer
Action Type:Import und Export
Field Length:   6Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

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

XML Element Name:MeterType
Parent Element:MeterData
Field Type:Nummer
Action Type:Import und Export
Field Length:   4Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

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

XML Element Name:HeatingCostSwitch
Parent Element:MeterData
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 "VHKAHeizkostenJN")
                    

XML Element Name:WarmWaterCostSwitch
Parent Element:MeterData
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 "VHKAWarmwKostenJN")
                    

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

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

XML Element Name:LogMeterValues
Parent Element:MeterData
Field Type:Nummer
Action Type:Import und Export
Field Length:   4Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

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

XML Element Name:InactiveSwitch
Parent Element:MeterData
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 "InaktivJN")
                    

XML Element Name:InactiveFrom
Parent Element:MeterData
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 "InaktivPer")
                    

XML Element Name:OverrideMeteringCompany
Parent Element:MeterData
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 "AblesefirmaUeberstJN")
                    

XML Element Name:OverrideType
Parent Element:MeterData
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 "UeberstTyp")
                    

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

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

XML Element Name:MeteringCompanyNumber
Parent Element:MeterData
Field Type:Nummer
Action Type:Import und Export
Field Length:   6Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

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

XML Element Name:HeatingCostSettlementNumber
Parent Element:MeterData
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 "VHKANr")
                    

XML Element Name:CreationDate
Parent Element:MeterData
Field Type:Datum/Zeit (2006-08-08T10:16:54.509+02:00)
Action Type:Export only
Field Length:   -Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

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

XML Element Name:CreationUserName
Parent Element:MeterData
Field Type:Text
Action Type:Export only
Field Length:   50Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

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

XML Element Name:ModificationDate
Parent Element:MeterData
Field Type:Datum/Zeit (2006-08-08T10:16:54.509+02:00)
Action Type:Export only
Field Length:   -Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

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

XML Element Name:ModificationUserName
Parent Element:MeterData
Field Type:Text
Action Type:Export only
Field Length:   50Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

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

XML Element Name:OverrideSelection
Parent Element:MeterData
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 "AuswahlUeberstJN")
                    

XML Element Name:WaterCostsSwitch
Parent Element:MeterData
Field Type:Boolean (true oder false)
Action Type:Import und Export
Field Length:   -Decimal Places:   0Mandatory Field:   NoRevision:   1Ascii ID :   -
Description:

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

XML Element Name:AbsoluteValueSwitch
Parent Element:MeterData
Field Type:Boolean (true oder false)
Action Type:Import und Export
Field Length:   -Decimal Places:   0Mandatory Field:   NoRevision:   1Ascii ID :   -
Description:

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

XML Element Name:DesignationData
Parent Element:MeterData
Field Type:Linked List
Action Type:Import und Export
Field Length:   -Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

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

XML Element Name:Language
Parent Element:DesignationData
Field Type:Text
Action Type:Import und Export
Field Length:   6Decimal Places:   0Mandatory Field:   YesRevision:   0Ascii ID :   -
Description:

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

XML Element Name:Designation
Parent Element:DesignationData
Field Type:Text
Action Type:Import und Export
Field Length:   4096Decimal Places:   0Mandatory Field:   YesRevision:   0Ascii ID :   -
Description:

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

XML Element Name:OverrideSelectionList
Parent Element:MeterData
Field Type:Linked List
Action Type:Import und Export
Field Length:   -Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

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

XML Element Name:ConnectionType
Parent Element:OverrideSelectionList
Field Type:Nummer
Action Type:Import und Export
Field Length:   4Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:

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

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

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