When an end user (workflow participant or tracker) opens a step assignment (e.g., selects a step assignment from the User Tasks Page), a pop-up window containing the Step Processor user interface page opens in the browser. In developing a custom Process application, it is important to understand how the correct Step Processor (among a number of applications, Step Processors, or Work Performers that may be available) is selected, as well as how the URL for the Step Processor user interface is supplied for the web application (for example, for Workplace).
This topic describes the algorithm used to open a Step Processor and how the URL for the Step Processor is supplied. Subtopics include:
Note Information used for the algorithm and the URL is provided by a VWAttributeInfo API object. For information on the VWAttributeInfo API, see the Process API JavaDoc reference documentation.
The algorithm used for opening a Step Processor is as follows:
Note This algorithm assumes that the Step Processor has been deployed, registered, and added to the workflow. For information, see Deploying Java Applications (Step Processors) and Adding a Custom Processor to the Workflow.
When a Step Processor is launched, a corresponding URL is constructed (using the default URL template or your own URL template), as follows:
Note that the web server URL, the Step Processor JSP location, and the URL Template need to "match" (from the same web application).
{0} - WebServer URL (use current, if it is the same web application, use set
values if different)
{1} - location (use current if it is the same web application, use Step Processor
information values if different)
{2} - queue name (passed in)
{3} - work object number (passed in)
{4} - step name {passed in}
An example of a completed URL, using Workplace as the web application, .../mystep as the directory and step_main.jsp as the Step Processor's "View" JSP is as follows:
<http://<your _server>/Workplace/eprocess/stepprocs/java/mystep/step_main.jsp?queueName=Inbox&wobId=FA3454543AD231FDD3453&stepName=Test