Testing an Adapter Configuration

After configuring the adapter, you can use Adapter Launcher to start the adapter. Adapter Launcher is a tool that is used to test adapter configurations in TIBCO Business Studio.

Prerequisites

  • An adapter service has been added as described in Adding an Adapter Service.
  • The EMS server is running if the adapter uses the JMS transport type. For how to start the EMS Server, see the TIBCO Enterprise Message Server documentation.
Note: When you set up an adapter configuration in Adapter Launcher, the configuration is saved for each adapter configuration in the project. If you want to run the adapter configuration in Adapter Launcher on a different machine, you have to change some settings because some directories are not valid.

Procedure

  1. From the menu, click Run > Run Configurations.
  2. In the left panel, click Adapter Launcher > New.
  3. In the Adapter Configuration tab, click Browse to select the adapter configuration in the Adapter Configurations field.
  4. In the Adapter Configuration selection dialog, expand the project and select the adapter configuration you have created.
    In the Adapter Executable field, the latest version of the adapter executable is selected by default.
  5. Click OK.
  6. In the Working Directory field, enter a directory path or click Browse to navigate to a working directory.
    When running Adapter Launcher, runtime files are generated in this directory, and all files in this directory are temporary. It is good practice not to edit files in the working directory. Ensure that the disk where the working directory is located contains enough space to save multiple copies of your project.
    Note: With the working directory configuration, you can also click the Update Preferences link in the Adapter Services tab. And then specify the directory for the Working Directory field. By doing this, the specified working directory is available for all the projects in the same workspace.
  7. Click Apply, and then click Run.
    TIBCO Business Studio starts the adapter. The progress of the adapter configuration is displayed in the console view.
  8. Click the Stop Adapter icon on the tool bar of the console if you want to stop the adapter.