Transports and Interfaces: Siebel eBusiness Application Integration Volume III > 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.

Checklist

q

Set up the EAI MSMQ Transport and set up queue to send messages.

For details, see Configuring EAI MSMQ Transport for Various Send and Receive Scenarios.

q

Set up the organization, port, and channel (collectively known as BizTalk configuration objects) for use with the EAI MSMQ Transport.

For details, see Setting Up an MSMQ Queue for Sending Messages.

q

Create the workflow to process outbound documents from Siebel applications using EAI MSMQ Transport.

For details, see Sending Outbound Messages with 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

  1. On the BizTalk Server machine, access the BizTalk Messaging Manager.
  2. 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.

  3. Create a new organization and name it appropriately. For example, if your trading partner is Oracle, enter Oracle.
  4. 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.
  5. Create a messaging port to your trading partner.
    1. In the Destination Organization window, select an organization, such as Oracle.
    2. Click Browse under Primary Transport.
    3. Select the appropriate transport for your trading partner.
    4. Complete the remaining pages as needed and click Finish to complete.
  6. Create a new channel for the port created Step 5.
    1. Create a new channel "From an Application" such as, Siebel To Oracle Channel. Click Next.
    2. Select the appropriate inbound document definition, such as Siebel Order.
    3. Select the appropriate outbound document definition for your trading partner, such as Oracle Order.
    4. Select an appropriate map, if necessary.
    5. Complete other pages as required and select Finish to complete.
  7. 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

  1. From the Site Map choose Administration - Business Process > Workflow Processes.
  2. Create a new workflow process as shown below to send a message to BizTalk.

    NOTE:  For information on how to set up Siebel Workflow, see Siebel Business Process Designer Administration Guide.

  3. Set up the process properties for your workflow as follows:
    Name
    Data Type
    Value

    OrderMessage

    Hierarchy

    -

    <Value>

    String

    -

    Object Id

    String

    record # for an order

  4. 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:
    Input Arguments
    Type
    Value
    Property Name
    Process Property Type

    Output Integration Object Name

    Literal

    Sample Order

    -

    -

    Object Id

    Process Property

    -

    Object Id

    String

    Property Name
    Type
    Value
    Output Argument

    OrderMessage

    Output Argument

    -

    Siebel Message

  5. 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:
    Input Arguments
    Type
    Value
    Property Name
    Property Data Type

    XML Character Encoding

    Literal

    UTF-16

    -

    -

    Siebel Message

    Process Property

    -

    Order Message

    Hierarchy

    Property Name
    Type
    Value
    Output Argument

    <Value>

    Output Argument

    -

    XML Document

  6. Set up the last step to use EAI MSMQ Transport with the Send method and the following input arguments:
    Input Arguments
    Type
    Value
    Property Name
    Process Property Type

    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.

  7. Save your workflow process and test it using Workflow Process Simulator.

    NOTE:  For details on setting up and using Siebel EAI MSMQ Transport, see EAI MSMQ Transport.

Transports and Interfaces: Siebel eBusiness Application Integration Volume III