X4 Produktdokumentation

Defining the Adapter Interface

The adapter interface can be defined within the adapter definition file (.nad). The available adapter operations are specified using technical processes.

  1. Create an adapter project, see Creating Adapter Projects.

  2. Open the adapter definition file <Projectname>.nad by double-clicking it.
    An editor for defining the adapter interface will be opened.
    Adapter-Definition_7.0.png

  3. Define the general adapter settings within the Adapter area. The following settings can be made:

    • Name: Adapter name 

    • Version: Adapter version

    • Category: Adapter category, e.g. Tools

    • Package: Name of the WildFly module to be provided.

      This setting is relevant when using the option Package as Adapter.


    • License Key: Adapter license key

    • Description: Adapter description

  4. Within the tab Operations, add any number of adapter operations via Add: Add.png  
    Each operation has to be linked to a technical process.

    • To delete an operation select the row and click Remove: Remove.png

    • Newly created processes are updated automatically.


  5. Select for each operation the corresponding technical process from the folder  Operations .
    Operations_7.0.png

  6. Within the tab Parameters, add any number of adapter parameters via Add: Add.png
    Parameters.png

  7. Define the adapter parameters. The following settings can be made:

    • Name: Parameter name 

    • Description: Parameter description

    • Type: Parameter type String: For strings Number: For numbers Boolean: For Boolean valuesCombo: For drop-down listsNames and values for possible options of a combo box can be created in the Combo Options. The Combo Options are displayed automatically, when type Combo is selected for a parameter.Password: For passwordsValues with type password are not in plain text and cannot be copied.

    • Default Value: Default value of the parameter

    • Required: Information, whether a parameter is mandatory or optional

    The parameters will be available within technical processes as placeholder PARAM_INPUT_<Name>


  8. Within the tab Icons, define images from the folder  Icons  as adapter icons.

    Icons_7.0.png

    Newly added icons are updated automatically.


  9. Save the adapter definition.