Common Options
This section contains common option definitions for action handlers.
Commonly used to assign action results to context fields.
Example 1: Direct assignment
Allow to assign value directly to
# assign value to context's `ctx` field `target`
# <assignTo> is action specific name and may generally can be either simply `assignTo` or more descrete `assignSomethingTo`
'<assignTo>': $.ctx.target
When path assignment targets context following rules are applied: Value assignment is only possible to
ctx, secrets or parameters.Example 2: Multi assignment
Then example above can also be written in the following way:
'<assignTo>':
ctx: $.target
The main advantage of this alternative syntax is the ability to assign to multiple values and override the entire target object.
Let's say we want to save value into both
ctx and parameters, we can leverage that with:'<assignTo>':
ctx: $.target
parameters: $.paramsTarget
Another example is with field override functionality.
Let assume we currently have the following context state:
ctx:
something:
a: 1
b: 2
and we want to assign to
ctx.something entirell new object:'<assignTo>':
ctx: '$.something'
# if override is not provided assigned value and existing will be merged
override: true
Another common usecase is to push some value into array.
# push some value to `ctx.something` field array
# if field is missing - it will be created with array and one pushed element in it
'<pushTo>': '$.ctx.something'
Similar to
assignTo functionality pushTo can push values into multiple targets, override original value.But additionally to that there is one more option that works only when pushed value is array - pushing its items to the target array instead of the array itself:
'<pushTo>':
ctx: '$.target'
# if children option is passed value's array items will be pushed to `target` array instead of pushing value itself
children: true
Last modified 4yr ago