Schnittstelle: IMMO - TechnicalEquipment Version 2010.00

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


Allgemeine Informationen

Allgemeine Informationen zur Schnittstelle.

AbaConnect Schnittstellen Information
Applikation:IMMO
Schnittstellen-Name:Geräte
ID:TechnicalEquipment ( TechnicalEquipment )
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 : 1



Mapping Informationen

Im Folgenden werden die Informationen über das Mapping angezeigt.

Mapping Informationen
Mapping ID:AbaDefault
Mapping Name:Geräte
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>TechnicalEquipment</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>
      <Equipment mode='SAVE'>
          <!-- Hier können spezifische Datenfelder für die AbaConnect Schnittstelle definiert werden. -->
      </Equipment>
    </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"  "-acidTechnicalEquipment"  "-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
EquipmentGeräte---Ja
    - UniqueRealEstateNumberEindeutige Immobilien-Nr.EquipmentNummer12Ja
    - LinkToRecordTypeVerbindung zu Datensatz-TypEquipmentNummer6Ja
    - AdditionalReferenceNumberZusätzliche Referenz-NummerEquipmentNummer12Ja
    - UniqueEquipmentNumberEindeutige Geräte-Nr.EquipmentNummer12Ja
    - ShortDesignationKurzbezeichnungEquipmentText100Ja
    - EquipmentTypeGeräte-ArtEquipmentNummer12Ja
    - EquipmentCategoryGeräte-KategorieEquipmentNummer12Nein
    - DateOfPurchaseDatum AnschaffungEquipmentDatum-Nein
    - WarrantyUntilGarantie bisEquipmentDatum-Nein
    - DurationOfUseNutzungsdauer in JahrenEquipmentNummer4Nein
    - SerialNumberSerien-Nr.EquipmentText100Nein
    - SizeGrössenangabenEquipmentText100Nein
    - CurrencyWährungEquipmentText3Nein
    - AmountBetragEquipmentNummer14Nein
    - SupplierNumberLieferanten-Nr.EquipmentNummer12Nein
    - AddressNumberManufacturerAdress-Nr. HerstellerEquipmentNummer10Nein
    - LinkToAssetsLedgerMit Anlagenbuchhaltung verbindenEquipmentBoolean-Nein
    - AssetNumberAnlage-Nr.EquipmentNummer10Nein
    - InactiveInaktiv J/NEquipmentBoolean-Nein
    - InactiveDateInaktiv perEquipmentDatum-Nein
    - CreationDateDatensatz-Erstellungs-DatumEquipmentDatum/Zeit-Nein
    - CreationUserNameDatensatz-Erstellungs-BenutzerEquipmentText50Nein
    - ModificationDateDatensatz-Modifikations-DatumEquipmentDatum/Zeit-Nein
    - ModificationUserNameDatensatz-Modifikations-BenutzerEquipmentText50Nein
    StateEvaluationOfDeviceZustandbewertung des GerätsEquipment--Nein
        - ValidFromGültig abStateEvaluationOfDeviceDatum-Nein
        - StateNumberZustands-Nr.StateEvaluationOfDeviceNummer12Nein
        - DesignationBemerkungStateEvaluationOfDeviceText4096Nein



Detaillierte Feld-Informationen

Detaillierte Beschreibung der Schnittstellen-Felder.

Eindeutige Immobilien-Nr.
XML Element Name:UniqueRealEstateNumber
Parent Element:Equipment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   12Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   -
Beschreibung:

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

Verbindung zu Datensatz-Typ
XML Element Name:LinkToRecordType
Parent Element:Equipment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   6Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   -
Beschreibung:
Beispiel:
- Immobilie
- Gebäude
- Haus
- Etage
- Objekt
(Den internen Feld ID für dieses Element ist "VerbindungRecTyp")

Zusätzliche Referenz-Nummer
XML Element Name:AdditionalReferenceNumber
Parent Element:Equipment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   12Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   -
Beschreibung:
Diese Nummer ist die Verknüpfung zum VerbindungsRecTyp
(Den internen Feld ID für dieses Element ist "RefNum1")

Eindeutige Geräte-Nr.
XML Element Name:UniqueEquipmentNumber
Parent Element:Equipment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   12Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   -
Beschreibung:

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

Kurzbezeichnung
XML Element Name:ShortDesignation
Parent Element:Equipment
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   100Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   -
Beschreibung:

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

Geräte-Art
XML Element Name:EquipmentType
Parent Element:Equipment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   12Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   -
Beschreibung:
Verbindung zur Tabelle YCS, Geräte-Arten
(Den internen Feld ID für dieses Element ist "Art")

Geräte-Kategorie
XML Element Name:EquipmentCategory
Parent Element:Equipment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   12Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Verbindung zur Tabelle YCS, Geräte-Kategorien
(Den internen Feld ID für dieses Element ist "Kategorie")

Datum Anschaffung
XML Element Name:DateOfPurchase
Parent Element:Equipment
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 "AnschDatum")

Garantie bis
XML Element Name:WarrantyUntil
Parent Element:Equipment
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 "GarantieBis")

Nutzungsdauer in Jahren
XML Element Name:DurationOfUse
Parent Element:Equipment
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 "NutzDauer")

Serien-Nr.
XML Element Name:SerialNumber
Parent Element:Equipment
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   100Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Grössenangaben
XML Element Name:Size
Parent Element:Equipment
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   100Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Währung
XML Element Name:Currency
Parent Element:Equipment
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   3Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Betrag
XML Element Name:Amount
Parent Element:Equipment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   14Dezimal-Stellen:   2Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Lieferanten-Nr.
XML Element Name:SupplierNumber
Parent Element:Equipment
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 "LieferantenNr")

Adress-Nr. Hersteller
XML Element Name:AddressNumberManufacturer
Parent Element:Equipment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   10Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Mit Anlagenbuchhaltung verbinden
XML Element Name:LinkToAssetsLedger
Parent Element:Equipment
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 "MitAnlVerbJN")

Anlage-Nr.
XML Element Name:AssetNumber
Parent Element:Equipment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   10Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:

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

Inaktiv J/N
XML Element Name:Inactive
Parent Element:Equipment
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:InactiveDate
Parent Element:Equipment
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")

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

Zustandbewertung des Geräts
XML Element Name:StateEvaluationOfDevice
Parent Element:Equipment
Feld Typ:Linked List
Action Typ:Import und Export
Feld Länge:   -Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   1Ascii ID :   -
Beschreibung:

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

Gültig ab
XML Element Name:ValidFrom
Parent Element:StateEvaluationOfDevice
Feld Typ:Datum (2000-03-20)
Action Typ:Import und Export
Feld Länge:   -Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   1Ascii ID :   -
Beschreibung:

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

Zustands-Nr.
XML Element Name:StateNumber
Parent Element:StateEvaluationOfDevice
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   12Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   1Ascii ID :   -
Beschreibung:

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

Bemerkung
XML Element Name:Designation
Parent Element:StateEvaluationOfDevice
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   4096Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   1Ascii ID :   -
Beschreibung:

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