composeurl 02/01/2009,07:06 15.91 Kb

Summary:

This use case demonstrates how to create a URL by fetching different parameters from different fields and using 'compose-Url' function to combine values of different fields to form a URL.

Use case dependencies :

message.xsd: Schema used is "start" of "Complex" type which  has 3 child elements 'template','name','value' of type 'String'.

Requirements :

1.Intalio BPMS Designer 5.2
2.Intalio BPMS Server 5.2

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.

Process Download & Import :

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

Steps to remake process :

1.Go to "File > New > select "Intalio|BPMS Business Process Project".
2.Provide project name as "ComposeURL", click to finish.
Note: Make sure project with same name does not exist in the Process Explorer”.
3.Right click on the project; go to New > "Business Process Diagram".
4.Provide File name as "ComposeURL", and click to finish.
5.A pool with a task is available in BPMN Editor Pane, name default pool as 'Client' and task as 'send'.
6.Right click on client pool and select "Set pool non executable".
Note: If you save the process without making pool as non-executable, designer displays an error: The first task of an executable pool must receive a message.
7.Add new pool by click on BPMN Editor (select "Add Pool" option from pop up menu) and name it as "Server".
8.Focus on send task; drag out going message flow icon to "Server" pool and select the option "Connect to a new Task", name this new task as "receive".
9.Focus on the receive task and drag the outgoing sequence flow icon to "Connect to a new Task", name this new task as "reply".
10.Focus on reply task and drag the out going message icon from boundary and connect to "send" task in the Client Pool.
11.Drag and Drop  'start'  schema from 'message.xsd' to flow message from send to receive task.
12.Save the process model.

Defining Outgoing Mapping : 

1.Select the "reply" task.
2.Instantly Mapper displays with three frames, where:
Left frame (1st) reflects source side
Middle frame (2nd) reflects Mapper area
Right frame (3rd) reflects target side.
3.Go to Window > Show View > select Mapper Palette.
4.Drag Mapper Palette to location from where you can easily dnd any operator/function onto Mapper Area.
5.Go to Mapper Palette, expand Functions Apache ODE extensions and dnd " ode:composeUrl”  into Mapper Area.
6.Go to source side of mapper and expand "thisReceiveRequestMsg.body" node.
Note: template , name and value will be displayed.
7.Click on the 'Template' and move the mouse to the left edge of textbox displaying "ode:composeUrl" function available in mapper area.
Note: A connection link is established between the message variable node and Function.
8.Repeat the step 7 by selecting 'name' on the left side and connect it to "ode:composeUrl" function” in similar fashion.
9.Repeat the step 7 by selecting 'value' on the left side and connect it to "ode:composeUrl" function” in similar fashion.
10.Click on the right side of the function “ode:composeUrl' and connect it to '$thisReceiveResponseMsg.body' available on the right side of the mapper area
11.Save the process model

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.Open a web browser, provide url as: http://localhost:8080/bpms-console, which takes to login screen for bpms-console.
4.Login with following credentials:
username: 'admin' (without quotes)
password: 'changeit' (without quotes)
Note: bpms-console will be available with deployed processes list.
5.You should see "ComposeURL:server" process with a package name "ComposeURL", check the box under the project and click to Start.
6.Process Invocation window is visible that display 3 input text fields for template , name and value.
7.Input string “http:\\www.yahoo.com\{1}” in the template field, 'a' in the name filed and 'mail' in the value field.
Note -: Value provided in {} should be same as value provided in name field.
8.Click Submit button.
9.The Process Invocation window will display output like "ReceiveResponse: http:\\www.yahoo.com\mail".

Note: This sample is an example to educate user on:
1.How to use function 'ode.composeurl' to get values from different fields to form a URL.