Schnittstelle: IMMO - HeatingIncidentalCostBaseMeter Version 2010.00

Dieses Dokument beschreibt die AbaConnect-Schnittstelle HeatingIncidentalCostBaseMeter der Applikation IMMO .


Allgemeine Informationen

Allgemeine Informationen zur Schnittstelle.

AbaConnect Schnittstellen Information
Applikation:IMMO
Schnittstellen-Name:Heiz-Nebenkosten Zaehler
ID:HeatingIncidentalCostBaseMeter ( HeatingIncidentalCostBaseMeter )
Version:2010.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 : 0



Mapping Informationen

Im Folgenden werden die Informationen über das Mapping angezeigt.

Mapping Informationen
Mapping ID:AbaDefault
Mapping Name:Heiz-Nebenkosten Zaehler
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>IMMO</Application>
      <Id>HeatingIncidentalCostBaseMeter</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>
      <MeterData mode='SAVE'>
          <!-- Hier können spezifische Datenfelder für die AbaConnect Schnittstelle definiert werden. -->
      </MeterData>
    </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"  "-aIMMO"  "-version2010.00"  "-M7777"  "-acidHeatingIncidentalCostBaseMeter"  "-mapidAbaDefault"  "-datamodeXML"  "-responseYES"  "-responsefileX:\response.xml"  "-exportfileX:\data.xml"

Import :
abaconnectimportconsole.exe "/USRuser" "/PWxxx"  "-aIMMO"  "-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
MeterDataHeiz-Nebenkosten Zaehler---Nein
    - RealEstateNumberImmobilien-Nr.MeterDataNummer12Nein
    - MeterNumberZähler-Nr.MeterDataNummer6Nein
    - MeterTypeZählertypMeterDataNummer4Nein
    - HeatingCostSwitchVHKA-Heizkosten Ja / NeinMeterDataBoolean-Nein
    - WarmWaterCostSwitchVHKA-Warmwasserkosten Ja / NeinMeterDataBoolean-Nein
    - SettlementTypeAbrechnungsartMeterDataNummer12Nein
    - LogMeterValuesZählerwerte ProtokollierenMeterDataNummer4Nein
    - InactiveSwitchInaktiv Ja/NeinMeterDataBoolean-Nein
    - InactiveFromInaktiv perMeterDataDatum-Nein
    - OverrideMeteringCompanyAblesefirma übersteuern Ja / NeinMeterDataBoolean-Nein
    - OverrideTypeÜbersteuerungs-TypMeterDataNummer2Nein
    - OverrideNumberÜbersteuern-NrMeterDataNummer12Nein
    - MeteringCompanyNumberAblesefirma-NrMeterDataNummer6Nein
    - HeatingCostSettlementNumberVHKA-NrMeterDataText50Nein
    - CreationDateDatensatz-Erstellungs-DatumMeterDataDatum/Zeit-Nein
    - CreationUserNameDatensatz-Erstellungs-BenutzerMeterDataText50Nein
    - ModificationDateDatensatz-Modifikations-DatumMeterDataDatum/Zeit-Nein
    - ModificationUserNameDatensatz-Modifikations-BenutzerMeterDataText50Nein
    - OverrideSelectionAuswahl übersteuern Ja / NeinMeterDataBoolean-Nein
    DesignationDataListe der BezeichnungenMeterData--Nein
        - LanguageSpracheDesignationDataText1Ja
        - DesignationBezeichnungDesignationDataText4096Ja
    OverrideSelectionListAuswahl übersteuern ListeMeterData--Nein
        - ConnectionTypeVerbindung zu Datensatz-TypOverrideSelectionListNummer4Nein
        - RefNumReferenz-Nummer 1OverrideSelectionListNummer12Nein



Detaillierte Feld-Informationen

Detaillierte Beschreibung der Schnittstellen-Felder.

Immobilien-Nr.
XML Element Name:RealEstateNumber
Parent Element:MeterData
Feld Typ:Nummer
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 "ImmobilieNr")

Zähler-Nr.
XML Element Name:MeterNumber
Parent Element:MeterData
Feld Typ:Nummer
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 "Nr")

Zählertyp
XML Element Name:MeterType
Parent Element:MeterData
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 "Typ")

VHKA-Heizkosten Ja / Nein
XML Element Name:HeatingCostSwitch
Parent Element:MeterData
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 "VHKAHeizkostenJN")

VHKA-Warmwasserkosten Ja / Nein
XML Element Name:WarmWaterCostSwitch
Parent Element:MeterData
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 "VHKAWarmwKostenJN")

Abrechnungsart
XML Element Name:SettlementType
Parent Element:MeterData
Feld Typ:Nummer
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 "Abrechnungsart")

Zählerwerte Protokollieren
XML Element Name:LogMeterValues
Parent Element:MeterData
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 "ZaehlerwProtokoll")

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

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

Ablesefirma übersteuern Ja / Nein
XML Element Name:OverrideMeteringCompany
Parent Element:MeterData
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 "AblesefirmaUeberstJN")

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

Übersteuern-Nr
XML Element Name:OverrideNumber
Parent Element:MeterData
Feld Typ:Nummer
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 "UeberstNr")

Ablesefirma-Nr
XML Element Name:MeteringCompanyNumber
Parent Element:MeterData
Feld Typ:Nummer
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 "AblesefirmaNr")

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

Datensatz-Erstellungs-Datum
XML Element Name:CreationDate
Parent Element:MeterData
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 "CreationDate")

Datensatz-Erstellungs-Benutzer
XML Element Name:CreationUserName
Parent Element:MeterData
Feld Typ:Text
Action Typ:nur für Export
Feld Länge:   50Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Datensatz-Modifikations-Datum
XML Element Name:ModificationDate
Parent Element:MeterData
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 "ModificationDate")

Datensatz-Modifikations-Benutzer
XML Element Name:ModificationUserName
Parent Element:MeterData
Feld Typ:Text
Action Typ:nur für Export
Feld Länge:   50Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Auswahl übersteuern Ja / Nein
XML Element Name:OverrideSelection
Parent Element:MeterData
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 "AuswahlUeberstJN")

Liste der Bezeichnungen
XML Element Name:DesignationData
Parent Element:MeterData
Feld Typ:Linked List
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 "YBTDataSchemaList")

Sprache
XML Element Name:Language
Parent Element:DesignationData
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   1Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   -
Beschreibung:

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

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

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

Auswahl übersteuern Liste
XML Element Name:OverrideSelectionList
Parent Element:MeterData
Feld Typ:Linked List
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 "ObjekteUebersteuernData")

Verbindung zu Datensatz-Typ
XML Element Name:ConnectionType
Parent Element:OverrideSelectionList
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 "VerbindungsRecTyp")

Referenz-Nummer 1
XML Element Name:RefNum
Parent Element:OverrideSelectionList
Feld Typ:Nummer
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 "RefNum1")