AbaConnect Handbuch (PDF) - ABACUS Research AG

A B A C U S 

H A N D B U C H 

AbaConnect 

2010 

Diese Unterlagen sind urheberrechtlich geschützt. 

Insbesondere das Recht, die Unterlagen mittels irgendeines Mediums (grafisch, technisch, elektronisch und/oder digital, 

einschliesslich Fotokopie und downloading) ganz oder teilweise zu vervielfältigen, vorzutragen, zu verbreiten, zu bearbeiten, zu 

übersetzen, zu übertragen oder zu speichern, liegt ausschliesslich bei ABACUS Research AG. 

Jede Verwertung in den genannten oder in anderen als den gesetzlich zugelassenen Fällen, namentlich jede kommerzielle 

Nutzung, bedarf der vorherigen schriftlichen Einwilligung von ABACUS Research AG. 

Die gewerbsmässige Verletzung der Urheberrechte kann gemäss Art. 67 Abs. 2 URG bestraft werden. 

Copyright © 2009 by ABACUS Research AG, CH-9301 Wittenbach-St.Gallen


Inhaltsverzeichnis 

Inhaltsverzeichnis 

Einleitung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 

AbaConnect Architektur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 

Benutzeroberfläche . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 

Import . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 

Export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 

Konfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 

Fortschrittsdialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 

Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 

Parameteroptionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 

Zusätzliche Optionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 

Beispiel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 

AbaConnect Kopfinformationen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 

Seite2/31


Einleitung 

Einleitung 

AbaConnect ist die zentrale Komponente für den Datentransfer von und zu ABACUS-Applikationen. Applikationsdaten 

können aus verschiedenen ABACUS-Applikationen exportiert oder importiert werden. 

• AbaConnect unterstützt XML-Formate. XML ist ein zeitgemässes, breit akzeptiertes Format, das sich für die 

Übertragung verschiedener Datenstrukturen eignet (vom W3C definierte Standards). XML-Datenstrukturen 

können flach oder hierarchisch (Parent-/Child-Struktur) sein. 

• AbaConnect unterstützt auch ASCII-Formate, um die Rückwärtskompatibilität mit älteren Formaten zu gewährleisten. 

• AbaConnect kann via ABACUS Programm 625, via Command Line oder via WebService verwendet werden. 

• Die AbaConnect XML-Struktur ist für XML-Dateien und AbaConnect WebServices identisch. 

• AbaConnect verwendet für die Datenspeicherung grundsätzlich dieselben Savelets (Speicher-routinen) wie 

die ABACUS UI-Programme (gleiche Validierung). Dies gewährleistet, dass die Daten für im Export identisch 

zu den Arbeitsdaten des ABACUS sind. 

• Das AbaConnect Programm 625 mit Command Line Anwendung ist sowohl bei einer ABACUS Netzwerkinstallation 

als auch bei einer Einzelplatzinstallation verfügbar 

• AbaConnect WebServices sind bei einer ABACUS Netzwerkinstallation verfügbar. Dazu sind die Dienste 

AbaSioux und InterfaceServer erforderlich. In der Regel ist keine andere Konfiguration erforderlich, um Aba- 

Connect WebServices verwenden zu können. 

AbaConnect Importmodi (DB-Aktion) 

AbaConnect verfügt über verschiedene Datenbankmodi für den Datenimport. Beim Export einer XML-Datei aus 

der ABACUS Benutzeroberfläche können diese Modi definiert werden. Die Modi spielen nur beim Import der XML- 

Datei eine Rolle. Über WebService werden die Modi durch die entsprechenden Methoden bestimmt, die für die 

WebService-Schnittstelle definiert worden sind. 

AbaConnect XML und AbaConnect WebService 

Die AbaConnect-Schnittstellen können manuell via ABACUS Benutzeroberfläche (Prog. 625) oder via WebService 

verwendet werden. Ob eine Schnittstelle vie ABACUS Benutzeroberfläche oder via WebService verwendet werden 

kann, wird beim Erstellen der Schnittstelle definiert. Diese Eigenschaften werden von ABACUS definiert. Es ist 

möglich, dass eine Schnittsstelle in der ABACUS Benutzeroberfläche (Prog. 625) sichtbar ist, als WebService jedoch 

nicht verfügbar ist. Es ist auch möglich, dass eine Schnittsstelle als WebService verfügbar ist, in der ABACUS 

Benutzeroberfläche (Prog. 625) jedoch nicht sichtbar. Viele der Schnittstellen aus den Hauptapplikationen sind 

sowohl via ABACUS Benutzeroberfläche als auch als WebService verfügbar. 

AbaConnect-Schnittstellen, auf die via ABACUS Benutzeroberfläche (Prog. 625) zugegriffen werden kann, können 

immer auch via Command Line verwendet werden. 

Seite3/31


AbaConnect Architektur 


Übersicht über die AbaConnect Architektur 

Die AbaConnect Architektur basiert auf der ABACUS AbaViewlet und AbaSavelet Technologie, die in ABACUS zum 

Speichern und Abrufen von Daten verwendet wird. 

• AbaViewlet - Business Objects, die zum Abrufen von Daten aus der Datenbank verwendet werden (z.B. zur 

Anzeige in der ABACUS Benutzeroberfläche) 

• AbaSavelet - Business Objects, die zum Speichern von Daten in der Datenbank verwendet werden (z.B. Daten 

speichern via ABACUS Benutzeroberfläche). Die AbaSavelets enthalten in der Regel Validierungsroutinen 

