Displaying a Case Object in a User Task - Using a Pageflow

You can display a case object as part of a pageflow that is displayed when a user performs a user task. If the user updates data for the case object, you will need to manually update this data in a subsequent process step.

Prerequisites

An already populated data field must exist in the business process, containing a case reference to the case object that you want to display.

Procedure

  1. Select the user task from which the form will be displayed.
  2. On the Interface tab of the Properties view, make sure that the appropriate Case Reference data field is included in the Parameters list, either explicitly or as part of the [All Process Data] setting.
  3. On the General tab of the Properties view, click Pageflow, select the pageflow process that you want to use, then click Open PageFlow.

    Make sure that the pageflow process contains the Case Reference data field as a formal Parameter.

  4. Create a new data field, of type BOM Type, which references the appropriate case class.
  5. Add a script task that uses the read method available on the case reference to read the associated case object data and assign it to the local business object.

    For example, the following script reads the data from the case object referenced by custRef and assigns it to the cust local business object:

    data.cust = bpm.caseData.read(data.custRef);

    This creates a local business object that contains a copy of the case object and is scoped to the pageflow process.

  6. Add a user task that displays the local business object in a form, allowing the user to view or update the local business object as required.
    Association and aggregation relationships in the case object are ignored when the form is generated.
  7. If necessary, add a service task (and, optionally, appropriate error handling) to update the case object with the changes to the local business object - see Updating a Case Object from a ServiceTask.