Setting URL templates

Use the URL Templates window to specify the launch and step processor templates for each web application in the workflow system or isolated region.

About this task

The system uses the templates to build the URL for the launch and step processors.

Procedure

To configure a URL template for a launch processor or step processor for a web application:

Select the workflow system or isolated region you want to modify and click Properties on the toolbar.
Select the Web Applications tab. Note the ID number of the web application you are specifying for a launch processor or step processor.
Click the Advanced icon on the window toolbar.
To add a URL template, click New. Enter an ID number in the Web Application field. The ID for a custom web application must be a number 100 - 999, inclusive.
Important: To open HTML step processors or allow the custom step processors to be opened from another web application, the ID number you enter must have a corresponding web application ID number in the web application properties.
Enter the Template by using the appropriate format as explained in the following table.
Click OK to return to the main workflow system or isolated region properties window.

Results

The launch step processor URL template uses the format in the following table. Numbers 100 and 199 indicate custom web applications.

Table 1. URL template formats for the listed web applications
Web application	Template
FileNet® Collaboration Services	{0}/eprocess/launchers/{1}?workflowVersion={2}&subject={3}&attachmentId={4}&propertyMap={5}
Enterprise Records	{0}/eprocess/launchers/{1}?workflowVersion={2}&subject={3}&attachmentId={4}&propertyMap={5}
IBM® Content Navigator	{0}/{1}?workflowVersion={2}&subject={3}&attachmentId={4}&propertyMap={5}&isoRegion={6}
IBM Case Manager	{0}/?{1}&queueName={2}&wobNum={3}
100	{0}/eprocess/launchers/{1}?workflowVersion={2}&subject={3}&attachmentId={4}
199	{0}/myLaunchers/{1}?workflowVersion

Where each parameter number represents the following information:

Table 2. Parameter values and description for the templates in Table 1.
Parameter	Description
{0}	Server base URL
{1}	Launch step processor location
{2}	Workflow version (F_WCRevision) or workflow name
{3}	Subject (optional)
{4}	Attachment document ID (optional)
{5}	Property map (optional)
{6}	Isolated region number (required by IBM Content Navigator)

Example

For example, for the following settings:

server base URL: http://10.15.4.54:8080/MyWebApp
Location: myLaunchProcessor.jsp
URL template: {0}/myLaunchers/{1}?workflowVersion={2}&subject={3}&attachmentId={4}

At run time, the link for the launch processor is as follows:

 http://10.15.4.54:8080/MyWebApp/myLaunchers/myLaunchProcessor.jsp?workflowVersion=%7E%7E1%09...
&subject=Loan%20Application&attachmentId=

The step processor URL template uses the format in the following table:

Table 3. Step processor URL templates for the listed web applications
Web application	Template
FileNet Collaboration Services	{0}/eprocess/stepprocs/{1}?queueName={2}&wobNum={3}&stepName={4}
Enterprise Records	{0}/eprocess/stepprocs/{1}?queueName={2}&wobNum={3}&stepName={4}
IBM Content Navigator	{0}/{1}?queueName={2}&wobNum={3}&stepName={4}&isoRegion={5}
IBM Case Manager	{0}/?{1}&queueName={2}&wobNum={3}
100	{0}/eprocess/stepprocs/{1}?queueName={2}&wobNum={3}&stepName={4}
199	{0}/myApps/myStepprocs/{1}?queueName={2}&wobNum={3}&stepName={4}

Where each parameter number represents the following information:

Table 4. Parameter values for the templates in Table 3.
Parameter	Description
{0}	Server base URL
{1}	Step processor location
{2}	Queue name
{3}	Work item number
{4}	Step name (optional)
{5}	Isolated region number (required by IBM Content Navigator)

For example, for the following settings:

Server base URL: http://10.15.4.54:8080/MyWebApp
Location: myStep.jsp
URL template: {0}myStepprocs/{1}?queueName={2}&wobName={3}&stepName={4}

The link for the step processor is as follows:

 http://10.15.4.54:8080/MyWebApp/myStepprocs/myStep.jsp?queueName=Inbox&wobNum=C6F344A9D1....&stepName=Loan%20Eval

To delete the URL template for a custom web application, select the row and click Delete. To delete the URL template for a non-custom web application, delete the information in the Template field.