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
Setting 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)
Set 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 |
Setting 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"
Point field bar to field "baz":
- logscale
| setField(target=bar, value=item + 10)
Take field bar as the target, get the field pointed to by bar (baz) and set its value as the result of the expression
value of item + 10
. - logscale
| setField(target="foo", value=item + 20)
Take field foo as the target, set 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"))
Add 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 |