Update item properties

Tags: not added yet

Update item properties

This workflow action is the successor of the old Fields to update (Self) in Workflow Transitions.

The only custom parameter are the Fields to update:

[!UpdateItemProperties.png!]

The field selector will show all updatable fields of the tracker item, that is source/subject of the triggering event.

For each selected field, you can choose, whether to

Set or
Clear

the value of this field.

Depending on the field type, there are also additional type specific operations.

Text and Wiki fields also support to

Prepend or
Append

a value to the existing value (with an optional separator).

Numeric and Duration fields also support to

Increment or
Decrement

the existing value by the specified value.
In other words Add or Substract the specified value to/from the existing field value.

Multiple Choice fields also support to

Add
Remove

the specified value(s) to/from the existing field value(s), or to

Retain

only those existing field values that are contained in the specified (collection of) values.
In other words, removes those existing values, that are not contained in the specified (collection of) values.

The value(s) to apply can be

(a constant) Value, that you can enter/select via the appropriate value editor, or
the Result of evaluating an expression, that computes/calculates the value (see Computed Fields).

For example: Compute the new value for End Date by shifting the existing End Date 3 hours into the future.

[!ComputedEndDateUpdate.png!]

To Edit a field to update, you can:

Click the field value you want to change/edit.
Click on the small pencil behind the field value you want to change/edit.

To Remove a field to update:

Click on the x icon after the name of the field you want to remove.

Please make sure, that you have committed all open field value editors with OK, before you save the action, otherwise the uncommitted editor values will get lost.

In CB-7.9.2 and newer, you can also apply multiple value update operations on parameters and fields, that allow multiple values.

For example:

Assign the item to all Owners, except those having role Tester
- Assigned to: Set to content of Owner, Remove Tester
Assign the item to all Owners, plus user bond
- Assigned to: Set to content of Owner, Add bond
Remove all assignees in role Developer and newly assign users in role Tester
- Assigned to: Remove Developer, Add Tester

There can be also constellations with three or more operations, e.g.

Assign the item to all Owners, that have the role Administrator, except members of group System Admin
- Assigned to: Set to content of Owner, Retain Administrator, Remove System Admin

To add additional field value update operations, click on the More... button of the field update editor.

[!MultipleFieldUpdateOps.png!]

To Remove additional field value update operations:

Click on the x icon of the field value update operation, you want to remove.

Because the order of operations is significant, you can re-order additional field value update operations via drag-and-drop (in edit mode).

[!ReMoveFieldValueOps.png!]