Schnittstelle: IMMO - TechnicalService Version 2018.00

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


Allgemeine Informationen

Allgemeine Informationen zur Schnittstelle.

AbaConnect Schnittstellen Information
Applikation:IMMO
Schnittstellen-Name:Service-Verträge
ID:TechnicalService ( TechnicalService )
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:Service-Verträge
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>TechnicalService</Id>
      <MapId>AbaDefault</MapId>
      <Version>2018.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>
      <ServiceContracts mode='SAVE'>
          <!-- Hier können spezifische Datenfelder für die AbaConnect Schnittstelle definiert werden. -->
      </ServiceContracts>
    </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"  "-acidTechnicalService"  "-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
ServiceContractsService-Verträge---Ja
    - UniqueRealEstateNumberEindeutige Immobilien-Nr.ServiceContractsNummer12Ja
    - LinkToRecordTypeVerbindung zu Datensatz-TypServiceContractsNummer6Ja
    - AdditionalReferenceNumberZusätzliche Referenz-NummerServiceContractsNummer12Nein
    - ServiceSubscriptionNumberService-Abo-Nr.ServiceContractsNummer12Ja
    - ExternalServiceContractNumberExterne ServiceAbo-Vertrags-Nr.ServiceContractsText50Nein
    - ShortDesignationKurzbezeichnungServiceContractsText100Ja
    - StartDateDatum BeginnServiceContractsDatum-Nein
    - EndDateDatum EndeServiceContractsDatum-Nein
    - DateOfLastExecutionDatum letzte AusführungServiceContractsDatum-Nein
    - DateOfNextExecutionDatum nächste AusführungServiceContractsDatum-Nein
    - FrequencyPeriodizitätServiceContractsNummer2Ja
    - CurrencyWährungServiceContractsText3Nein
    - AmountBetragServiceContractsNummer14Nein
    - SupplierNumberLieferanten-Nr.ServiceContractsNummer12Nein
    - AddressNumberContactAdress-Nr.ServiceContractsNummer10Nein
    - CreateOpenItemSwitchPendenz anlegen J/NServiceContractsBoolean-Nein
    - FunctionInChargeZuständige Funktion/AufgabenbereichServiceContractsNummer12Nein
    - OpenItemCreationDatePendenz erstellen per X Tage vor nächste AusführungServiceContractsNummer4Nein
    - CreationDateDate création enregistrementServiceContractsDatum/Zeit-Nein
    - CreationUserNameDatensatz-Erstellungs-BenutzerServiceContractsText50Nein
    - ModificationDateDatensatz-Modifikations-DatumServiceContractsDatum/Zeit-Nein
    - ModificationUserNameDatensatz-Modifikations-BenutzerServiceContractsText50Nein
    - DesignationBemerkungServiceContractsText4096Nein
    - ContractDurationVertragsdauerServiceContractsNummer4Nein
    - TacitContractRenewalStillschweigende Vertragserneuerung Ja / NeinServiceContractsBoolean-Nein
    - DurationAutoContractRenewalLänge automatische VertragserneuerungServiceContractsNummer4Nein
    - FrequencyMonthsPeriodizität in MonatenServiceContractsNummer4Nein
    - CategoryNumberKategorie-Nr.ServiceContractsNummer4Nein
    - TypeNumberArt-Nr.ServiceContractsNummer4Nein



Detaillierte Feld-Informationen

Detaillierte Beschreibung der Schnittstellen-Felder.

Eindeutige Immobilien-Nr.
XML Element Name:UniqueRealEstateNumber
Parent Element:ServiceContracts
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:ServiceContracts
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:ServiceContracts
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   12Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Diese Nummer ist die Verknüpfung zum VerbindungsRecTyp
(Den internen Feld ID für dieses Element ist "RefNum1")

Service-Abo-Nr.
XML Element Name:ServiceSubscriptionNumber
Parent Element:ServiceContracts
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 "ServiceAboNr")
                    

Externe ServiceAbo-Vertrags-Nr.
XML Element Name:ExternalServiceContractNumber
Parent Element:ServiceContracts
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 "ExtServiceAboNr")
                    

Kurzbezeichnung
XML Element Name:ShortDesignation
Parent Element:ServiceContracts
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")
                    

Datum Beginn
XML Element Name:StartDate
Parent Element:ServiceContracts
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 "BeginnDat")
                    

Datum Ende
XML Element Name:EndDate
Parent Element:ServiceContracts
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 "EndeDat")
                    

Datum letzte Ausführung
XML Element Name:DateOfLastExecution
Parent Element:ServiceContracts
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 "LetzteAusf")
                    

Datum nächste Ausführung
XML Element Name:DateOfNextExecution
Parent Element:ServiceContracts
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 "NaechstAusf")
                    

Periodizität
XML Element Name:Frequency
Parent Element:ServiceContracts
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   2Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   -
Beschreibung:

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

Währung
XML Element Name:Currency
Parent Element:ServiceContracts
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:ServiceContracts
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:ServiceContracts
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.
XML Element Name:AddressNumberContact
Parent Element:ServiceContracts
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 "AdrNrKontPers")
                    

Pendenz anlegen J/N
XML Element Name:CreateOpenItemSwitch
Parent Element:ServiceContracts
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 "PendenzAnlegenJN")
                    

Zuständige Funktion/Aufgabenbereich
XML Element Name:FunctionInCharge
Parent Element:ServiceContracts
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 "ZustaendigeFkt")
                    

Pendenz erstellen per X Tage vor nächste Ausführung
XML Element Name:OpenItemCreationDate
Parent Element:ServiceContracts
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 "PendenzPer")
                    

Date création enregistrement
XML Element Name:CreationDate
Parent Element:ServiceContracts
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:ServiceContracts
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:ServiceContracts
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:ServiceContracts
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")
                    

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

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

Vertragsdauer
XML Element Name:ContractDuration
Parent Element:ServiceContracts
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 "Vertragsdauer")
                    

Stillschweigende Vertragserneuerung Ja / Nein
XML Element Name:TacitContractRenewal
Parent Element:ServiceContracts
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 "StillschVertragsErn")
                    

Länge automatische Vertragserneuerung
XML Element Name:DurationAutoContractRenewal
Parent Element:ServiceContracts
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 "LaengeVertrErn")
                    

Periodizität in Monaten
XML Element Name:FrequencyMonths
Parent Element:ServiceContracts
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 "PeriodizitaetInMonat")
                    

Kategorie-Nr.
XML Element Name:CategoryNumber
Parent Element:ServiceContracts
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 "KategorieNr")
                    

Art-Nr.
XML Element Name:TypeNumber
Parent Element:ServiceContracts
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 "ArtNr")