Send JMS Message

sendjmsmessage 12/02/2008,03:35 26.73 Kb

Description:

This use case illustrates functionality of sending JMS message.
The process has been implemented by creating a wsdl that performs send operation, and invoking this wsdl in Intalio process.
The WSDL file "SendJMSContract.wsdl" is generated from "Web Logic 8.1" Application Server which consists "sendJMSMessage" as its Operation name. The process accepts the "StringQueueJNDI", "StringHost" and "StringMessage" as its input parameters and keeps them in a Queue and generates the output as whether the message has been sent successfully or not.
In the Input parameters, 'StringQueueJNDI' specifies the JNDI name which is created in web logic console, 'String Host' specifies the name of the host ie "where the Web Logic Server is located" and "StringMessage" is any valid text message that we need to store in the Queue.

Use case dependencies"

sendjms.xsd: Schema used is of "complex" type.

Requirements:

1. Intalio|BPMS Server-5.1.1.
2. Intalio|BPMS Designer-5.1.1.
3. BEA-Web Logic 8.1 SP2

Process Download & Import

1. Download 'SendJMSMessage.zip'.
2. Go to File > Import...
3. Select 'Existing Projects into Workspace', in the wizard, click on Next >.
4. Select "Select archive file" radio button.
5. Browse to select the downloaded archive file & Click on Finish.
6. Update project builders by right click on project; go to BPMS Designer Tools > Update BPMS Builders.

Web Logic Configurations:

1. Make sure WebLogic Server is running successfully.

2. Open a web browser, provide url as: http://localhost:7001/console, that takes you to WebLogic Server Administration Console page.

3. Login with the following credentials:
   username: 'weblogic' (without quotes).
   password: 'weblogic' (without quotes).

4. Expand "workshop > Services> JMS >Servers” in left pane and click on it.

5. In right side panel, click on "Configure new JMS Server".

6. In "General" tab, provide "Name" as "JMSTest" and click to "create".

7. Select "Target" as "cgServer" under "Target and Deploy" tab and click to "Apply".
   Note: New JMSTest" will be created with "Destinations" and "Session Pools" as its sub nodes under "JMS > Servers" in left panel of console.

8. Click on "Destinations" given under JMSTest" in the left panel.
   Note: In the right side, window refreshes and displays with configuration options.

9. Click on "Configure a new JMS Queue".

10. In "General" tab, provide Name as "New.JMS" and JNDI Name as "jws.test" respectively then click to "Create".
    Note: New JMS Queue name displays under "Destinations" in left panel.

11. Click to Logout from console.

Work Scenario in WebLogic:

1. Open WebLogic Workshop 8.1.

2. Right click on "SamplesApp" under Application tab, go to New >, select “Project”.

3. Select "Web Service Project" and provide project name as "send_jms" then click on “Create”.
   Note: New project with name "send_jms" displays under "SamplesApp" which includes "WEB-INF" folder also.

4. Right click on "send_jms", go to New > select “Web Service”.

5. Provide File_name as "SendJMS" and click to "Create".

6. Instantly window with name as "SendJMS" having two tabs "Design View" and "Source View" is available.

7. Click on “Source view” tab and paste code from "SendJMS.jws" file attached within the zip file into SendJMS.jws being created by you.

8. Repeat 4-7 steps, but provide file name as "QueueJMS.jws" and for the code please check for "QueueJMS.jws" file attached within the zip file and paste this code into QueueJMS.jws being created by you.

9. Save the jws files.

10. Right click on project “send_jms”, select "Build send_jms" to build project.

11. Right click on "SendJMS.jws" and click to "Generate WSDL file".

12. Open the generated "SendJMSContract.wsdl" wsdl file.

13. Go to File >Save As, save the WSDL file as "SendJMSContract.wsdl" in any of your folder.
    

Please follow these below instructions to remake the process.

Preconditions:

