Adapter

Adapter: Stellt grundlegende oder zusätzliche Funktionen bereit, etwa Zeichensatz-Konvertierungen oder ermöglicht beispielsweise den Zugriff auf ein SAP-System. Da der X4 Designer hauptsächlich mit XML-Daten arbeitet, werden mit Adaptern meist XML-Dokumente erzeugt oder verändert. Als Output erzeugen Adapter vorwiegend XML-Daten, die in einem nächsten Prozessschritt weiterverarbeitet werden.

Um den Adaptertyp zu wählen und Parameter festzulegen, doppelklicken Sie in der Zeichnungsfläche auf das Adapter-Symbol. Die spezifische Bedeutung der im Folgenden genannten Eigenschaften der Adapter ist in der jeweiligen Adapter-Referenz beschrieben.

Eigenschaften

`Adapter type`	Name des Adapters
`Component Parameters`	Component-Parameter setzen, siehe Component-Parameter verwenden
`Document`	Pfad zum verknüpften Adapter im Repository
`Label`	Bezeichnung des Adapters im Technical Process (Freitext)
`Operation`	Bestimmt, welche Operation mit dem Funktions-Adapter durchgeführt wird. Je nach Adapter unterscheiden sich die Werte und Funktionen.

Adapter anlegen und verwenden

Adapter lassen sich innerhalb eines ESB-Projekts im Ordner Adapters anlegen. Hierzu stehen zwei Möglichkeiten zur Verfügung:

über das Menü Project > Add Adapter
über das Kontextmenü New > Adapter

Um einen Adapter anzulegen und zu parametrieren, gehen Sie wie folgt vor:

Klicken Sie in einem ESB-Projekt mit der rechten Maustaste auf den Ordner Adapters, um das Kontextmenü aufzurufen.
Rufen Sie im Kontextmenü New > Adapter auf.
Der File Creation Wizard zum Anlegen von Adaptern wird geöffnet.
Wählen Sie den gewünschten Adapter aus der Liste.

Im Suchfeld können Sie die Adapternamen und Beschreibungen nach einem Stichwort durchsuchen und somit die angezeigten Adapter einschränken. Zudem können Sie die Adapter durch Klicken auf den Spaltentitel Category nach Kategorien sortieren.
Geben Sie in File name den Adapter-Namen ein.
Klicken Sie auf Finish, um den Adapter in der Sicht Projects anzulegen.
Der Adapter wird im Adapter-Editor zur Konfiguration der Parameter geöffnet.
Hinweis:

Wenn Sie mit der rechten Maustaste (oder mit Strg + C) auf den Namen des Parameters klicken, können Sie diesen kopieren und so zum Beispiel in als Parameter in Mappings, als Component-Parameter oder als dynamischen Parameter verwenden.
Weitere Informationen finden Sie hier zur Verwendung von Parametern:
Hinterlegen Sie im Adapter-Editor die gewünschten Parameterwerte, mindestens jedoch die Pflichtparameter.
Pflichtfelder erkennen Sie am Symbol
.
- Setzen Sie alle Adapter-Parameter, die vertrauliche Informationen enthalten, immer dynamisch per XSL-Mapping, z. B. über die Processing Instruction DynamicParameter.
  Weitere Informationen hierzu finden Sie unter Component-Parameter verwenden.
  So werden die Zugangsdaten erst zur Laufzeit des Technical Processes im Adapter gesetzt, und die entsprechenden Parameter müssen nicht im Adapter angegeben werden und sind somit nicht einsehbar.
- Eine Beschreibung der Parameter für einzelne Adapter finden Sie unter Übersicht der X4 Adapter.
Speichern Sie den Adapter.
Fügen Sie den Adapter per Drag&Drop aus der Sicht Projects in den Technical Process ein.
Wählen Sie in der Sicht Properties für den markierten Adapter in der Eigenschaft Operation eine Adapter-Operation aus.
Der Adapter ist nun einsatzbereit.
Speichern Sie den Technical Process.