check and execute
workflow pending activities [since 2.0]

Authorized user can create a workflow instance called process: when a workflow is launched, the workflow instance (the process) and all the constituent activity instances are automatically created. Based on the rules defined in the process definition, the workflow system routes the step to the next step performer(s), until the workflow is completed.
A process can be generated from a workflow definition when a object event occours or alternatively in a programmatically way by executing a OOQL command (or with a API method of Process class).

process start  <Workflow_Name> 
            [ startdate <DateTime> ]
            [ holder AdminName ]
            [ primaryobject ObjectIdName ]
            { object ObjectIdName }
            [ params <Param_Name> = <Param_Value> { <Param_Name> = <Param_Value> } ]
            [ logfile <File_Name> ] ;

In the starting command you can specify:

Only valid workflows can be executed, so its very important to check the workflow definition.

Administration users can also startup a new process from the Context Design tree view: right click on a workflow and select the "Start Process.." option.

When a process starts, it inherits the workflow global parameters; additional parameters can be added in the "Parameters" panel:

A workflow is usually represented by a mix of system activities and user activities; while the system tasks are executed automatically when the workflow reaches the related steps, the user tasks assume the "wait" status and need a user action to be completed.
The execution of user actions are reserved for the users, the members of teams or for users associated with assignments specified in the workflow-step properties. All users that satisfy one of these conditions will be able to see the waiting task listed into their activity dashboard.

For example, in the Domain Object Manipulation client you can see the pending activities for the logged user by selecting the User/Activities menu-item.

If you select an activity and click on "Complete" button it is possible to complete your action or make your decision:

Applications where workflows are employed should implement a custom dashboard by listing the user activities with the following framework OOQL command :

famework activity list [get Process_GetStepBasicOption] ;

As usual, you can specify the information to extract for each process-step in the optional "get" clause, in paticular, the command href-link to the web or desktop client page by which the user can perform the related actions.

After completed the manual activities, a trigger or any other program should notify to the system to update the step status. This action can be performed by OOQL command or with a API method of Process class:


process update <Process_ID> step <Step_Name>
            [status ( completed | error | skipped | expired ) ]
            [percentage <Value>]
            [holder <User Name>]
            [startdate <DateTime>]
            [expiredate <DateTime>]
            [params <Param_Name> = <Param_Value> { <Param_Name> = <Param_Value> }]
            [object ( add | remove ) <Object ID/CNR> { ( add | remove ) <Object ID/CNR>}]
            [execute ( add | remove ) <Actor>{ ( add | remove ) <Actor>}]
            [to ( add | remove ) <Actor>{ ( add | remove ) <Actor>}]
            [cc ( add | remove ) <Actor>{ ( add | remove ) <Actor>}]
            [bcc ( add | remove ) <Actor>{ ( add | remove ) <Actor>}];

You can get the processes where the object is a primary object (A) and where the object is only involved during the execution (B):

Examples: 

(A) ooql: object show #00001-5779CCD9 get process ;
     SDK: Vector vProcess = object.getProcesses();
 
(B) ooql: object show #00001-5779CCD9 get otherprocess ;
     SDK: Vector vOtherProcess = object.getOtherProcesses();

If an object is destroyed, all processes where it is the primary object will be terminated.