für die Datenobjekte. 

AbaConnect kommuniziert mit den AbaViewlet und AbaSavelet Business Objects mittels eines Brokers, der Aba- 

ConnectBroker genannt wird. Der AbaConnectBroker behandelt die Requests und Responses, die via AbaConnect 

geschickt werden und hat die Funktion eines Übersetzers zwischen den AbaConnect-Applikationen und den AbaSavelets 

und AbaViewlets. 

Der Hauptvorteil für den AbaConnect-Benutzer liegt darin, dass die Daten bei AbaConnect ähnlich validiert werden 

wie bei der ABACUS Benutzeroberfläche. Zudem durchlaufen die via AbaConnect Benutzeroberfläche übermittelten 

Daten dieselbe Validierung wie die Daten, die mittels einer AbaConnect WebService Applikation und der Aba- 

Connect Command Line übermittelt werden. 

Seite4/31



AbaConnect Datenstrom 

Der Datenstrom via AbaConnect-Schnittstelle folgt einem ähnlichen Weg wie die Daten, die von den ABACUS-Programmen 

generiert werden. Die AbaConnect-Komponenten greifen auf das Transportobjekt via zusätzlichem Aba- 

ConnectBroker zu, der einige Übersetzungen von Datenfeldnamen verarbeitet. 

Seite5/31



Alle AbaConnect XML-Elemente sind auf Englisch definiert. Die XML-Elementnamen müssen vom AbaConnect- 

Broker übersetzt werden für das AbaViewlet. Der AbaConnectBroker ist für dieses Mapping sowie für die Konvertierung 

und Aufbereitung der XML-Daten für AbaConnect zuständig. 

Seite6/31


Benutzeroberfläche 


Die AbaConnect Benutzeroberfläche kann aus dem AbaMenu via Programm 625 gestartet werden. Es ist dabei 

unerheblich welche Applikation ausgewählt ist, denn AbaConnect ist ein zentrales Programm, wo Daten für alle 

installierten ABACUS-Installationen über eine gemeinsame Benutzeroberfläche exportiert und importiert werden 

können. Einige Applikationen haben jedoch separate Lizenzoptionen für die individuelle AbaConnect-Schnittstelle. 

In diesem Fall muss eine gültige Lizenz vorhanden sein, um die Schnittstelle verwenden zu können. 

Hinweis 

Die AbaConnect Benutzeroberfläche ist ein wichtiges Werkzeug für die Entwicklung von WebServices. Die 

Import- und Exportfunktion via AbaConnect Benutzeroberfläche mit XML-Dateien folgt derselben Code-Struktur 

wie der Import und Export via WebServices. Deshalb können die meisten Fehlermeldungen und Warnungen, 

die während der WebService-Entwicklung generiert werden, in der AbaConnect Benutzeroberfläche nachvollzogen 

werden, indem dieselben Datenstrukturen importiert werden. Es wird empfohlen, mit einer Schnittstelle 

zuerst in der AbaConnect Benutzeroberfläche zu experimentieren, bevor sie als WebService programmiert wird. 

Seite7/31



Es öffnet sich nach dem Programmstart diese Maske: 

Ihre Navigationsleiste enthält die folgenden Befehle: 

Befehl 

Starten 

Speichern 

Refresh 

Beschreibung 

Dieser Button ist nur in den Import- und Exportmasken aktiviert. Dazu müssen gültige 

Importdateien beziehungsweise eine korrekte Exportdatei und -selektion angegeben 

werden. Sobald diese Voraussetzungen erfüllt sind kann der Import- beziehungsweise 

Exportvorgang gemäss den getroffenen Einstellungen mit diesem Button gestartet 

werden. 

Dieser Button speichert die getätigten Änderungen. Er ist nur im Konfigurationsbereich 

aktiviert, wenn Änderungen vorliegen. 

Dieser Button lädt die angezeigten Daten neu und zeigt ihren aktualisierten Inhalt an. 

Er ist in den Konfigurations- und Exportmasken aktiv. 

Seite8/31



Import 

XML 

Import 

Die Seiten unter "Import" dienen dazu, eine Schnittstelle ins AbaConnect zu importieren. Standardmässig wird 

dazu eine XML-Datei verwendet. Aus Gründen der Rückwärtskompatibilität kann aber auch noch eine ASCII-Datei 

verwendet werden. 

XML 

Diese Seite besteht aus vier Bereichen: 

1. Der Katalogbereich. Unter "Import" werden die Importoptionen für AbaConnect angezeigt. 

2. Die Importdateiliste: Mit dem Button "Importdatei hinzufügen" können Importdateien der Liste hinzugefügt 

werden. Er öffnet dazu einen Dateiauswahldialog, in dem die gewünschten Dateien ausgewählt und mit "Öffnen" 

bestätigt werden können. 

3. Binäre Dateiliste: Bei Schnittstellen mit der Möglichkeit, binäre Daten (z.B. Kreditoren) zu importieren, können 

die binären Dateien (z.B. pdf) der binären Dateiliste hinzugefügt werden. Die Dateien müssen in der XML- 

Importdatei korrekt referenziert werden. Die Binärdateien werden dabei jeweils für jede XML-Datei separat 

hinzugefügt. Es muss deshalb in der Importdateiliste die XML-Importdatei ausgewählt sein, zu der die binären 

Dateien hinzugefügt werden sollen. 

4. Der Vorschaubereich. Hier kann über den Button "XML anzeigen" die Importdatei eingesehen werden. 

