Implementation Guide › Implementation › Data Gathering (Data Source Expert) › How to Configure Adapters and Translations › Create an Adapter Using the CA Business Service Insight User Interface

Create an Adapter Using the CA Business Service Insight User Interface

Each Adapter configured to run within the CA Business Service Insight environment must be registered within the user interface in addition to being defined in the registry. The reason behind this step is mainly to establish the settings of the Adapter Listener side so that it is ready to receive events from the Adapter. During this step the all of the Adapter settings, such as, Translation tables and Event types are defined.

Follow these steps:

1. Create the Adapter.
2. Choose Resources/Adapters.
3. Check the existing Adapters in the list to see that none are defined on the same port as your Adapter, that is, the same port that is defined in the configuration file of the Adapter in the directory OblicoreInterface\OnlineInterface\Port.
4. Click Add new, and then select the method that you want to use to create the Adapter. There are a number of options:
   1. Create manually: Sets up the Adapter Listener to connect to the Adapter you have defined (or will define) manually.
   2. Using the Wizard: Allows creating the adapter using a screen-by-screen wizard interface. See the next section for details on this.
   3. From a template
   4. From an existing configuration file: Allows uploading a pre-configured adapter template which automatically fills in the fields of the adapter wizard with the options set in the configuration file specified.
   5. The resulting screen varies per chosen option.
5. Fill in the fields:

   Network address-enter the IP address of the Adapter. localhost in case it is local to the application server, otherwise enter the defined port.

6. Click Save.

To create the necessary translation tables:

Note: These steps should be performed for each translation table defined in the configuration file:

1. On the Design menu click Translation, Translation Tables and click the 'Add New' button.
2. All the translation table settings should correspond to the equivalent table definition in the Adapter configuration file:
   • Name: Should match the Name attribute in the configuration file Translation table, Name.
   • Source fields: Should have all the fields from the TranslationField of the translation table. Add all fields. There may be a combination of two or more fields that make up the translation value. The following is an example of how this might look:

     

3. Destination type: Should again correspond with the DestinationType attribute of the translation table definition in the configuration file. (resource, event_type, and so on).
4. Registered Adapters: Add the Adapters that are to use this translation table. More then one Adapter can use a single translation table.
5. Click Save.
6. Import the Event type fields definition for each event type.

   To be able to import the fields definition from a specific Adapter configuration file, this Adapter should have run and connected to CA Business Service Insight at least once. When the Adapter connects to CA Business Service Insight, it sends the configuration file to CA Business Service Insight which allows the system to use the fields definition from it.

   Note: Alternatively, you can specify the field definitions manually to the event type.

7. Activate the Adapter:
   1. On the Design menu, click Data Acquisition, Adapters.
   2. Click the Start button for the Adapter.

The following table contains the different statuses of the Adapters: