Transports and Interfaces: Siebel Enterprise Application Integration > Interfacing with Microsoft BizTalk Server > Connecting to BizTalk Using EAI MSMQ Transport >
Using EAI MSMQ Transport for Outbound Messaging
This section describes how to use the Siebel BizTalk interface to send an XML document to BizTalk Server using the EAI MSMQ Transport.
Setting Up an MSMQ Queue for Sending Messages
Set up an MSMQ transactional queue to receive messages from the Siebel application. You should name the queue an easy-to-identify name, such as fromSiebel. For details, see EAI MSMQ Transport and the Microsoft MSMQ documentation. To set up BizTalk configuration objects for MSMQ Outbound
- On the BizTalk Server machine, access the BizTalk Messaging Manager.
- Set up your home organization as Siebel and set up applications for the home organization.
NOTE: For each BizTalk-specific step, see Microsoft BizTalk Server documentation for the details.
- Create a new organization and name it appropriately. For example, if your trading partner is Oracle, enter Oracle.
- Create a document definition for the previously created document specification from WebDAV and name it, for example, Siebel Order. See To import schema into BizTalk Server to save it as a BizTalk document specification.
- Create a messaging port to your trading partner.
- In the Destination Organization window, select an organization, such as Oracle.
- Click Browse under Primary Transport.
- Select the appropriate transport for your trading partner.
- Complete the remaining pages as needed and click Finish to complete.
- Create a new channel for the port created Step 5.
- Create a new channel From an Application such as, Siebel To Oracle Channel.
- Click Next.
- Select the appropriate inbound document definition, such as Siebel Order.
- Select the appropriate outbound document definition for your trading partner, such as Oracle Order.
- Select an appropriate map, if necessary.
- Complete other pages as required and select Finish to complete.
- Create a Message Queuing Receive Function in the BizTalk Server Administration (for example, Siebel MSMQ Receive) to specify the queue (for example, fromSiebel) that the receive function polls. This queue is the same queue that Siebel uses to send the message using EAI MSMQ Transport.
To create the Siebel workflow for MSMQ Outbound
- From the Site Map choose Administration - Business Process > Workflow Processes.
- Create a new workflow process as shown below to send a message to BizTalk.
NOTE: For information on creating workflow processes, see the Siebel Business Process Designer Administration Guide.
- Set up the process properties for your workflow as follows:
|
|
|
OrderMessage |
Hierarchy |
- |
<Value> |
String |
- |
Object Id |
String |
record # for an order
|
- Set up the first step after Start to use the EAI Siebel Adapter with the Query method to query the order from Siebel Database, using the following input and output arguments:
|
|
|
|
|
Output Integration Object Name |
Literal |
Sample Order |
- |
- |
Object Id |
Process Property |
- |
Object Id |
String |
|
|
|
|
OrderMessage |
Output Argument |
- |
Siebel Message |
- Set up the second step to use the EAI XML Converter with the Integration Object Hierarchy to XML Document method and the following input and output arguments to convert the order object to an XML document:
|
|
|
|
|
XML Character Encoding |
Literal |
UTF-16 |
- |
- |
Siebel Message |
Process Property |
- |
Order Message |
Hierarchy |
|
|
|
|
<Value> |
Output Argument |
- |
XML Document |
- Set up the last step to use EAI MSMQ Transport with the Send method and the following input arguments:
|
|
|
|
|
MsmqPhysicalQueueName |
Literal |
private$\name of the queue |
- |
- |
MsmqQueueMachineName |
Literal |
Machine Name that owns the MSMQ queue |
- |
- |
LargeMessageSupport |
Literal |
False |
- |
- |
Message Text |
Process Property |
- |
<Value> |
String |
NOTE: XML documents must be sent in UTF-16 format for BizTalk Server to parse. In order for message queuing to work properly with BizTalk, you should disable large message support as shown above.
- Save your workflow process and test it using Workflow Simulator.
NOTE: For details on setting up and using Siebel EAI MSMQ Transport, see EAI MSMQ Transport.
|