Updating Workflow Data

Before you can update workflow data, you need to retrieve the Step Elements or Work Objects from a queue. See Querying for Step Elements or Work Objects for this information.

Note: Remember to lock the retrieved work item (by using VWStepElement.doLock(), for example).
Updates to workflow data include the following items:
  • Updating VWStepElement parameters (such as modifying the data fields, attachments, and workflow groups that are used as parameters for this workflow step)
  • Updating VWWorkObject objects (extracting and updating data field values)
  • Specifying comments

Step Element parameters are defined by using the Parameter tab in Process Designer (see Process Designer), and have the following characteristics:

Updating Parameters

Use VWStepElement.getParameterValue() and VWStepElement.setParameterValue() to retrieve and update parameter values. For more information, see VWStepElement.

Updating Data Field Values

Use VWWorkObject.getFieldValue(), VWWorkObject.hasFieldName(), and VWWorkObject.setFieldValue() to retrieve work objects from a queue, extract, and update a data field value. For more information, see VWWorkObject.

Setting Comments

You can specify comments by using either VWStepElement.setComment(), or the VWWorkObject F_Comment field for VWWorkObject.hasFieldValue() and VWWorkObject.setFieldValue().