Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 5 Working with Activities : Working with User Tasks and Pageflow Processes

Working with User Tasks and Pageflow Processes
In addition to creating a standalone pageflow process, you can do the following from a user task:
In the runtime environment, the pageflow process is run when the work item associated with the user task is opened.
When you right-click a user task, the Pageflow menu provides the following options:
Open  Select this option to open the associated pageflow process in the Process Editor (if a pageflow process has already been selected for the task).
Synchronize Parameters  Select this option if you have made changes to the parameters in the user task, and want the changes reflected in the corresponding parameters in the associated pageflow process (see Synchronizing Parameters With a Pageflow Process).
Generate  Select this option to generate a new pageflow process that will be associated with this user task. The parameters associated with the user task are replicated for the pageflow process.
Use Existing  Opens the Select Form dialog from which you can select an existing pageflow process.
Delete  Deletes the reference from the user task to the pageflow process. The pageflow process itself is not affected.
Selecting a Pageflow Process
If you have already created a pageflow process, you can select it from a user task as follows:
1.
2.
On the General tab for the user task, select the Pageflow option and click to display the Select Pageflow Process dialog.
Expand the projects to select a pageflow process and click OK.
Right-click the user task and select Pageflow > Use Existing to display the Select Pageflow Process dialog. Expand the projects to select a pageflow process and click OK.
3.
The Pageflow field is automatically completed with a URL that points to the pageflow process (relative to the Forms special folder). You can open the pageflow process by clicking Open Pageflow Process.
Creating a Pageflow Process From a User Task
To create a pageflow process that is associated with a user task, do the following:
1.
2.
Right-click and select Pageflow > Generate. The New Pageflow Process dialog is displayed.
3.
User Task Interface Data  Select from the process data specified on the Interface tab of the user task. If no explicit process data is selected on the Interface tab, all process data is available.
Other Available Process Data  Select from the process data that is not associated with the user task.
4.
Enter the Label of the process. If you want to use a template to create the process, select the template and click Finish to create the pageflow process or Next to specify additional options. Subsequent dialogs are the same as those described in Creating a Pageflow Process.
Synchronizing Parameters With a Pageflow Process
When a pageflow process is first generated from a user task, a dialog is displayed that allows you to create the pageflow process with its own set of parameters (either replicating the existing data fields and parameters of the user task, or a subset thereof). User tasks in the pageflow process can display forms that utilize these parameters.
If you add or remove new parameters to the user task in the parent process (after the pageflow process is generated), you can update the list of user task parameters that are known to the pageflow process as follows:
1.
Right click the user task, and select Pageflow > Synchronize Parameters. The Synchronize Pageflow Parameters With User Task dialog is displayed:
2.
Confirm the changes and click Finish. For example, if parameters have been added to the pageflow process but not the user task, synchronizing deletes them from the pageflow process. If parameters have been added to or removed from the user task, synchronizing adds or removes the corresponding parameters in the pageflow.
After synchronizing, the parameters in the Project Explorer listed for the pageflow process should be identical to the parameters listed for the parent process.
Mandatory Parameters and Pageflow Processes
When a pageflow process has a mandatory parameter, that parameter must have a value before the pageflow can be considered complete. This is different to sub-process parameters, where the mandatory flag controls whether mapping to the parameter is required or optional.
This means that a pageflow process and associated user task are expected to have the same data available. As a result, mandatory pageflow parameters are mandatory in all user task forms within the pageflow. However, if this is not the desired behavior, explicitly associate the parameter with the user task in the pageflow and de-select the mandatory flag.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved