modify

Task purpose

The modify task creates a new variable from a modified copy of an existing variable. Its primary purpose is to modify an object key’s boolean, number, or string value. modify can create a new variable from both job variables and the outgoing variables of tasks. It works with boolean, number, string, and object data types. It does not work with array data types and will not modify elements of an array within an object.

Properties

Examples

Change a boolean value

Change the boolean value of a job variable or a previous task’s outgoing variable from false to true:

1
object_to_update = <name of var>
2
query = ""
3
new_value = true

The value of updated_object (outgoing variable) will be true.

Change a string value

Change the string value of a job variable or a previous task’s outgoing variable from "before" to "after":

1
object_to_update = <name of var>
2
query = ""
3
new_value = "after"

The value of updated_object (outgoing variable) will be "after".

Change a field value in an object

Change the boolean value of the "sync-status" field in an object from true to false:

1
object_to_update = {
2
  "name": "cr1.atl",
3
  "sync-status": true
4
}
5
query = "sync-status"
6
new_value = false

The value of updated_object (outgoing variable):

1
{
2
  "name": "cr1.atl",
3
  "sync-status": false
4
}

Change a nested string field in an object

Change the string value of the "description" field in an object:

1
object_to_update = {
2
  "name": "BMW-1",
3
  "description": "Northeast region",
4
  "endpoints": [
5
    { "name": "NYC", "device": "er1.nyc" },
6
    { "name": "BOS", "device": "er1.bos" }
7
  ]
8
}
9
query = "description"
10
new_value = "New England Region"

The value of updated_object (outgoing variable):

1
{
2
  "name": "BMW-1",
3
  "description": "New England Region",
4
  "endpoints": [
5
    { "name": "NYC", "device": "er1.nyc" },
6
    { "name": "BOS", "device": "er1.bos" }
7
  ]
8
}