Adapter-Operationen festlegen
Adapter bieten bestimmte Funktionen, die sich im X4 Designer in der Properties-Sicht ü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
Für jede Operation die Annotation
@AdapterOperation
für die Deklaration an einepublic
-Methode in der Adapter-Klasse angeben.Parameter definieren.
- Jede Methode kann optional einen Parameter definieren. Dieser entspricht dem Adapter-Input.
- Der Rückgabetyp der Methode kann
X4Document
oder 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
-1
abgebrochen.
Das Grundgerüst einer Operation-Methode ist nun fertig.
Metadaten für Adapter-Operation 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 pro Adapter sein. |