X4 Produktdokumentation
X4 Produktdokumentation
Breadcrumbs

Adapterdefinition vornehmen

Die Schnittstelle des Adapters lässt sich über die Adapter-Definitionsdatei (.nad) definieren. Die später verfügbaren Adapter-Operationen werden dabei über technische Prozesse definiert.

  1. Adapter-Projekt anlegen, siehe (7.4.0-de) Adapter-Projekt anlegen.

  2. Definitionsdatei <Projektname>.nad per Doppelklick öffnen.
    Ein Editor zum Bearbeiten der Adapter-Definition wird nun geöffnet.

    Adapter-Definition_7.0.png

  3. In Adapter-Bereich die Grundeinstellungen des Adapters definieren. Folgende Einstellungen lassen sich vornehmen:

    • Name: Adapter-Name 

    • Version: Adapter-Version

    • Category: Adapter-Kategorie, z.B. Tools

    • Package: Name des später bereitzustellenden WildFly-Moduls.

      Diese Einstellung ist für die Option Package as Adapter... relevant.

    • License Key: Lizenzschlüssel für den Adapter

    • Description: Adapter-Beschreibung

  4. Unter Operations beliebig viele Adapter-Operationen mit der Schaltfläche Add hinzufügen: Add.png
    Die einzelnen Operationen müssen jeweils mit einem technischen Prozess verknüpft werden.

    • Um eine Operation zu löschen, die entsprechende Zeile markieren und Remove klicken: Remove.png

    • Neu angelegte Prozesse werden automatisch geladen.

  5. Zu jeder Operation den entsprechenden technischen Prozessen aus dem Ordner  Operations  wählen.
    Operations_7.0.png

  6. Unter Parameters beliebig viele Adapter-Parameter mit Add hinzufügen: Add.png
    Parameters.png

  7. Adapter-Parameter definieren. Folgende Einstellungen lassen sich vornehmen:

    • Name: Parameter-Name 

    • Description: Parameter-Berschreibung

    • Type: Parameter-Typ 

      • String: Für Zeichenketten 

      • Number: Für Zahlen

      • Boolean: Für Boolsche-Werte

      • Combo: Für Auswahllisten

        Namen und Werte für die möglichen Optionen einer Combo-Box können in den Combo Options angelegt werden. Die Combo Options erscheinen automatisch, sobald für einen Parameter der Typ Combo ausgewählt wird.


      • Password: Für Passwörter

        Werte vom Typ Password sind nicht in Plaintext und können nicht kopiert werden.

    • Default Value: Standardwert des Parameters

    • Required: Angaben, ob es ein Pflicht- oder Optionaler-Parameter ist

    Die Parameter stehen in den Prozessen als Platzhalter PARAM_INPUT_<Name> zur Verfügung. 


  8. Unter Icons die hinterlegten Bilder aus dem Ordner Icons als Adapter-Icons definieren.

    Icons_7.0.png

    Neu hinzugefügte Icons werden automatisch geladen.


  9. Adapter-Definition speichern.