Polarion offers a built-in Work Item workflow function LinkedWorkItemsStatusChange that can change the status of linked Work Items. However, this workflow function directly changes the Work Item status and does not perform the workflow actions. Consequently, the configured workflow conditions are not checked and workflow functions are not executed.
In contrast to that, the ExecuteLinkedWorkItemsAction Work Item workflow function lets you configure the workflow actions of linked Work Items that shall be executed on a status change.
The parameters are:
| Parameter | Description |
|---|---|
| action.id | The ID of the action that shall be performed for the status change. If the action is generally available from the origin to the target status but blocked due to some conditions, a UserFriendlyException is thrown and the action is canceled. |
| link.roles.direct | Comma-separated list of outgoing link roles to check. Either direct or back needs to be specified. |
| link.roles.back | Comma-separated list of incoming link roles to check. Either direct or back needs to be specified. |
| origin.states | Comma-separated list of origin states of the linked Work Items for which the action shall be performed. |
| origin.negate | Optional: If the parameter is set to true, the origin.states are not included but excluded. (default: false) |
| target.state | The single target state to which the linked Work Item shall transition. |
| workitem.type.ids | Optional: Comma-separated list of Work Item type IDs. The action shall only be executed for these types. |
| follow.links | Optional: If the parameter is set to true, the workflow action is executed not only for the directly linked Work Items, but also for their linked Work Items, and so on. (default: false) Linked Work Item loops are caught and result in a UserFriendlyException and the action is canceled. |