HowTo: Modify the Process Instance Subject using the Workflow API

Unofficial Content
This documentation is valid for:

A very important property of the Process Instances is the Subject. The importance of this property lies in the fact that it is used in the different GXflow Client application components as an association mechanism. The subject allows giving a descriptive name to the Process Instance, making its followup easier for Workflow users. 

Example: suppose that in the ‘request’ transaction associated with the ‘manufacturing’ task you want to update the Process Instance subject with the request description. This can be done by inserting this line in the transaction rules:

&wfprocessinstance.Subject = RequestDescription on AfterValidate;


Where the variable data is

&wfprocessInstance 	– WorkflowProcessInstance


An example can be downloaded from here.

Steps to follow:

  1. Import the xpz file
  2. Run the business process diagram
  3. Once the Request Transaction is completed, suppose the description was: Request N°1 so the process instance subject changes as shown in this image: