Available: setField() v1.127.0
The setField()
function is available from v1.127.0
Takes two expressions — target
and
value
— and sets the field named by
the result of the target
expression to the
result of the value
expression.
Can be used to manipulate fields whose names are not statically known, but computed at runtime.
Parameter | Type | Required | Default Value | Description |
---|---|---|---|---|
target | expression | required | __setField | Evaluates the name of the field to set. |
value | expression | required | An expression whose result becomes the value for the field. |
setField()
Examples
Click
next to an example below to get the full details.Set the Value of a Field
Query
item := 4
| setField(target="foo", value=item + 10)
Introduction
Set the value of a target field as the result of an expression. This is equivalent to:
item := 4
| foo := item + 10
Step-by-Step
Starting with the source repository events.
- logscale
item := 4
In a
test
event the field item is set to4
. - logscale
| setField(target="foo", value=item + 10)
Sets the value of the target field foo as the result of the expression
value of item + 10
. Event Result set.
Summary and Results
foo | item |
---|---|
14 | 4 |
Set Values for Multiple Fields
Query
item := 4
| bar := "baz"
| setField(target=bar, value=item + 10)
| setField(target="foo", value=item + 20)
| setField(target="baaz", value=if(item == 4, then="OK", else="not OK"))
Introduction
Set the value of more fields as the result of several expressions.
Step-by-Step
Starting with the source repository events.
- logscale
item := 4
In a
test
event where field item is set to4
: - logscale
| bar := "baz"
Points field bar to field "baz":
- logscale
| setField(target=bar, value=item + 10)
Takes field bar as the target, gets the field pointed to by bar (baz) and sets its value as the result of the expression
value of item + 10
. - logscale
| setField(target="foo", value=item + 20)
Takes field foo as the target, sets its value as the result of the expression "value of item + 20":
- logscale
| setField(target="baaz", value=if(item == 4, then="OK", else="not OK"))
Adds an
if()
function whose condition will set the value of the new target field baaz: for example, if item is equal to4
, then the value of field baaz isOK
, otherwisenot OK
. Event Result set.
Summary and Results
We look at different target fields to set their values as the
result of a given expression. Functions can be added as part of
the expression in the
value
parameter,
to determine the value of another target expression.
baaz | bar | bar | baz | foo | item |
---|---|---|---|---|---|
OK | baz | baz | 14 | 24 | 4 |