The instance_name.xml configuration file lists all possible message mappers, and includes their name, class, device format, whether they are available, and specific configuration parameters. To locate the parameters for a certain message mapper, find the component of the instance_name.xml file with the name MessageMapperGroup.Since each message mapper may have different configuration parameters, each has a node of XML configuration information within the MessageMapperGroup component. The only requirement for the format of the configuration parameters node is that the parameters must be name-value-pairs. This allows the message mapper configuration parameters to be easily converted to a TypeProperty object.
The following lists the parameters for each individual message mapper:
- name: the name of the message mapper. This name will be used by the command which is expecting to parse a message with only this message mapper.
- class: the class name that contains the implementation of the message mapper interface.
- messageMapperId: the ID for the message mapper. Each message mapper ID must be unique.
- enable: indicates whether the message mapper should be used and initialized or not. If this value is set to "true", the message mapper is initialized at the startup of the instance and is available. If this value is set to "false", the message mapper is disabled.
- EcInboundMessageDtdFiles: the list of DTD files which are used to parse an inbound XML message.
- EcInboundMessageDtdPath: the file location where the DTD files listed in EcInboundMessageDtdFiles can be found.
- EcSystemTemplateFile: the system template file that ships with WebSphere Commerce. Users will typically set it "" if it is a customized message mapper.
- EcTemplatePath: the location where the system template file can be found.
- isValidating: the XML parser shipped with WebSphere Commerce has a feature (enabled by default) to validate an inbound XML message with its corresponding DTD or not. To disable it, enter "false".
- EcTemplatePath: the location where the user-defined message template file can be found.
- EcUserTemplateFile: the file name of the user- defined message template file.