- 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 will convert 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 will query 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 will convert 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: The Siebel Server needs to be restarted for the new subsystem to be available.
Following is an example using SrvrMgr:
NOTE: ConnectionFactory, ReceiveQueue and SendQueue require JNDI names, which will vary 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 defined as previously defined (JMS Query Order):
NOTE: The Siebel Server must be restarted in order for the data handling subsystem to be available.
create named subsystem QueryOrder for subsystem EAITransportDataHandlingSubsys with DispatchWorkflowProcess="JMS Query Order"
- 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 will query 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>