Seite9/31



Import 

ASCII 

Die Schnittstelleninformation befindet sich im Kopf der AbaConnect XML-Datei. Um eine AbaConnect XML-Datei 

zu importieren, muss die Importdatei zur Importdateiliste hinzugefügt werden. Drücken Sie den Button "Importdatei 

hinzufügen", um sie zur Liste hinzuzufügen. Alternativ kann das Kontextmenu der Importdateiliste verwendet werden 

um Importdateien hinzuzufügen oder zu entfernen. 

ASCII 

Diese Seite besteht aus vier Bereichen: 

1. Der Katalogbereich. Unter "Import" werden die Importoptionen für AbaConnect angezeigt. Es besteht auch 

die Möglichkeit, XML-Dateien via AbaConnect Benutzeroberfläche zu importieren, was die empfohlene Vorgehensweise 

beim Import ist. 

2. Die Importdateiliste: Mit dem Button "Importdatei hinzufügen" können Importdateien der Liste hinzugefügt 

werden. Er öffnet dazu einen Dateiauswahldialog, in dem die gewünschten Dateien ausgewählt und mit "Öffnen" 

bestätigt werden können. 

3. Binäre Dateiliste: Bei Schnittstellen mit der Möglichkeit, binäre Daten (z.B. Kreditoren) zu importieren, können 

die binären Dateien (z.B. pdf) der binären Dateiliste hinzugefügt werden. Die Binärdateien werden dabei jeweils 

für jede ASCII-Datei separat hinzugefügt. Es muss deshalb in der Importdateiliste die ASCII-Importdatei 

ausgewählt sein, zu der die binären Dateien hinzugefügt werden sollen. 

4. Der Definitionsbereich. Hier kann die Zuordnung der Schnittstelle definiert werden. 

Seite10/31



Import 

Einstellungen 

Der Definitionsbereich enthält die folgenden Bedienungselemente: 

Element 

Applikationsauswahl 

Expliziter Import 

ASCII-Schnittstellen 

Mapping-Zuordnung 

Definitionslisting 

Definition hinzufügen 

Definition entfernen 

und 

Beschreibung 

In diesem Auswahlfeld kann ausgewählt werden, zu welcher Applikation die Importdateien 

gehören. 

Je nach ausgewählter Applikation erscheint dieses Feld, bei dem explizit eine Schnittstelle 

für den Import angegeben werden kann. 

Wenn diese Checkbox aktiviert wird, können Zuordnungsdefinitionen zu den Importdateien 

hinzugefügt werden. 

Diese Tabelle listet alle bereits eingefügten Mapping-Definitionen auf. 

Dieser Button öffnet eine Liste, in der alle verfügbaren Schnittstellen aufgelistet werden. 

Diese Schaltfläche entfernt die im Definitionslisting ausgewählte Definition. 

Alle Definitionen entfernen 

Zusätzliche Parameter 

Dieser Button entfernt alle eingefügten Definitionen. 

Je nach ausgewählter Applikation erscheinen unter diesen Buttons zusätzliche applikationsspezifische 

Optionen, die für den Import bestimmt werden können. 

Einstellungen 

Auf dieser Seite kann bestimmt werden, was mit den Importdateien nach dem Import geschehen soll: 

Seite11/31



Import 

Einstellungen 

Es können die folgenden Optionen definiert werden: 

Option 

Importdatei nach Verarbeitung 

stehen lassen 

Importdatei nach Verarbeitung 

löschen 

Importdatei in Backup-Verzeichnis 

bewegen 

Verzeichnis 

Wirkung 

Wenn diese Option aktiviert wird, wird die Importdatei durch den Importvorgang nicht 

berührt. 

Ist diese Option aktiviert, so wird die Importdatei gelöscht, sobald der Import abgeschlossen 

ist. Dabei wird sie tatsächlich gelöscht und nicht nur in den Papierkorb 

verschoben. 

Diese Option bestimmt, dass die Importdatei ins angegebene Verzeichnis verschoben 

werden soll, sobald der Import abgeschlossen ist. 

Dieses Feld nimmt einen Verzeichnispfad auf, an den die Importdatei verschoben 

werden soll. Um den Auswahldialog erneut aufzurufen kann der Auswahlbutton [...] 

am Ende des Feldes benutzt werden. 

Seite12/31



Export 

Export 

Export 

Eine AbaConnect-Schnittstelle kann durch Auswahl der "Export"-Funktion im Katalogbereich exportiert werden. 

Export 

Diese Seite dient dem Export von Schnittstellen. Sie umfasst sechs Bereiche: 

Es bestehen die folgenden Bereiche: 

1. Der Katalogbereich. Unter "Export" werden die Exportoptionen für AbaConnect angezeigt. 

2. Die Applikationsliste zeigt alle verfügbaren AbaConnect-Schnittstellen pro Applikation an. Die Baumstruktur 

kann aufgeklappt werden, um eine spezifische AbaConnect-Schnittstelle auszuwählen. 

3. Button-Bereich. Die ausgewählten Schnittstellen können mit diesen Buttons der Export-Selektionsliste (4) 

hinzugefügt oder daraus entfernt werden. 

4. Export-Selektionsliste - Zeigt eine Liste der gegenwärtig für den Export ausgewählten Schnittstellen. 

5. Auswahlbereich - Dieser Bereich ändert je nach ausgewählter Schnittstelle. Hat eine Schnittstelle keine Selektions-Parameter, 

ist dieser Bereich leer. Ansonsten können hier die entsprechenden Einstellungen getroffen 

