Configuring the Complex Data data handler

To configure the Complex Data data handler for use with a connector, take the following steps:

Each of these steps is described in more detail in the following sections.

Installing, registering, and verifying ContentMaster

To install ContentMaster, follow the installation instructions provided in the Itemfield ContentMaster documentation for your particular ContentMaster version and operating system. This documentation provides hardware and software requirements as well instructions to install, register and verify the ContentMaster product.

When prompted by the ContentMaster installation for the Java Runtime Environment (JRE) location, be sure to select the JRE shipped with the WBI Adapters. The WBI JRE is located in the <WBI install dir>/jre/bin/classic directory.

Note:
The command-line installation of ContentMaster will not prompt for the JRE location. If this is the case you will have to change the JRE location manually after the install. Please consult the version and platform specific ContentMaster documentation to determine which files or environment variables need to be modified to specify a different JRE.

Finally, register and test the ContentMaster installation following the directions in the ContentMaster documentation before proceeding with the adapter configuration.

Configuring the data handler for use with the adapter

In order use the Complex Data data handler with a WBIA adapter, you must modify the adapter start-up script to include files required by the Complex Data data handler. The modifications required to the connector start script are detailed below.

Configuring the Complex Data data handler configuration meta object

To configure the Complex Data data handler, you must ensure that its configuration information is provided in the Complex Data data handler's child meta-object.

For the Complex Data data handler, IBM delivers the default child meta-object MO_DataHandler_Complex. Each attribute in this meta-object defines a configuration property for the Complex Data data handler. The default child meta-object for the Complex Data data handler contains five attributes, one of which is a reference to the XML data handler meta object definition. These attributes are defined in Table 66.

Table 66. Child meta-object attributes for the Complex Data data handler

Attribute name Description Delivered default value
ClassName Name of the data-handler class to load for use with the specified MIME type. The top-level data-handler meta-object has an attribute whose name matches the specified MIME type and whose type is the Complex Data child meta-object. com.ibm.adapters. datahandlers.complex. Complex
CMParser Name under which the Content Master Parser is published. None
CMSerializer Name under which the ContentMaster Serializer is published. None
ObjectEventId
Placeholder attribute required by the business integration system. None
XMLDH_ConfigMO The child meta object for the XML Data Handler that the Complex Data data handler uses. MO_DataHandler_XML

The "Delivered default value" column in Table 14 lists the value in the Default Value property for the corresponding attribute in the delivered business object. You must examine your environment and set the Default Value properties of those attributes to the appropriate values. You must make sure that all attributes have default values except where the conversion will be unidirectional. In this case you must specify either a CMParser or CMSerializer value.

Note:
Use Business Object Designer to modify business object definitions.

A single child meta-object can specify only one Parser/Serializer pair. If your connector requires processing of multiple data formats, you must create separate child meta-objects for each Parser/Serializer pair. To prepare multiple configurations of the Complex Data data handler, take the following steps:

For more information about how to configure a data handler, see Configuring data handlers.

Copyright IBM Corp. 1997, 2004