Xurrent Help

Automation Rule Example 8

Assign Task to Correct Team Using an if-then-else Statement

For a ‘Move Desktop PC’ request, the coordinator of the team ‘End-user Support, New York’ must reassign the tasks assigned to his team, to the ‘End-user Support, Chicago’ team when the requester belongs to the Manufacturing organisation or to the ‘End-user Support, Boston’ team when the requester belongs to the Research & Development Center. An automation rule can be used to reassign these task.

The following sections describe how the workflow manager can define the key parts of this automation rule.
 

Trigger

Because the rule needs to be executed when the workflow and the tasks are created, the option ‘On create’ is selected in the Trigger field.
 

Expressions

The following expressions are defined for the rule so that they can subsequently be used to define the condition for the rule, as well as the actions that it needs to execute:

1. request

The expression request is used to look up the first request that is related to the workflow that the approval task belongs to. We need this request to retrieve the organisation of the Requester (this could be written in 1 expression, the advantage of writing it in 3 expressions is that all 3 values will be logged during rule execution which gives better insight). It is defined as follows:

  • workflow.requests[first]

2. requester

The expression requester is used to get the ‘Requested for’ user. This expression is defined as follows:

  • request.requested_for

3. organisation

The expression organisation is used to get the organisation of the ‘Requested for’ user. This expression is defined as follows:

  • requester.organization

4. old_team_name

The expression old_team_name is used to identify the actual team assignment of the task. This expression is defined as follows:

  • team.name

5. is_from_manuf

The expression is_from_manuf is used to check if the requester belongs to the Manufacturing organisation. This can be defined as follows:

  • organisation contains 'Manufacturing'

6. new_team_name

The expression new_team_name is used to set a new team assignment if the requester belongs to the Manufacturing organisation. This is done by a ternary operator C <strong>then</strong> A <strong>else</strong> B that takes three arguments A, B and C. The first argument A is a comparison argument, the second argument B is the result upon a true comparison, and the third argument C is the result upon a false comparison. This expression is defined as follows:

  • is_from_manuf then 'End-User support, Chicago' else old_team_name

7. is_from_rd_center

The expression is_from_rd_center is used to check if the requester belongs to the Research & Development center. This can be defined as follows:

  • organisation contains 'Research & Development'

8. new_team_name

The expression new_team_name is used to set a new team assignment if the requester belongs to the Research and Development organisation. This expression is defined as follows:

  • is_from_rd_center then 'End-User support, Boston' else new_team_name

9. move_task

The expression move_task is used to identify the task for for the move of the desktop PC. Because the subject of this task is ‘Move desktop PC to new location’, the expression can be defined as follows:

  • workflow.tasks['Move desktop PC to new location']

9. update_cmdb

The expression update_cmdb is used to identify the task for for the move of the desktop PC. Because the subject of this task is ‘Specify new location in CI record of PC’, the expression can be defined as follows:

  • workflow.tasks['Specify new location in CI record of PC']

 

Condition

After the expressions have been defined in the rule, the condition, which needs to be met in order for the rule to be executed, can be set. In this example, the rule must be executed when the requester belongs to the Manufacturing or Research & Development organisation. This is simply:

  • is_from_manuf or is_from_rd_center

 

Update 1 Set the assignment team of the task ‘Confirm availability of the LAN connectivity’

The rule needs to update the task ‘Confirm availability of the LAN connectivity’. Since this is the task for which the automation rule is defined, the Update field does not need to have a value. That will cause it to default value to the current record.
 

Set

Because the objective of the rule is to update the assignment team of the current task, the following needs to be specified in the Set field:

  • team = new_team_name
     

Update 2 Set the assignment team of the task ‘Move desktop PC to new location’

The expression move_task has been set to identify this task. This expression can therefore be selected in the Update field.
 

Set

Because the objective of the rule is to update the assignment team of the current task , the following needs to be specified in the Set field:

  • team = new_team_name

Update 3 Set the assignment team of the task ‘Specify new location in CI record of PC’

The expression update_cmdb has been set to identify this task. This expression can therefore be selected in the Update field.

Update 4 Empty assignment member of the task ‘Confirm availability of the LAN connectivity’

The rule needs to update the task ‘Confirm availability of the LAN connectivity’. Since this is the task for which the automation rule is defined, the Update field does not need to have a value. That will cause it to default value to the current record.

Set

Because the automation rule will fail if a specialist not belonging to the new team is selected in the member field of the task, the following needs to be specified in the Set field:

  • member = empty

Update 5 Empty assignment member of the task ‘Move desktop PC to new location’

The expression move_task has been set to identify this task. This expression can therefore be selected in the Update field.
 

Set

Because the automation rule will fail if a specialist not belonging to the new team is selected in the member field of the task, the following needs to be specified in the Set field:

  • member = empty

Update 6 Empty assignment member of the task ‘Specify new location in CI record of PC’

The expression update_cmdb has been set to identify this task. This expression can therefore be selected in the Update field.
 

Set

Because the automation rule will fail if a specialist not belonging to the new team is selected in the member field of the task, the following needs to be specified in the Set field:

  • member = empty
     

Demo Data

This example can be found in the ‘Information Technology – Widget North America’ account of the Xurrent demo data. It is included in the workflow of the workflow template ‘Move desktop personal computer’. To review this example, log into your Xurrent demo instance at Xurrent-demo.com by entering the name and password of the instance. Once you have accessed your instance, select the Xurrent account ‘Information Technology – Widget North America’. Next, log in as Karri Otter (email address: karri.otter@widget.com and password: Xurrent). When you are logged in as Karri, you can open the workflow template in the Records console.