werden. Diese gelten natürlich nur für die jeweils ausgewählte Selektion. 

6. Exportdateiname: Der Exportdateiname für den Dateiexport. Der Pfad und Name der Exportdatei können 

mittels Dateiauswahl-Dialog bestimmt werden. 

Seite13/31



Export 

Einstellungen 

Das Kontextmenu der eines Schnittstellen- oder Gruppenelements in der Applikationsliste enthält die folgenden 

Einträge: 

Element 

Alles aufklappen 

Alles schliessen 

Selektion aufklappen 

Selektion schliessen 

Daten neu laden 

Schnittstellenbeschreibungen 

updaten 

Hinzufügen 

Alle Standardschnittstellen 

der Gruppe hinzufügen 

Beschreibung 

Dies klappt alle in der Applikationsliste enthaltenen Gruppen auf. 

Dies klappt alle in der Applikationsliste enthaltenen Gruppen zu. 

Dies klappt das angeklickte Gruppenelement auf. 

Dies klappt das angeklickte Gruppenelement zu. 

Dies lädt die Applikationsliste neu; der gleiche Effekt kann auch über den entsprechenden 

Button in der Navigationsleiste erreicht werden. 

Dies lädt die Beschreibungen der Schnittstellen neu. 

Dies fügt die angeklickte Schnittstelle in die Export-Selektionsliste ein. 

Dies fügt alle in der angeklickten Gruppe enthaltenen Selektionselemente in die Export-Selektionsliste 

ein. 

Wenn die Checkbox "Zusatz-Optionen" aktiviert ist, stehen zwei weitere Optionen zur Auswahl bereit: 

Option 

Dateiformat 

Felder 

Beschreibung 

In diesem Feld kann ausgewählt werden, in welchem Dateiformat die hinzugefügten 

Selektionen exportiert werden sollen. Standardmässig wird der Export zu XML durchgeführt, 

ausser wenn dies nicht möglich sein sollte. Diesfalls werden die Schnittstellen 

als ASCII exportiert. Diese Einstellung wird empfohlen. Es kann aber hier auch 

ausgewählt werden dass die Schnittstellen nur entweder als ASCII (nicht empfohlen) 

oder XML exportiert werden sollen. 

In diesem Auswahlfeld kann bestimmt werden, ob die erweiterten Felder der ausgewählten 

Schnittstellen ebenfalls exportiert werden sollen oder ob nur die Standardfelder 

exportiert werden sollen. 

Einstellungen 

Auf dieser Seite können Einstellungen für den Export der Schnittstellen getroffen werden. 

Seite14/31



Export 

Einstellungen 

Dabei stehen die folgenden Einstellungen zur Verfügung: 

Einstellung 

Export-Daten-Modus 

Beschreibung 

Hier stehen drei Modi zur Auswahl. Sie bestimmen, in welchem Dateiformat die 

Schnittstellen exportiert werden sollen: 

• Default: Dies bedeutet, dass versucht wird, die Schnittstellen als XML zu exportieren, 

und falls dies fehlschlägt als ASCII. 

• XML: Dies bedeutet, dass die Schnittstellen immer nur als XML exportiert werden, 

und niemals als ASCII. 

• ASCII: Dies bedeutet, dass die Schnittstelle immer nur als ASCII exportiert werden, 

und niemals als XML. Diese Funktion steht nur aus Gründen der Rückwärtskompatibilität 

zur Verfügung und wird ansonsten nicht empfohlen. 

Hier wird lediglich die standardmässige Einstellung für die Exportseite festgelegt; natürlich 

kann diese Standardeinstellung dort wieder abgeändert werden. 

Standard DB-Aktion 

Hiermit kann die Standardaktion ausgewählt werden, die den exportierten Schnittstellen 

hinterlegt werden soll. Die Modi spielen nur beim Import der XML-Datei eine Rolle. 

Über WebService werden die Modi durch die entsprechenden Methoden bestimmt, 

die für die WebService-Schnittstelle definiert worden sind. 

• SAVE - (Standard) 

Seite15/31



Export 

Einstellungen 

Speichert einen Datensatz. Dies ist eine Kombination von UPDATE und IN- 

SERT. Wenn ein Datensatz bereits existiert, wird er überschrieben (UPDATE), 

sonst wird ein neuer Datensatz gespeichert (INSERT). 

• INSERT 

Fügt einen neuen Datensatz ein. Falls ein Datensatz bereits existiert, wird eine 

Fehlermeldung zurückgegeben. 

• UPDATE 

Aktualisiert einen bestehenden Datensatz. Der Datensatz muss existieren, 

sonst wird eine Fehlermeldung zurückgegeben, dass der Datensatz nicht gefunden 

werden konnte. 

• READ 

Wird zum Exportieren von Datensätzen verwendet, die nicht wieder importiert 

werden müssen (z.B. Reports). Datensätze mit Modus READ können nicht 

importiert werden. 

• DELETE 

Löscht den bestehenden Datensatz. Beachten Sie, dass dieser Modus mit 

grosser Vorsicht verwendet werden sollte! 

Transaktions-Modus 

Dies erlaubt die Auswahl zwischen zwei Modi der Datenübertragung für die exportierten 

Schnittstellen: 

• Transaktion pro Datensatz (Single) - (Standard) 

Dieser Modus bestimmt, dass die Datensätze jeweils in einer einzelnen Transaktion 

gespeichert werden. 

• Transaktion für alle Datensätze (ALL) 

