Schnittstelle: IMMO - ConsumptionValues Version 2016.00

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

Allgemeine Informationen

Allgemeine Informationen zur Schnittstelle.

AbaConnect Schnittstellen Information

Applikation:	IMMO
Schnittstellen-Name:	Heiz-Nebenkosten Verbrauchswerte
ID:	ConsumptionValues ( ConsumptionValues )
Version:	2016.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 Verbrauchswerte
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>ConsumptionValues</Id>
      <MapId>AbaDefault</MapId>
      <Version>2016.00</Version>
      
      
      
      <Mandant>7777</Mandant>
    </Parameter>
    <Transaction>
      <ConsumptionValues mode='SAVE'>
          
      </ConsumptionValues>
    </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" "-version2016.00" "-M7777" "-acidConsumptionValues" "-mapidAbaDefault" "-datamodeXML" "-responseYES" "-responsefileX:\response.xml" "-exportfileX:\data.xml"

Import :
abaconnectimportconsole.exe "/USRuser" "/PWxxx" "-aIMMO" "-version2016.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
+ ConsumptionValues	Heiz-Nebenkosten Verbrauchswerte	-	-	-	Nein
- RealEstateNumber	Eindeutige Immobilien-Nr.	ConsumptionValues	Nummer	12	Ja
- MeterNumber	Zähler-Nr.	ConsumptionValues	Nummer	6	Ja
- SettlementType	Abrechnungsart	ConsumptionValues	Nummer	12	Ja
- PeriodFrom	Periode von	ConsumptionValues	Datum	-	Ja
- ObjectNumber	Objekt-Nr.	ConsumptionValues	Nummer	12	Nein
- ObjectContractNumber	Objektvertrag-Nr.	ConsumptionValues	Nummer	12	Nein
- OldValue	Zählerstand alt	ConsumptionValues	Nummer	12	Nein
- NewValue	Zählerstand neu	ConsumptionValues	Nummer	12	Nein
- Consumption	Verbrauch effektiv	ConsumptionValues	Nummer	12	Nein
- MeterReadingDate	Ablesedatum	ConsumptionValues	Datum	-	Nein
- CreationDate	Datensatz-Erstellungs-Datum	ConsumptionValues	Datum/Zeit	-	Nein
- CreationUserName	Datensatz-Erstellungs-Benutzer	ConsumptionValues	Text	50	Nein
- ModificationDate	Datensatz-Modifikations-Datum	ConsumptionValues	Datum/Zeit	-	Nein
- ModificationUserName	Datensatz-Modifikations-Benutzer	ConsumptionValues	Text	50	Nein
- AmountOld	Betrag alt	ConsumptionValues	Nummer	12	Nein
- AmountNew	Betrag neu	ConsumptionValues	Nummer	12	Nein
- CarriedForwardType	Vortragstyp	ConsumptionValues	Nummer	2	Nein

Detaillierte Feld-Informationen

Detaillierte Beschreibung der Schnittstellen-Felder.

Eindeutige Immobilien-Nr.

XML Element Name:	RealEstateNumber
Parent Element:	ConsumptionValues

Feld Typ:

Nummer

Action Typ:

Import und Export

Feld Länge: 12

Dezimal-Stellen: 0

Zwingendes Feld: Ja

Revision: 0

Ascii ID : -

Beschreibung:

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

Zähler-Nr.

XML Element Name:	MeterNumber
Parent Element:	ConsumptionValues

Feld Typ:

Nummer

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

Abrechnungsart

XML Element Name:	SettlementType
Parent Element:	ConsumptionValues

Feld Typ:

Nummer

Action Typ:

Import und Export

Feld Länge: 12

Dezimal-Stellen: 0

Zwingendes Feld: Ja

Revision: 0

Ascii ID : -

Beschreibung:

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

Periode von

XML Element Name:	PeriodFrom
Parent Element:	ConsumptionValues

Feld Typ:

Datum (2000-03-20)

Action Typ:

Import und Export

Feld Länge: -

Dezimal-Stellen: 0

Zwingendes Feld: Ja

Revision: 0

Ascii ID : -

Beschreibung:

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

Objekt-Nr.

XML Element Name:	ObjectNumber
Parent Element:	ConsumptionValues

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

Objektvertrag-Nr.

XML Element Name:	ObjectContractNumber
Parent Element:	ConsumptionValues

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

Zählerstand alt

XML Element Name:	OldValue
Parent Element:	ConsumptionValues

Feld Typ:

Nummer

Action Typ:

Import und Export

Feld Länge: 12

Dezimal-Stellen: 2

Zwingendes Feld: Nein

Revision: 0

Ascii ID : -

Beschreibung:

(Den internen Feld ID für dieses Element ist "WertAlt")
Als Dezimaltrenner muss ein Punkt verwendet werden. Dies gemäss dem XML Standard von W3C.

Zählerstand neu

XML Element Name:	NewValue
Parent Element:	ConsumptionValues

Feld Typ:

Nummer

Action Typ:

Import und Export

Feld Länge: 12

Dezimal-Stellen: 2

Zwingendes Feld: Nein

Revision: 0

Ascii ID : -

Beschreibung:

(Den internen Feld ID für dieses Element ist "WertNeu")
Als Dezimaltrenner muss ein Punkt verwendet werden. Dies gemäss dem XML Standard von W3C.

Verbrauch effektiv

XML Element Name:	Consumption
Parent Element:	ConsumptionValues

Feld Typ:

Nummer

Action Typ:

Import und Export

Feld Länge: 12

Dezimal-Stellen: 2

Zwingendes Feld: Nein

Revision: 0

Ascii ID : -

Beschreibung:

(Den internen Feld ID für dieses Element ist "Verbrauch")
Als Dezimaltrenner muss ein Punkt verwendet werden. Dies gemäss dem XML Standard von W3C.

Ablesedatum

XML Element Name:	MeterReadingDate
Parent Element:	ConsumptionValues

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

Datensatz-Erstellungs-Datum

XML Element Name:	CreationDate
Parent Element:	ConsumptionValues

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

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

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

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

Betrag alt

XML Element Name:	AmountOld
Parent Element:	ConsumptionValues

Feld Typ:

Nummer

Action Typ:

Import und Export

Feld Länge: 12

Dezimal-Stellen: 2

Zwingendes Feld: Nein

Revision: 0

Ascii ID : -

Beschreibung:

(Den internen Feld ID für dieses Element ist "WertAltBetrag")
Als Dezimaltrenner muss ein Punkt verwendet werden. Dies gemäss dem XML Standard von W3C.

Betrag neu

XML Element Name:	AmountNew
Parent Element:	ConsumptionValues

Feld Typ:

Nummer

Action Typ:

Import und Export

Feld Länge: 12

Dezimal-Stellen: 2

Zwingendes Feld: Nein

Revision: 0

Ascii ID : -

Beschreibung:

(Den internen Feld ID für dieses Element ist "WertNeuBetrag")
Als Dezimaltrenner muss ein Punkt verwendet werden. Dies gemäss dem XML Standard von W3C.

Vortragstyp

XML Element Name:	CarriedForwardType
Parent Element:	ConsumptionValues

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