User Guide › Design › Data Acquisition › Adapters › Deploying Adapters › Adapter Manager › Creating Adapters

Creating Adapters

When creating a new adapter using Adapter Manager, a new folder is created where all related files as well as the registry entries defining it are placed.

Use this process to create a new adapter:

1. In the Adapters Manager window, click on the toolbar.

   The Adapter Install Wizard opens.

2. Click Next.
3. Type a name for the new adapter (no spaces are allowed in the name, configuration file, folder or translation table).
4. Select whether to create a new folder for this adapter or specify a folder to which the adapter is placed.
5. Click Next.
6. Select the adapter type:
   • File for adapters reading flat files
   • SQL for adapters that are to query a database.
7. Click Next.
8. Specify the location and name of the configuration file.
9. Select the Copy Configuration Template check box to have Adapter Manager copy the configuration file from a template.
10. Specify the location and name of the log file.

    Note: It is recommended to use the locations names that the Adapters Manager suggests.

11. Click Next.
12. Select the running mode for the adapter:
    • Select Run as a service to have the adapter installed as a regular Windows service. This enables the system to control its status (Run, Pause, Stop, Automatic) as it would a regular Windows service.
    • Select Run as an application to run the adapter executable from the command line.
    • Select the hide console check box to have the running adapter viewed in task manager only or un-check this check box to have a console view of the running adapter. This check box is enabled only when Run as an application and Copy adapter executable are selected.

    Note: It is recommended to select the Run as an application option leaving the hide console check box cleared.

13. Select Create shortcut to have a shortcut to the executable created in the created/specified folder. This is recommended at times, such as when upgrading the system, only the main executable will need to be changed.
14. Select Copy adapter executable to have a copy of the executable file created in the created/specified folder and renamed to the adapter's name.

    Note: You can use the Create shortcut option so that when upgrading CA Business Service Insight, only the main executable needs to be changed.

15. Click Next.
16. Click Finish.
    • The adapter is created and all definitions are registered in the registry.
    • If the Create a new folder option was selected during installation, a folder with the adapter name is created containing a shortcut to the adapter executable or a copy of the adapter executable (as per user selection) and a sample configuration file.
    • If the Specify a folder option was selected during installation, the specified folder now contains a shortcut to the adapter executable or a copy of the adapter executable (as per user selection) and a sample configuration file.