Dieser Modus gibt vor, dass jeweils alle Datensätze gesamthaft verarbeitet werden 

sollen. Tritt beim Speichern ein Fehler auf, werden keine Daten gespeichert. 

Mandantennummer exportieren 

Wenn diese Checkbox gesetzt ist, wird beim Export jeweils die Mandantennummer 

mitgegeben, so dass nur auf einem Mandanten mit gleicher Nummer wieder importiert 

werden kann, ansonsten wird der Export mandantenunabhängig durchgeführt. 

Standard 

(XML) 

Exportdatei 

Hier kann ein Standardpfad eingegeben werden für den Export nach XML auf der 

Exportseite. Er wird automatisch ins entsprechende Feld eingefügt wenn der Export 

nach XML stattfindet. 

Standard Exportdatei (AS- 

CII) 

Hier kann ein Standardpfad eingegeben werden für den Export nach ASCII auf der 

Exportseite. Er wird automatisch ins entsprechende Feld eingefügt wenn der Export 

nach ASCII stattfindet. 

Seite16/31



Konfiguration 

Definitionen 

Konfiguration 

Die Seiten unter "Konfiguration" im Katalogbereich erlauben die individuelle Anpassung aller AbaConnect-Schnittstellen. 

Auch detailliertere Informationen über die AbaConnect-Schnittstellen sind via Konfigurations-Ansicht verfügbar. 

Definitionen 

Das Definitionsfenster der Konfigurationen besteht aus drei Bereichen: 

1. Der Katalogbereich für die Wahl des Import-, Export- oder Konfigurationsbereiches. 

2. Die Applikationsliste zeigt alle verfügbaren AbaConnect-Schnittstellen pro Applikation an. Die Baumstruktur 

kann aufgeklappt werden, um eine spezifische AbaConnect-Schnittstelle auszuwählen. 

3. AbaConnect Schnittstellenbereich. Dieser Bereich ändert je nach ausgewählter Schnittstelle. 

Im "Mapping Kopf" wird die ID jedes Mappings sowie den Mandantenbereich, für den es gültig ist, zusammen 

mit einer Beschreibung des Mappings aufgeführt. Das Standard-Mapping trägt normalerweise die Bezeichnung 

(ID) AbaDefault. Die AbaConnect WebServices verwenden immer das Standard-Mapping der Schnittstelle (z.B. 

AbaDefault). 

In der Tabellenansicht unter "Mapping Felder" werden ausführliche Angaben zu einem bestimmten Schnittstellenfeld 

gemacht. Dabei wird die Tabelle je nach Mapping entweder nach der Bezeichnung des XML-Elements oder der 

Seite17/31



Konfiguration 

Definitionen 

ASCII-Position sortiert. Sie kann mit dem Suchfeld unten nach einem beliebigen Begriff in einer beliebigen Spalte 

durchsucht werden. 

Die Schnittstellen- oder Ordnerelemente in der Applikationsliste haben die folgenden Einträge im Kontextmenu: 

Eintrag 





Daten neu laden 

Schnittstellenbeschreibungen 

updaten 

Beschreibung 

Dies klappt alle in der Applikationsliste enthaltenen Gruppen auf. 

Dies klappt alle in der Applikationsliste enthaltenen Gruppen zu. 

Dies klappt das angeklickte Gruppenelement auf. 

Dies klappt das angeklickte Gruppenelement zu. 

Dies lädt die Applikationsliste neu; der gleiche Effekt kann auch über den entsprechenden 

Button in der Navigationsleiste erreicht werden. 

Dies lädt die Beschreibungen der Schnittstellen neu. 

Erweiterte Felder des Mappings 

aktualisieren 

Dies lädt die erweiterten Felder des angeklickten Mappings neu. Dieser Eintrag ist 

nur aktiviert wenn tatsächlich erweiterte Felder bestehen. 

Mapping kopieren 

Mapping löschen 

Definition exportieren 

Definition importieren 

Dies kopiert das ausgewählte Mapping. Dabei muss ein neuer Name (ID) für das 

Mapping eingegeben werden, und ob es mandantenübergreifend oder nur für den 

aktuellen Mandant sein soll. 

Alle nicht-standard Mappings können mit diesem Befehl gelöscht werden. 

Dies exportiert eine Mapping-Definition als XML-Datei. Dabei ist der Vorgang derselbe 

wie wenn auf der Seite "Export" exportiert würde. Dies kann beispielsweise verwendet 

werden, um das Mapping auszutauschen oder um ein Backup zu erstellen. 

Dies importiert eine mit dem obigen Befehl exportierte Mapping-Definition wieder ins 

AbaConnect. Dabei ist der Vorgang derselbe wie wenn die entsprechende Definition 

zu dieser Schnittstelle über die Seite "Import" importiert würde. 

Dokumentation exportieren Dies exportiert die HTML-Dokumentation für die ausgewählte Schnittstelle. Diese Dokumentation 

ist auch auf der ABACUS-Homepage unter folgendem Link verfügbar: 

http://www.abacus.ch/downloads-page/dokumentationen/abaconnect 

Das Kontextmenu der einzelnen Mapping-Felder in der Tabellenansicht enthält die folgenden Befehle: 

Befehl 

Sortierreihenfolge XML 

Beschreibung 

Wählt den Wert der Spalte "XML" als Sortierkriterium. Dies hat den gleichen Effekt 

und die gleichen Voraussetzungen wie die Auswahl über die Optionsfelder über der 

Tabellenansicht. 

