Adapter bieten bestimmte Funktionen, die sich im X4 Designer in der Sicht Properties über die Eigenschaft Operation auswählen lassen. Jeder Listeneintrag dieses Auswahlmenüs entspricht einer Operation-Methode im Adapter.
Ein Adapter benötigt mindestens eine Operation. Verfügt der Adapter nur über eine einzige Operation, so wird diese im Prozess-Designer automatisch ausgewählt.
Methoden zu Operationen zuordnen
-
Geben Sie für jede Operation die Annotation
@AdapterOperationfür die Deklaration an einepublic-Methode in der Adapter-Klasse an. -
Definieren Sie Parameter.
-
Jede Methode kann optional einen Parameter definieren. Dieser entspricht dem Adapter-Input.
-
Der Rückgabetyp der Methode kann
X4Documentoder eine JAXB-konforme Java-Bean sein. Ist der Rückgabetypvoid, wird der Input als Output betrachtet. -
Um Java-Beans benutzen zu können, muss der Input XML und konform zur Java-Bean-Definition sein. Andernfalls wird die Adapter-Ausführung mit dem Status
-1abgebrochen.
Das Grundgerüst einer Operation-Methode ist nun fertig.
Metadaten für Adapter-Operationen definieren
Um Metadaten für Adapter-Operationen zu definieren, wird die Annotation @AdapterOperation verwendet:
|
Feld |
Beschreibung |
|---|---|
|
|
Gibt den Namen der Operation an und kann frei gewählt werden. Er muss jedoch eindeutig für den Adapter sein. |