1. Make sure Intalio|BPMS Server is up and running fine.

2. Make sure the Process Explorer pane does not contain any Intalio|BPMS Business Process Project with same name.

Steps to remake the process:

1. Go to File > New > select "Intalio|BPMS Business Process Project".

2. Give Project name as "SendJMSMessage", click on Finish.

3. Import wsdl file "SendJMSContract.wsdl" from zip file attached, directly under "Send_JMSMessage" project.

4. Right click on the project; go to New > select "Business Process Diagram".

5. Provide diagram name as "Send_JMSMessage", and click on Finish.

6. A pool with a task is available in BPMN Editor Pane, name default pool as “Client” and task as “send”.

7. Right click on client pool and select "Set pool non executable".

8. Add new pool by click on BPMN Editor (select "Add Pool" option from pop up menu) and name it as "SendJMSMessage".

9. Focus on “send” task in Client pool, drag the out going message icon from boundary and release mouse control onto SendJMSMessage pool to select the option "Connect to a new Message Start Event".

10. Focus on Message Start Event, drag sequence flow icon from boundary and select option to "Connect to a new Task", name the task as "invoke".

11. Focus on “invoke” task, drag sequence flow icon from boundary and select option to "Connect to a new Message End Event".

12. Drag the outgoing message icon from Message End Event and connect to "send" task in the Client Pool.

13. Repeat step 8 & 7, but name the pool as "SendJMSMessageWSDL".

14. Drag and drop "sendJMSMessage" operation onto SendJMSMessageWsdl pool (Go to Process Explorer > SendJMSContract.wsdl > SendJMS > SendJMSSoap).

15. Focus on invoke task in SendJMSMessage pool, drag the outgoing message icon from "invoke" task and connect to "sendJMSMessage" task in SendJMSMessageWsdl pool, similarly create connection in vice versa direction.

16. Import schema files from zip file into the project (You can also create your own schema from File > New > Other > XML > XML Schema).

17. Drag and drop sendjms.xsd > tns:objQueueJMS schema node on to incoming message flow from "send" task to message start event.

18. A message "Set schema element 'objQueueJMS' as the content of the message" will prompt you, click on it.

Defining Outgoing Mapping:

1. Make sure Mapper view is visible (go to Windows > Show View > Mapper).

2. In the process model select "invoke" task.

3. Click on "$thisEventStartMessageRequest.body" > StringQueueJNDI node in left side of mapper and then click on "$opeSendJMSMessageRequest.parameters" > objQueueJMS[?] >StringQueueJNDI node in right side of mapper which will make an association.

4. Similarly form associations between other nodes, i.e. "StringHost" & "StringMessage".

5. Select Message End Event in process model.

6. Click on "$opeSendJMSMessageResponse.parameters" node in left side of mapper and then click on "$thisEventStartMessageResponse.body" node in right side of mapper which will make an association.

7. Save the process model.

8. Now your process is fully implemented which is ready to deploy and execute within Intalio|BPMS Server.

Process Deployment & Execution:

1. Click on Deploy Project to Intalio|BPMS Server button in tool bar.

2. Make sure you select all runtime files while exporting to Intalio|BPMS Server.

3. Click on Finish button.

4. Open a web browser, provide url as: http://localhost:8080/bpms-console which takes to login screen for bpms-console.

5. Login with the following credentials:
   username: 'admin' (without quotes).
   password: 'changeit' (without quotes).

6. In the processes list you should see "Send JMSMessage:Send JMSMessage" process with a package name

7. "SendJMSMessage", select it and click to Start.

8. This should generate a form with label "EventStartMessageRequest", three input fields to map three input data.

9. Type 'jws.test' in StringQueueJNDI field, 'localhost' in StringHost field and 'hello jms' in StringMessage field then click to Submit.

10. This will replace the page with an output like :

11. EventStartMessageResponse:

12. sendJMSMessageResult: Message sent sucessfully hello jms