Seite18/31



Konfiguration 

Definitionen 

Sortierreihenfolge ASCII 





Alle nicht zwingenden Felder 

aktivieren /inaktivieren 

Wählt den Wert der Spalte "ASCII" als Sortierkriterium. Dies hat den gleichen Effekt 

und die gleichen Voraussetzungen wie die Auswahl über die Optionsfelder über der 

Tabellenansicht. 

Dies klappt alle in der Tabellenansicht enthaltenen Gruppen auf. 

Dies klappt alle in der Tabellenansicht enthaltenen Gruppen zu. 

Dies klappt die angeklickte Gruppe auf. 

Dies klappt die angeklickte Gruppe zu. 

Dies aktiviert beziehungsweise deaktiviert abwechslungsweise alle Checkboxen in 

der Tabellenansicht des aktuell angezeigten Feldes (Elements), die nicht zwingend 

sind. 

Alle nicht zwingenden Felder 

des Elements aktivieren 

/ inaktivieren 

Dies aktiviert beziehungsweise deaktiviert abwechslungsweise alle Checkboxen der 

angeklickten Gruppe in der Tabellenansicht welche nicht zwingend sind. 

Eigenschaften 

Zeigt die Feldeigenschaften des angeklickten Feldes an. Mehr dazu sogleich 

Eigenschaften 

Das Eigenschaftenfenster, das aus dem Kontextmenu eines Feldes in der Tabellenansicht aufgerufen werden kann, 

gibt detailliert Auskunft über die verschiedenen Eigenschaften des Feldes: 

Seite19/31



Konfiguration 

Definitionen 

Die Eigenschaften haben dabei folgende Bedeutung: 

Property 

XML Parent-Element 

XML-Elementname 

XML Element Order ID 

ASCII Feld-Position 

Interface Feldname 

Feldtyp 

Feldlänge 

Dez. S. 

Action Type 

Bedeutung 

Bezeichnet das in der XML-Hierarchie übergeordnete Element. 

Der Name des Elements in der XML-Hierarchie. 

Die Position des Elements innerhalb der XML-Hierarchiestufe. 

Die Position des Elements innerhalb der ASCII-Struktur. 

Der Name des Elements für die Schnittstelle 

Der Datentyp der im Feld enthaltenen Daten 

Die Anzahl Zeichen beziehungsweise Stellen, die das Feld enthalten kann. 

Das Vorzeichen des Feldes. Nur bei Zahlen relevant. 

Gibt die auszuführende Aktion des Feldes an. 

Seite20/31



Konfiguration 

Einstellungen 

Zwingendes Feld 

Feld-Operation 

Revision 

Extendet Field 

Deutsch 

Französisch 

Englisch 

Bezeichnet das Feld als zwingen. Wenn dies gesetzt ist, kann das Feld im Mapping 

nicht inaktiv gesetzt werden. 

Zeigt die erlaubten Operationen an, die auf dieses Feld durchgeführt werden können. 

Dies gibt die Revisionsnummer des Feldes an, die bei Änderungen erhöht wird. 

Wenn diese Checkbox gesetzt wird, ist das Feld als erweitertes Feld markiert. Erweiterte 

Felder werden je nach definition nicht importiert oder exportiert. Standardmässig 

sind alle Felder Standardfelder. 

Dies bezeichnet den Anzeigenamen des Feldes auf Deutsch. 

Dies bezeichnet den Anzeigenamen des Feldes auf Französisch. 

Dies bezeichnet den Anzeigenamen des Feldes auf Französisch. 

Diese Felder dienen jedoch nur zu Informationszwecken. Sie können nicht editiert werden. 

Einstellungen 

Die Seite "Einstellungen" der Konfigurationen ermöglicht es, verschiedene Import- / Exportoptionen zu definieren. 

Seite21/31



Konfiguration 

Einstellungen 

Antwort-Daten 

In diesem Bereich in der Lasche "Antwort-Optionen" kann angegeben werden, bis zu welchem Wichtigkeitsgrad 

Informationen im Log ausgegeben werden sollen. "Informationen" gibt dabei die höchste Anzahl an Meldungen aus. 

"Warnungen" blendet die Informationen (Meldungen über Erfolge) aus. "Fehler" blendet auch Warnungen (Meldungen 

über mögliche Probleme) aus und zeigt nur Meldungen über schwerwiegende Probleme an. 

Seite22/31



Konfiguration 

Einstellungen 

Kontrollzeichen 

Dieser Bereich im Tab "ASCII-Definitionen" dient der Definition der Trennzeichen für den ASCII Export und Import. 

Zeichensatz-Selektion 

Diese Felder legen die Zeichencodierung fest, die für den Export und Import der ASCII-Daten verwendet werden soll. 

Seite23/31



Fortschrittsdialog 


Nachdem ein Export oder Import via ABACUS Benutzeroberfläche (Prog. 625) ausgeführt worden ist, wird der Status 

der Ausführung in einem Fortschritts-Dialog angezeigt. Dieser wird während des Exports oder Imports laufend 

aktualisiert und zeigt den aktuellen Status an. Ist die Aktion fertig ausgeführt, zeigt der Fortschritts-Dialog den 

Status des Imports oder Exports an. Ein detaillierter Bericht kann direkt aus dem Forschritts-Dialog heraus gestartet 

und angezeigt werden. 

Der Status der erfolgreich beendeten Aufgabe wird mit einem grünen Häkchen-Symbol 

angezeigt. Fehler werden 

