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.
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.
Finally, register and test the ContentMaster installation following the directions in the ContentMaster documentation before proceeding with the adapter configuration.
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.
Windows example:
set CMDIR = "C:\Program Files\Itemfield\ContentMaster"
Unix example:
CMDIR=/usr/local/Itemfield/ContentMaster
Windows example:
set CDDHJars = %CROSSWORLDS%\DataHandlers\BIA_CwComplexDataHandler.jar; %CMDIR%\CMJava_API.jar
Unix example:
CDDHJars= ${CROSSWORLDS}\DataHandlers\BIA_CwComplexDataHandler.jar: ${CMDIR}\CMJava_API.jar
Windows example:
%CWJAVA% ... -Djava.library.path="%CMDIR%";... -cp "%CDDHJars%";...
Unix example:
exec ${CWJAVA} ... -Djava.library.path=${CMDIR}:... -cp ${CDDHJars}:...
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
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.
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.