- Set up a JMS queue to receive messages from the Siebel application and give the queue an easy to identify name, such as fromSiebel.
Refer to your JMS provider documentation on how to administer, monitor, and define new persistent queues.
- Set up a JMS queue to send messages to the Siebel application.
Refer to your JMS provider documentation on how to administer, monitor and define new persistent queues.
- Give the queue an easy-to-identify name such as toSiebel.
- Create a message in the queue.
NOTE: To test this scenario adequately, you must have a partner application that can place a valid message for the Siebel application into the queue.
- In Siebel Tools, set up a workflow to process the incoming XML request.
The following workflow receives the incoming XML document and converts it to an integration object, executes a query using Siebel Order application service, and converts the response to an XML document as shown in the following figure:
NOTE: For details on the Business Process Designer, see Siebel Business Process Framework: Workflow Guide.
- Create the following process properties:
|
|
|
|
|
<Value> |
Binary |
In/Out |
<Value> |
Order Integration Object |
Order Message |
Hierarchy |
In/Out |
Not applicable |
XML representation of the integration object |
- Set up the first step of the workflow, after Start, to use the EAI XML Converter with the XMLDocToIntObjHier method.
This step converts the incoming XML document to an integration object representation using the following input and output arguments:
|
|
|
<Value> |
Process Property |
<Value> |
|
|
|
Order Message |
Output Argument |
SiebelMessage |
- Set up the second step to use the Siebel Order ASI with the QueryByExample method.
This step queries the Order business object based upon the provided XML document using the following input and output arguments:
|
|
|
SiebelMessage |
Process Property |
Order Message |
|
|
|
Order Message |
Output Argument |
SiebelMessage |
- Set up the third step to use the EAI XML Converter with the IntObjHierToXMLDoc method.
This step converts the integration object to a well-formed XML document using the following input and output arguments:
|
|
|
SiebelMessage |
Process Property |
Order Message |
|
|
|
<Value> |
Output Argument |
<Value> |
- Save and deploy the workflow.
For details on deploying workflows, see Siebel Business Process Framework: Workflow Guide.
- Define a JMS Connection subsystem using SrvrMgr (command line utility) or the Server Administration screen.
NOTE: Restart the Siebel Server to make the new subsystem available.
Following is an example using SrvrMgr:
NOTE: ConnectionFactory, ReceiveQueue and SendQueue require JNDI names, which varies depending upon the JMS provider and your implementation.
create named subsystem JMSToFromSiebel for subsystem JMSSubsys with ConnectionFactory="jndiName.ConnectionFactory",
ReceiveQueue="jndiName.toSiebel ",
SendQueue="jndiName.fromSiebel",
ReceiveTimeout=3000
- Define a data handling subsystem to dispatch the message from the toSiebel queue to the workflow as previously defined (JMS Query Order):
create named subsystem QueryOrder for subsystem EAITransportDataHandlingSubsys with DispatchWorkflowProcess="JMS Query Order"
NOTE: The Siebel Server must be restarted in order for the data handling subsystem to be available.
- After restarting the Siebel Server, start a new JMS Receiver from the SrvrMgr command line.
The following is an example that instructs the receiver to use the JMSToFromSiebel connection subsystem defined in Step 9, the QueryOrder data handling subsystem defined in Step 10, and instructs the receiver to use the ReceiveDispatchSend method of the EAI JMS Transport:
start task for comp JMSReceiver with
ReceiverConnectionSubsystem= JMSToFromSiebel,
ReceiverDataHandlingSubsystem=QueryOrder,
ReceiverMethodName=ReceiveDispatchSend
- Place a message resembling the following on the toSiebel queue:
NOTE: A third-party product such as Hermes (available from Sourceforge.net) is required to place a message on a queue. In the following sample document, the Siebel Order ASI queries for all orders associated with the Hibbings Manufacturing account.
<?xml version="1.0" encoding="UTF-16"?>
<SiebelMessage IntObjectName="Order Interface">
<ListOfOrderInterface>
<Orders>
<Account>Hibbings Manufacturing</Account>
</Orders>
</ListOfOrderInterface>
</SiebelMessage>