in der Regel mit einem Ausrufezeichen auf rotem Hintergrund 

angezeigt. Es werden auch andere Symbole 

verwendet, um den Ausführungsstatus, Warnungen oder aktuell ungelöste Ereignisse anzuzeigen (z.B. , , 

). 

Seite24/31




Der Fortschritts-Dialog zeigt nur grüne Häkchen-Symbole, wenn der Vorgang fehlerfrei durchgeführt worden ist. 

Eine nicht erfolgreiche Ausführung wird mit einem Kreuzsymbol auf rotem Hintergrund und/oder einem Warnsymbol 

angezeigt. In beiden Fällen kann ein Statusbericht aufgerufen werden mit einem Klick auf den Link "Anzeigen" auf 

der rechten Seite des Fortschritts-Dialoges. 

Der Statusbericht wird auf der Festplatte in demselben Ordner wie die Import- und Exportdatei gespeichert. Heisst 

die Importdatei zum Beispiel: 

x:\temp\abaconnect_import.xml 

trägt die Statusberichtsdatei für den Import folgenden Namen: 

x:\temp\abaconnect_import_Result.xml 

Heisst die Exportdatei: 

x:\temp\abaconnect_export.xml 

trägt die Statusberichtsdatei für den Export folgenden Namen: 

x:\temp\abaconnect_export_Response.xml 

Die Response-XML-Datei kann im Internetbrowser angezeigt werden. Ein Stylesheet, Response.xsl, ist dazu aber 

erforderlich. Diese Stylesheet-Datei, Response.xsl, wird in demselben Ordner wie die Export- oder Import-Response-Datei 

gespeichert. 

Seite25/31


Command Line 

Command Line 

Die AbaConnect-Schnittstellen können via Command Line importiert und exportiert werden. Der ABACUS Command 

Line-Export kann mit abaconnectexportconsole.exe gestartet werden, der ABACUS Command Line-Import 

wird mit abaconnectimportcomsole.exe gestartet. Beide Anwendungen befinden sich im Verzeichnis x:\abac\df der 

ABACUS Installation. 

Benutzeroptionen für AbaConnect Command Line 

Um das Dienstprogramm AbaConnect Command Line verwenden zu können, muss beim designierten 

ABACUS Benutzer die Option "Internet Benutzer" gesetzt sein. Die abaconnectexportconsole.exe und 

abaconnectimportconsole.exe Anwendungen benutzen ein Login via AbaView-Komponente, welche diese Option 

erfordert. 

Command Line Übersicht 

Die AbaConnect Command Line verwendet die installierten abaconnectexportconsole.exe und 

abaconnectimportconsole.exe Programme im ABACUS Verzeichnis x:\abac\df. Die grundlegenden Command 

Line Optionen sind 

abaconnectexportconsole [Parameteroptionen] 

beziehungsweise 

abaconnectimportconsole [Parameteroptionen] 

Die verschiedenen System- und Parameteroptionen werden sogleich erklärt. 

Das Programm muss auf der Command Line definiert werden. Die AbaConnect Command Line verfügt über Optionen 

für den Datenimport und -export. Diese Option kann als erster Parameter der Command Line definiert werden. 

Weitere Command Line Optionen hängen vom spezifischen Programmnamen ab. 

Seite26/31


Command Line 

Parameteroptionen 


Die globalen Command Line Optionen werden verwendet, um Login, Applikationsnamen und Mandanteninformationen 

zu definieren. 

Option 

Beschreibung 

-a Definiert den Namen der Applikation für die Aba- 

Connect-Schnittstelle. Zur Definition der Applikation wird 

das Applikationskürzel verwendet, z.B. -aLOHN 

-m Definiert den für den Export oder Import zu verwendenden 

Mandant, z.B. -m7777 

/PW 

Definiert das Passwort für den designierten Benutzer, 

z.B. /PWeli 

/USR 

Definiert den Benutzernamen für das Login, z.B. /USRAdministrator 

AbaConnect Parameteroptionen 

Die AbaConnect Command Line Optionen werden für die Definition der Schnittstellen-spezifischen AbaConnect-Informationen 

verwendet. 

Option 

Beschreibung 

-P Definiert die Applikationsprogrammnummer für den Export 

oder Import. Dies ist wichtig bei der Verwendung der 

VORGABE (-VGB) Command Line Option. Die allgemeine 

AbaConnect Benutzeroberfläche ist im AbaMenu via 

Programm 625 zugänglich. Je nach Applikation ist Aba- 

Connect im AbaMenu eventuell auch über andere Programmnummern 

zugänglich. Beispiel: -P625 

-VGB 

Definiert die Vorgabenummer, die für den Exportvorgang 

verwendet wird. AbaConnect Exportselektionen können 

als Vorgabe via AbaConnect Benutzeroberfläche gespeichert 

werden. Die Vorgabenummer wird zusammen mit 

der Applikationsnummer verwendet, um die spezifische 

Vorgabe zu definieren. Beispiel: -VGB2 (Default ist keine 

Vorgabe) 

-version 

Definiert die Version der AbaConnect-Schnittstelle. 

-dbmode 

-exportfile 

-acid 

-mapid 

Beispiel: -version2007.10 

Definiert den Datenbankmodus-Parameter. Mögliche 

Werte sind SAVE, INSERT, UPDATE, READ oder DELE- 

TE. Der Vorgabewert ist SAVE. Beispiel: -dbmodeUPDA- 

TE 

Der Name der Exportdatei. 

Beispiel: -exportfileC:\temp\export.xml 

