Schnittstelle: IMMO - HeatingIncidentalCostBaseMeter Version 2018.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:	2018.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>2018.00</Version>
      
      
      
      <Mandant>7777</Mandant>
    </Parameter>
    <Transaction>
      <MeterData mode='SAVE'>
          
      </MeterData>
    </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" "-aIMMO" "-version2018.00" "-M7777" "-acidHeatingIncidentalCostBaseMeter" "-mapidAbaDefault" "-datamodeXML" "-responseYES" "-responsefileX:\response.xml" "-exportfileX:\data.xml"

Import :
abaconnectimportconsole.exe "/USRuser" "/PWxxx" "-aIMMO" "-version2018.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
+ MeterData	Heiz-Nebenkosten Zaehler	-	-	-	Nein
- RealEstateNumber	Immobilien-Nr.	MeterData	Nummer	12	Nein
- MeterNumber	Zähler-Nr.	MeterData	Nummer	6	Nein
- MeterType	Zählertyp	MeterData	Nummer	4	Nein
- HeatingCostSwitch	VHKA-Heizkosten Ja / Nein	MeterData	Boolean	-	Nein
- WarmWaterCostSwitch	VHKA-Warmwasserkosten Ja / Nein	MeterData	Boolean	-	Nein
- SettlementType	Abrechnungsart	MeterData	Nummer	12	Nein
- LogMeterValues	Zählerwerte Protokollieren	MeterData	Nummer	4	Nein
- InactiveSwitch	Inaktiv Ja/Nein	MeterData	Boolean	-	Nein
- InactiveFrom	Inaktiv per	MeterData	Datum	-	Nein
- OverrideMeteringCompany	Ablesefirma übersteuern Ja / Nein	MeterData	Boolean	-	Nein
- OverrideType	Übersteuerungs-Typ	MeterData	Nummer	2	Nein
- OverrideNumber	Übersteuern-Nr	MeterData	Nummer	12	Nein
- MeteringCompanyNumber	Ablesefirma-Nr	MeterData	Nummer	6	Nein
- HeatingCostSettlementNumber	VHKA-Nr	MeterData	Text	50	Nein
- CreationDate	Datensatz-Erstellungs-Datum	MeterData	Datum/Zeit	-	Nein
- CreationUserName	Datensatz-Erstellungs-Benutzer	MeterData	Text	50	Nein
- ModificationDate	Datensatz-Modifikations-Datum	MeterData	Datum/Zeit	-	Nein
- ModificationUserName	Datensatz-Modifikations-Benutzer	MeterData	Text	50	Nein
- OverrideSelection	Auswahl übersteuern Ja / Nein	MeterData	Boolean	-	Nein
- WaterCostsSwitch	VHKA-Wasserkosten	MeterData	Boolean	-	Nein
- AbsoluteValueSwitch	Absolute Werte	MeterData	Boolean	-	Nein
- EnterAmount	Betrag erfassen	MeterData	Boolean	-	Nein
+ DesignationData	Liste der Bezeichnungen	MeterData	-	-	Nein
- Language	Sprache	DesignationData	Text	6	Ja
- Designation	Bezeichnung	DesignationData	Text	4096	Ja
+ OverrideSelectionList	Auswahl übersteuern Liste	MeterData	-	-	Nein
- ConnectionType	Verbindung zu Datensatz-Typ	OverrideSelectionList	Nummer	4	Nein
- RefNum	Referenz-Nummer 1	OverrideSelectionList	Nummer	12	Nein

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: 12

Dezimal-Stellen: 0

Zwingendes Feld: Nein

Revision: 0

Ascii 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: 6

Dezimal-Stellen: 0

Zwingendes Feld: Nein

Revision: 0

Ascii 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: 4

Dezimal-Stellen: 0

Zwingendes Feld: Nein

Revision: 0

Ascii 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: 0

Zwingendes Feld: Nein

Revision: 0

Ascii 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: 0

Zwingendes Feld: Nein

Revision: 0

Ascii 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: 12

Dezimal-Stellen: 0

Zwingendes Feld: Nein

Revision: 0

Ascii 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: 4

Dezimal-Stellen: 0

Zwingendes Feld: Nein

Revision: 0

Ascii 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: 0

Zwingendes Feld: Nein

Revision: 0

Ascii 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: 0

Zwingendes Feld: Nein

Revision: 0

Ascii 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: 0

Zwingendes Feld: Nein

Revision: 0

Ascii 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: 2

Dezimal-Stellen: 0

Zwingendes Feld: Nein

Revision: 0

Ascii 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: 12

Dezimal-Stellen: 0

Zwingendes Feld: Nein

Revision: 0

Ascii 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: 6

Dezimal-Stellen: 0

Zwingendes Feld: Nein

Revision: 0

Ascii 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: 50

Dezimal-Stellen: 0

Zwingendes Feld: Nein

Revision: 0

Ascii 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: 0

Zwingendes Feld: Nein

Revision: 0

Ascii 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: 50

Dezimal-Stellen: 0

Zwingendes Feld: Nein

Revision: 0

Ascii 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: 0

Zwingendes Feld: Nein

Revision: 0

Ascii 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: 50

Dezimal-Stellen: 0

Zwingendes Feld: Nein

Revision: 0

Ascii 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: 0

Zwingendes Feld: Nein

Revision: 0

Ascii ID : -

Beschreibung:

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

VHKA-Wasserkosten

XML Element Name:	WaterCostsSwitch
Parent Element:	MeterData

Feld Typ:

Boolean (true oder false)

Action Typ:

Import und Export

Feld Länge: -

Dezimal-Stellen: 0

Zwingendes Feld: Nein

Revision: 0

Ascii ID : -

Beschreibung:

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

Absolute Werte

XML Element Name:	AbsoluteValueSwitch
Parent Element:	MeterData

Feld Typ:

Boolean (true oder false)

Action Typ:

Import und Export

Feld Länge: -

Dezimal-Stellen: 0

Zwingendes Feld: Nein

Revision: 0

Ascii ID : -

Beschreibung:

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

Betrag erfassen

XML Element Name:	EnterAmount
Parent Element:	MeterData

Feld Typ:

Boolean (true oder false)

Action Typ:

Import und Export

Feld Länge: -

Dezimal-Stellen: 0

Zwingendes Feld: Nein

Revision: 0

Ascii ID : -

Beschreibung:

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

Liste der Bezeichnungen

XML Element Name:	DesignationData
Parent Element:	MeterData

Feld Typ:

Linked List

Action Typ:

Import und Export

Feld Länge: -

Dezimal-Stellen: 0

Zwingendes Feld: Nein

Revision: 0

Ascii 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: 6

Dezimal-Stellen: 0

Zwingendes Feld: Ja

Revision: 0

Ascii 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: 4096

Dezimal-Stellen: 0

Zwingendes Feld: Ja

Revision: 0

Ascii 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: 0

Zwingendes Feld: Nein

Revision: 0

Ascii 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: 4

Dezimal-Stellen: 0

Zwingendes Feld: Nein

Revision: 0

Ascii 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: 12

Dezimal-Stellen: 0

Zwingendes Feld: Nein

Revision: 0

Ascii ID : -

Beschreibung:

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