Abas ERP Connector

Abas ERP Connector: Stellt eine Verbindung zum Abas ERP-System über dessen jedp-Schnittstelle her und führt verschiedene Operationen aus.

Eigenschaften (Properties)

Operation

Bestimmt, welche Operation der Connector durchführt

Mögliche Werte:

Query: Datensätze und Tabelleninhalte abfragen
Info: Metadaten von abas abfragen
Write: Datensätze und Tabelleninhalte hinzufügen oder ändern

Parameter

Adapter	Hauptklasse des Adapters (nicht verändern!) Mögliche Werte: de.softproject.integration.adapter.abas.AbasAdapter: Hauptklasse (Standard)
appName	Name der Applikation Mögliche Werte: Beliebige Zeichenkette
edpPort	EDP-Port Mögliche Werte: Beliebige ganze Zahl, z.B. `6550`
mandant	Name des Mandanten Mögliche Werte: Beliebige Zeichenkette, z.B. `systemtest`
host	IP-Adresse oder Host-Name des Servers Mögliche Werte: Beliebige gültige Zeichenkette ohne Protokollangabe, z.B. `example.com`
password	Passwort für die Authentifizierung Mögliche Werte: Beliebige Zeichenkette
edpVersion	EDP-Version Mögliche Werte: Beliebige ganze Zahl, z.B. `3.35` (Standard)
wait	Lock-Verhalten der Session Mögliche Werte: `WAITINFINITE`: Warten, bis Lock freigegeben ist `WAIT`: Warten, bis Lock freigegeben oder die Zeitbeschränkung erreicht ist `NOWAIT`: Fehler ohne zu warten sofort zurückgeben (Standard)
timeout	Zeitbeschränkung für den Verbindungsaufbau in Sekunden Mögliche Werte: Beliebige ganze Zahl, z.B. `30` (standard)

Statuswerte

`1 (OK)`	Die Ausführung war erfolgreich
`-1 (ERROR)`	Bei der Ausführung kam es zu einem Fehler, z.B. wegen eines ungültigen XML-Inputs
`0 (TIMEOUT)`	Bei der Abfrage des abas ERP-Systems kam es zu einer Zeitüberschreitung

Input

Für die verschiedenen Operationen erwartet der Adapter folgende XML-Input-Strukturen:

Operation: Query

XML

<Abas>
    <!-- Query ausführen -->
	<Query resulttag="...">
		<DatabaseGroup>00:01</DatabaseGroup>
		<Fields>
			<_ans/>
			<_str/>
			<_nummer/>
		</Fields>
		<Selection>nummer=20001!20002</Selection>
	</Query>
	<Query resulttag="...">
		<DatabaseGroup>01:01</DatabaseGroup>
		<Fields>
			<_schlag/>
			<_yvertragsnr/>
			<_kunde/>
		</Fields>
		<Selection>kunde=20001!20002</Selection>
	</Query>
</Abas>

Operation: Info

XML

<Abas>
	<!-- Aktion ausführen -->
	<Info resulttag="...">
		<Nummer>1000</Nummer>
		<HeaderFields>
			<_bstart>1</_bstart>
		</HeaderFields>
		<TableFields>
			<_tysuch/>
			<_tyname/>
		</TableFields>
	</Info>
	<Info resulttag="...">
		<Nummer>1000</Nummer>
		<HeaderFields>
			<_bstart>1</_bstart>
		</HeaderFields>
		<TableFields>
			<_tysuch/>
		</TableFields>
	</Info>
</Abas>

Operation: Write

XML

<Abas>
    <!-- Bestehenden Datensatz ändern -->
	<Update resulttag="...">
		<Database>00</Database>
		<Group>01</Group>
		<Nummer>20001</Nummer>
		<HeaderFields>
			<_str>...</_str>
		</HeaderFields>
	</Update>
	<!-- Neuer Datensatz -->
	<Insert resulttag="...">
		<Database>00</Database>
		<Group>01</Group>
		<HeaderFields>
			<_nummer>200171</_nummer>
			<_such>Testsuch</_such>
			<_ans2>Testans</_ans2>
			<_str2>Testgasse</_str2>
			<_plz2>12345</_plz2>
			<_nort2>Testhausen</_nort2>
			<_zbed>100</_zbed>
		</HeaderFields>
	</Insert>
    <!-- Zeile in bestehendem Datensatz ändern -->
	<Update resulttag="...">
		<Database>71</Database>
		<Group>02</Group>
		<Nummer>4</Nummer>
		<Table>
			<Row nr="2">
				<TableFields>
					<_ytg02beschreibung>blau</_ytg02beschreibung>
				</TableFields>
			</Row>
		</Table>
	</Update>
	<!-- Neue Zeile in bestehendem Datensatz -->
	<Update resulttag="...">
		<Database>71</Database>
		<Group>02</Group>
		<Nummer>4</Nummer>
		<Table>
			<Row nr="2" new="true">
				<TableFields>
					<_ytg02beschreibung>gelb</_ytg02beschreibung>
				</TableFields>
			</Row>
		</Table>
	</Update>
</Abas>

Output

Für die verschiedenen Operationen gibt der Adapter folgende XML-Ergebnisdokumente aus:

Operation: Query

XML

<Result>
	<Adresse>
    	<_ans>Max Mustermann</_ans>
    	<_str>Musterallee 2</_str>
    	<_nummer>20001</_nummer>
  	</Adresse>
  	<Adresse>
    	<_ans>Manfred Mustermann</_ans>
    	<_str>Testweg 1</_str>
    	<_nummer>20002</_nummer>
  	</Adresse>
  	<Vertrag>
    	<_schlag>RECHNUNG.2017.10</_schlag>
    	<_yvertragsnr>01-000001-001</_yvertragsnr>
    	<_kunde>123</_kunde>
  	</Vertrag>
   <!-- ggf. weitere Knoten -->
</Result>

Operation: Info

XML

<Result>
	<Test>
   		<_tysuch>XY123</_tysuch>
    	<_tyname>Test Abas-Server</_tyname>
  	</Test>
  	<Test2>
  		<_tysuch>XY123</_tysuch>
  	</Test2>
</Result>

Operation Write

XML

<Result>
	<Testupdate1>updated</Testupdate1>
  	<Testinsert1>inserted</Testinsert1>
  	<Testupdate2>updated</Testupdate2>
  	<Testupdate3>updated</Testupdate3>
</Result>

Abhängigkeiten

Der Connector verwendet die Bibliothek jedp von abas, jedp-3.3.5.jar.

Die aktuell unterstützte Version ist 3.3.5.

Die Bibliothek wird aus lizenzrechtlichen Gründen nicht ausgeliefert. Zur Verwendung diese Bibliothek im X4 Server-Installationsordner in Ordner wildfly\modules\de\softproject\x4\extensions\main\ kopieren, gemeinsam mit einer Datei module.xml mit folgendem Inhalt:

module.xml

XML

<?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.1" name="de.softproject.x4.extensions">
    <resources>
        <resource-root path="jedp-3.3.5.jar" />
    </resources>
</module>