Der AbaConnect Schnittstellenname, der die spezifische 

Schnittstelle identifiziert. Diese Information kann aus der 

Konfigurationsansicht der AbaConnect Benutzeroberfläche 

aufgerufen werden oder indem eine Beispielsdatei 

exportiert wird. Beispiel: -acidContacts 

Die Mapping-Identifikation, die für die spezifische Aba- 

Connect-Schnittstelle verwendet wird. Für die meisten 

AbaConnect Standardschnittstellen ist die Mapping-Identifikation 

AbaDefault (einige sind jedoch unterschiedlich). 

Beispiel: -mapidAbaDefault 

Seite27/31


Command Line 


-datamode 

-transactiontype 

-importfile 

Definiert den AbaConnect Datenmodus. Dies kann XML 

oder ASCII sein. Nicht alle AbaConnect-Schnittstellen erlauben 

das ASCII-Format. Beispiel: -datamodeXML oder 

-datamodeASCII 

Definiert den verwendeten Transaktionstyp. Mögliche 

Werte sind ALL oder SINGLE. Dies definiert, wie die Datentransaktionen 

bezüglich Datenvalidierung behandelt 

werden. Der Vorgabewert ist ALL. Beispiel: -transactiontypeALL 

Der Name der Importdatei. 

Beispiel: -importfileC:\temp\import.xml 

Seite28/31


Command Line 

Zusätzliche Optionen 

Zusätzliche Optionen 

Die folgenden Optionen sind für die zusätzliche Konfiguration der Command Line Verarbeitung verfügbar. Normalerweise 

werden für diese Optionen die Vorgabewerte verwendet. 

Option 

Beschreibung 

-response 

Definiert, ob eine Response-Datei beim AbaConnect 

Command Line Vorgang immer generiert wird. Eine Response-Datei 

wird immer dann generiert, wenn vom Vorgang 

ein Fehlerstatus zurückgegeben wird. Der Vorgabewert 

ist NO für Export und YES für Import. 

Beispiel: -responseYES 

-responselevel 

Definiert die Response-Stufe für die Informationen, die in 

die Response-Datei geschrieben werden. Mögliche Werte 

sind INFO, WARNING oder ERROR. Der Vorgabewert 

ist WARNING. 

Beispiel: -responselevelERROR 

-responsefile 

Damit kann der Name der Response-Datei bestimmt 

werden. Beispiel: -responsefileD:\test 

\AC_ResponseFile.xml. 

Dieses Feature ist nur ab Version 2008 oder höher verfügbar. 

Das referenzierte "Response-xsl" Stylesheet muss 

eventuell manuell ins Verzeichnis der Response-Datei kopiert 

werden, wenn die Response-Dateien mit dem Internet-Browser 

angezeigt werden sollen. Die Erstellung der 

Response-Datei hängt vom definierten "-response"-Parameter 

ab. 

-mandantonly 

Definiert, ob der Vorgang nur auf den angegebenen 

Mandant beschränkt ist. Der Vorgabewert ist 

YES. 

Beispiel: -mandantonlyNO 

-appparam Definiert zusätzliche applikationsspezifische Parameter. 

Die Werte hängen von der Applikation 

ab. Werte werden als Keyword=Value vergeben. 

Beispiel: - 

appparamMyKey1=MyValue1;MyKey2=MyValue2 

Seite29/31


Command Line 

Beispiel 

Beispiel 

Der folgende Befehl auf der Command Line dient dem Export von Adressen: 

x:\abac\df\abaconnectexportconsole.exe "/USRAdministrator" "/PWeli" "-M7777" 

"-aADRE" "-P625" "-datamodeXML" "-version2007.10" "-acidAddress" "-mapidAba- 

Default" "-responseYES" "-responsefileX:\test\AC_Response.xml" "-exportfileX:\test 

\AC_Adre_ExportData.xml" 

Um XML-Daten zu importieren, kann dieser Befehl verwendet werden: 

x:\abac\df\abaconnectimportconsole.exe "/USRAdministrator" "/PWeli" "- 

M7777" "-aADRE" "-P625" "-datamodeXML" "-responseYES" "-responsefileX:\test 

\Import_Response_File.xml" "-importfileX:\test\AC_ImportData.xml" 

N.B.: Die Information über den Schnittstellenname und das Mapping ist in der XML Importdatei enthalten. Deswegen 

ist es beim Import nicht nötig, diese auf der Command Line zu mitgeben. 

Seite30/31


Command Line 

AbaConnect Kopfinformationen 

AbaConnect Kopfinformationen 

Die Command Line Parameter erfordern spezifische Informationen über die AbaConnect-Schnittstelle. Diese beinhalten: 

Applikationsname (-a), AbaConnect Schnittstellen-Identifikation (-acid), AbaConnect Mapping-Identifikation 

(-mapid), Mandant (-mandant) und die Version (-version). Diese Information können aus ABACUS Programm 625 im 

AbaConnect Konfigurationsbereich aufgerufen werden. Sie sind ebenfalls aus den Parametern einer AbaConnect 

XML-Exportdatei ersichtlich, die via ABACUS Programm 625 exportiert wird. 

AbaConnect XML-Beispiel 

 

 

 

 

 

ADRE 

Contacts 

AbaDefault 

7777 

2007.10 

 

 

..... 

 

Seite31/31

AbaConnect Handbuch (PDF) - ABACUS Research AG

Erfolgreiche ePaper selbst erstellen

Template löschen?

Als Template speichern?