Registering and configuring an EDS plug-in to reference a custom EDS data source plug-in

The external data service (EDS) plug-in can be configured to reference an external EDS web service. Customers who cannot deploy a custom web service can reference a custom EDS data source plug-in.

About this task

Sample code for an EDS data source plug-in was uploaded to the Content Navigator samples. This sample plug-in provides the PluginAPI implementation that is similar to the sample EDS web service.

The sample code includes two PluginAPI classes, GetObjectTypesAPI and Objectification. These classes provide function that is comparable to the GetObjectTypesServlet and UpdateObjectTypeServlet classes that are provided by the sample EDS web service. You can use this sample plug-in instead of the sample EDS web service.

When you configure the EDS plug-in in your environment, you can either specify an EDS web service URL or select an installed (and enabled) plug-in from a menu list. A Verify button calls a new plug-in service to verify that the specified plug-in provides the two PluginAPI implementations that are required: GetObjectTypesAPI and UpdateObjectTypeAPI.

This feature requires the EDS plug-in at IBM Content Navigator Version 3.0.8.1 or later. For Content Navigator on-premises and container customers, you must first upgrade to IBM Content Navigator 308 IF001.

Procedure

Prerequisites for a container or Business Automation Content Services on Cloud (BACSoC) environment:

Before you install your custom EDS Data Source plug-in, you need to configure the Upload File Path on the Server setting from the IBM Content Navigator administration console. Then, you must upload your custom EDS Data Source plug-in.

  1. Log in toIBM Content Navigator as an administrator and go to the administration console.
  2. Click Settings. Then, General.
  3. For BACSoC and containers, confirm that the Upload File Path on the Server setting is configured to be /opt/ibm.If the path is not configured to that path, set it to /opt/ibm and Save.
  4. Refresh your browser and log in to the IBM Content Navigator administration console.

The following installation instructions are for the two EDS plug-ins:

  1. On the IBM Content Navigator directory, select Plug-ins.
  2. Click New Plug-in.
  3. Select Jar file path. Enter the path for the EDS Data Source plug-in JAR file.

    An example is

    The ECMClient folder is the IBM Content Navigator installation directory.
    • Microsoft Windows:

      C:\Program Files\IBM\ECMClient\SamplePlugin\edsDataSourceSamplePlugin.jar

    • Linux® or AIX®:

      /opt/IBM/ECMClient/SamplePlugin/edsDataSourceSamplePlugin.jar

    For the containers and BACSoC environment, the path for the EDS Data Source plug-in that is uploaded is /opt/ibm/plugins/edsDataSourceSamplePlugin.jar.

    Note: You can use the sample code. Build and deploy as a test to make sure that everything is working. Then, you can customize as you need to.
  4. Click Load.
    If the plug-in JAR file loaded successfully, the EDS Data Source plug-in is automatically loaded and the plug-in information is displayed at the lower pane.
  5. Click Save and Close.
  6. On the Plug-ins pane, click New Plug-in.
  7. Select Jar file path and enter the path to the location of the EDS plug-in JAR file.

    An example is

    The ECMClient folder is the IBM Content Navigator installation directory.
    • Microsoft Windows:

      C:\Program Files\IBM\ECMClient\edsPlugin\edsPlugin.jar

    • Linux® or AIX®:

      /opt/IBM/ECMClient/edsPlugin/edsPlugin.jar

    For the containers and BACSoC environment, the path to the EDS plug-in is /opt/ibm/intPlugins/eDS/edsPlugin.jar.

  8. Click Load.

    If the plug-in JAR file loaded successfully, an External Data Service section is appended at the bottom of the pane.

    Note: If you do not see the Data source Plugin controls in the External Data Service section, you do not have the required version of the EDS plug-in.
  9. Scroll down to the External Data Service section.
    1. Select Data source Plugin.
    2. Click the menu list and select the EDS Data Source plug-in that you just added.
    3. Click Verify. If the plug-in communication is working correctly, Verified is displayed.
  10. Click Save and Close to complete.