Der oxaion JET Client stellt eine RPC-Schnittstelle (Remote Procedure Call) bereit, über die Fremdanwendungen Nachrichten an den JET Client senden können. Die Nachrichten werden über einen TCP/IP-Port in Form eines ASCII-Stringes an den Client übergeben. Da an einem Rechner mehrere JET Clients geöffnet werden können, wird i.d.R. beim Start automatisch ein freier Port gewählt, der bspw. in der Serververwaltung angezeigt. Der Übergabestring enthält eine XML-Struktur, in der Befehle und Daten verpackt sind.
Ein solcher XML-String könnte wie folgt aussehen:

<RPC><ACTION>OPEN_PGM</ACTION><DTA><PGM>US11400R</PGM></DTA></RPC>


Hierzu wurden verschiedene Tags definiert. Was die jeweiligen Tags bedeuten und was für Steuerungsoptionen hierfür zur Verfügung stehen, wird in den folgenden Kapiteln erläutert.
Das Grundgerüst eines RPC-Calls sieht wie folgt aus:

<RPC>
	<ACTION></ACTION>
<DTA></DTA>
</RPC>

Ein RPC-Call muss immer mit einem Start-Tag <RPC> beginnen und einem Ende-Tag </RPC> enden. Innerhalb des RPC-Abschnittes folgt ein <ACTION>-Tag und ein <DTA>-Tag.

Das <ACTION>-Tag beschreibt die auszuführende Aktion.
Das <DTA>-Tag beinhaltet alle zur Ausführung dieser Aktion benötigten Parameter und Daten.
Welche Steuerungsbefehle zur Verfügung stehen, wird in den folgenden Kapiteln beschrieben.

Programmaufrufe mit RPC (OPEN_PGM)

Soll ein bestimmtes Programm aufgerufen werden, muss die Aktion OPEN_PGM verwendet werden. Alle benötigten Daten werden in den <DTA>-Abschnitt gestellt – unter anderem der Programmname des Auszuführenden Programmes.
Die Angabe des Programmnamens erfolgt über das <PGM>-Tag im <DTA>-Abschnitt.
Beispiel:

<RPC>
	<ACTION>OPEN_PGM</ACTION>
	<DTA>
		<PGM>US11200R</PGM>
	</DTA>
</RPC>


Im obigen Beispiel wird das Programm US11200R aufgerufen. Da das <DTA>-Tag sonst keine weiteren Tags enthält, werden auch keine Daten an das Programm übergeben.

Nachrichten an Client schicken (MSG)

Das schicken von Nachrichten an den Client erfolgt über die Aktion MSG. Diese Aktion erfordert im <DTA>-Abschnitt folgende Tags:

  • die Angabe eines <MSG>-Tags mit Inhalt der Nachricht
  • sowie eines <TITLE>-Tags mit dem Titel als Inhalt

Beispiel:

<RPC>
	<ACTION>MSG</ACTION>
	<DTA>
		<MSG>Das ist eine Nachricht</MSG>
		<TITLE>Nachricht</TITLE>
	</DTA>
</RPC>


Öffnen eines Programmes im Designmanager (OPEN_XML)

Soll eine XML-Datei im Designmodus geladen werden, muss die Aktion OPEN_XML verwendet werden.
Folgende Tags müssen im <DTA>-Abschnitt angegeben sein:

  • die Angabe des <XML>-Tags mit dem absoluten Pfad der zu öffnenden XML-Datei
  • eventuell das <LNG>-Tag um eine andere Sprachendatei als die Defaultsprache zu verwenden.


Beispiel:

<RPC>
	<ACTION>OPEN_XML</ACTION>
	<DTA>
	<XML>c:/programme/oxaion/programme/server/conf/frames/ust/us30300r.xml</XML>
		<LNG>EN</LNG>
	</DTA>
</RPC>


Aufruf einer Transaktion eines Programmes

Um Transaktionen des gerade geöffneten Programmes aufzurufen, wird die in dem <ACTION>-Tag der Name der in der Programmmaske definierten Transaktion angegeben. Notwendigen Daten können im DTA-Abschnitt übergeben werden. Falls die Transaktion nicht im aktuellen Hauptprogramm ist, kann mit TARGET-PROGRAM ein anderes angegeben werden.
Beispiel: Zuerst Öffnen wir das Programm Zahlungsbedingungen (US10400):

<RPC>
	<ACTION>OPEN_PGM</ACTION>
	<DTA>
		<PGM>US10400R</PGM>
	</DTA>
</RPC>

 
Danach führen wir die Transaktion Zahlungsbedingungen (US10400) selected aus, um einen bestimmten Datensatz zu laden und anzuzeigen:

<RPC>
	<ACTION>US10400-selected</ACTION>
	<DTA>
		<PGM>US10400J</PGM>
		<AKTO>*READ</AKTO>
		<ZAZABD>000</ZAZABD>
	</DTA>
</RPC>

 

Öffnen eines neuen Modus (NEW_MODE)

Öffnet einen neuen Modus (sprich eine neue Session in einem neuen Fenster), ggf. in einer neuen Firma, und startet darin ggf. ein Programm.
Beispiel:

<RPC>
	<ACTION>NEW_MODE</ACTION>
	<DTA>
		<FIRM>900</FIRM>
		<START_PGM>US10400R</START_PGM>
	</DTA>
</RPC>


Daten einstellen (MERGE_DATA)

Stellt Daten in das gerade geöffnete Programm ein, als ob sie vom Benutzer eingegeben worden wären.
Beispiel:

<RPC>
	<ACTION>MERGE_DATA</ACTION>
	<DTA>
		<FELD1>WERT1</FELD1>
		<FELD2>WERT2</FELD2>
	</DTA>
</RPC>
  • Keine Stichwörter