You are not logged in. Click here to log in.

codeBeamer ALM

Search In Project

Search inClear

Tags:  not added yet

Update referring items

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

When you select this action from the action selector, you also have to select

  • the Relation between the tracker item, that is source/subject of the triggering event, and the items to update
  • the Project where to update items (only if there are possible target Trackers in other projects, than the current one)
  • the Tracker where to update items
  • the Status of the items to update

from the upcoming cascading menu.


There are basically two types of updating the referring items:

  • Upating items that is referred from the item ( outgoing references )
    Example for a Requirement type of field:
    Parent (Requirement) -> Requirements -> New
  • Updating items referring to the item ( incoming references ).
    Example for a Requirement type of field ( which can also be read as its children ) :
    Requirements for Parent -> Requirements -> New

In our example from Forking sub-processes from processes (work items), we choose to update Subject (Issues) with Status In Approval in the Tracker Processes (of the current project Workflow Demo:




The only custom parameter are the Fields to update:


The field selector will show all updatable fields of the selected target tracker items in the selected status.

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 Content of an assignment compatible field from the tracker item, that is source/subject of the triggering event, or
  • the Result of evaluating an expression (on the tracker item, that is source/subject of the triggering event), that computes/calculates the value (see Calculated Issue Fields).


For example:

  • Set the Status of the items to update to Approved and also
  • Add all Comments/Attachments (of the tracker item, that is source/subject of the triggering event) to the Comments/Attachments of the items to update.




To Edit a field to update, you can:

  • Double click the field value you want to change/edit.
  • Right click the field name and choose Edit from the context menu.

To Remove a field to update:

  • Right click the field name and choose Remove from the context menu.



Please make sure, that you have committed all open field value editors with OK, before you save the action, otherwise the uncommittededitor 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.




To Remove additional field value update operations:

  • Right click the field value update operation and choose Remove from the context menu.


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