Configuration and internationalization

The data handler is invoked from the adapter and requires configuration. This configuration includes locale-specific properties that define number and date format conversion. Within any adapter using the data handler, the DataHandlerMetaObjectName property must be defined. The value of this property is the name of the meta-business object that defines the appropriate data handlers for each MIME type. The meta-object specified for the text/xml type designates the WBIX XML data handler and its configuration options.

To configure these options, you must edit the business object MO_MRO_XMLConfiguration. Using the System Manager, you can edit the properties in the Business Object designer according to the following parameters. When you are finished, you must redeploy this object to the server.

The options are:

AppDateFormat
The date format that the data handler expects from the application and passes to the application. The default date format for the MRO adapter is yyyy.MM.dd hh:mm:SS z.

See the section Date formats for additional formatting details.

ICSDateFormat
The date format that the data handler expects from the integration broker and passes to the integration broker. The default date format for the MRO adapter is MM/dd/yyyy.

See the section Date formats for additional formatting details.

classname
Java class: com.ibm.wbix.datahandlers.XMLDataHandler

EnforceRequirements
Specifies whether to enforce requirements. If TRUE is specified, events containing required fields that contain no data are rejected by the data handler. If FALSE is specified, required fields that contain no data are accepted by the data handler.

UseDefaults
Boolean indicating whether GBOs should be populated with their default values. If the parameter does not exist within the meta object, the default behavior is to use defaults.

XmlEncoding
Specifies the encoding to use when producing XML from an ICS object. Valid encodings are as follows:

US-ASCII
Seven-bit ASCII, also referred to as ISO646-US or the Basic Latin block of the Unicode character set.

ISO-8859-1
ISO Latin Alphabet No. 1, also referred to as ISO-LATIN-1.

UTF-8
Eight-bit Unicode Transformation Format.

UTF-16BE
Sixteen-bit Unicode Transformation Format, big-endian byte order.

UTF-16LE
Sixteen-bit Unicode Transformation Format, little-endian byte order.

UTF-16
Sixteen-bit Unicode Transformation Format, byte order specified by a mandatory initial byte-order mark (either order accepted on input, big-endian used on output).

Date formats

The dates in the AppDateFormat and ICSDateFormat options are in the following format:

yyyy.MM.dd hh:mm:ss.SS z
   

yyyy
The year in four-digit format. For example, 2003.

MM
The month in two-digit format. For example, October is 09.

dd
The date in two-digit format. For example the eighteenth is 18.

hh
The hour in 24-hour format. For example, 11:00 p.m. is 23.

mm
The minutes.

ss
The seconds.

SS
Thousandths of a second.

z
The offset from Coordinated Universal Time (UTC) also called Z or Zulu.
Note:
The z is lower case.

For further details, see the Java(TM) 1.3.1 date format specification.

Copyright IBM Corp. 1997, 2003