Adapter for JMS 6.1 SP1 | webMethods Adapter for JMS Documentation | webMethods Adapter for JMS Installation and User’s Documentation | Adapter Services | Configuring Document-to-Message Conversion Services
 
Configuring Document-to-Message Conversion Services
 
Using Document-to-Message Conversion Services
The Adapter for JMS provides services that enable you to convert Integration Server documents into JMS Messages. You use these services in combination with the MessageProducer and MessageRequestor adapter services.
*To configure a document-to-message conversion service
1. Review the steps in Before Configuring or Managing Adapter Services.
2. Start Designer.
Note:
Make sure the server with which you want to use Designer is running.
3. Right-click the package in which the service should be contained and select New > Adapter Service.
4. Select the parent namespace and type a name for the adapter service. Click Next.
5. Select Adapter for JMS as the adapter type and click Next.
6. Select the appropriate Adapter Connection Name and click Next.
7. Select one of the following templates, depending on the type of message to which you want to convert:
*DocumentToTextMessage
*DocumentToObjectMessage
*DocumentToMapMessage
*DocumentToBytesMessage
*DocumentToStreamMessage
8. Click Finish.
The service is created and its parameters and controls are displayed in the adapter service editor. You can select the Adapter Settings tab at any time to confirm adapter service properties such as the Adapter Name, Adapter Connection Name, and Adapter Service Template, as necessary.
9. Select the service's message tab to confirm or define the message body name, as follows:
*For the DocumentToTextMessage service template, select the Text Message tab to confirm that the Body Field Name is called TextMessageBody. Do not change the name of this field. This field appears in the service's input signature. You map the message data to this parameter.
*For the DocumentToObjectMessage service template, select the Object Message tab to confirm that the Body Field Name is called ObjectMessageBody. Do not change the name of this field. This field appears in the service's input signature. You map the message object to this parameter.
*For the DocumentToMapMessage service template, select the Map Message tab to define the message body.
*To define new field names, select the icon.
*To change the order of the fields, use the or icons.
*To delete any field names, use the icon.
Provide values for the rows as follows:
Parameter
Description/Action
Body Field Name
The name of the JMS message body field.
Body Field Type
The data type of the JMS Message body field. Select the data type from the list of available data types.
InputFieldType
The Java data type of Body Field Name. Select the data type from the list of available data types.
InputField Name
The name of the input field.
10. Select the JMS Header tab to configure the JMS Message Header fields that you want the JMS message to contain. Refer to the JMS specification for the JMS Header fields that can be set by a producer. If you are not using JMS Header fields, skip this step.
*To define new Message Header parameters, select the icon.
*To change the order of the fields, use the or icons.
*To delete any field names, use the icon.
Provide values for the rows as follows:
Parameter
Description/Action
Header Field Name
The name of the JMS message header field.
Header Field Type
The data type of the JMS Message header field. Select the data type from the list of available data types.
Input Field Type
The Java type of the Input Field Name. Select the data type from the list of available data types.
Input Field Name
The name of the input field.
11. Select the JMS Properties tab to configure the JMS message property fields that you want the JMS message to contain. If you are not using JMS property fields, skip this step.
*To define new JMS message property fields, select the icon.
*To change the order of the fields, use the or icons.
*To delete any field names, use the icon.
Provide values for the rows as follows:
Parameter
Description/Action
Property Field Name
The name of the JMS message property field.
Property Field Type
The data type of the JMS message property field. Select the data type from the list of available data types.
Input Field Type
The Java data type of the Input Field Name. Select the data type from the list of available data types.
Input Field Name
The name of the input property field.
12. For information about configuring the Input/Output, Settings, Audit, Permissions, and Results tabs, see the webMethods Service Development Help for your release.
13. Select File > Save.