Entity: set field value¶

Available since: 1.0.0

Allows to set, unset or change the value(s) of any field in an entity.

Fields¶

Field name

The machine name of the field, that should be changed. Example: body.value
This field supports tokens.

Field value

The new field value.
This field supports tokens.

Method

The method to set an entity, like cleaning the old one, etc..
When using the "Defined by token" option, make sure there is a token with this name: eca_set_field_value_method

Available options:

Set and clear previous value: Sets the field to the given value. If the field contained any value before, that will be lost, even if this is a multi-value field.
Set only when empty: Sets the field to the given value, but only if the field has been empty before. Otherwise, the previous value will be kept and nothing will be set.
Append when not full yet: If the field allows multiple values, the given value will be appended as a new item, if the max. cardinality is not reached yet. Otherwise, this action will be skipped.
Append and drop first when full: Same as above, but if the max cardinality has been reached, the first value will be removed and the new value appended to the list.
Append and drop last when full: Same as above, but instead of dropping the first, this will drop the last item before appending the new value to the list.
Prepend when not full yet: If the field allows multiple values, the given value will be inserted as the first item, if the max. cardinality is not reached yet. Otherwise, this action will be skipped.
Prepend and drop first when full: Same as above, but if the max cardinality has been reached, the first value will be removed and the new value inserted at the beginning to the list.
Prepend and drop last when full: Same as above, but instead of dropping the first, this will drop the last item before inserting the new value at the beginning of the list.
Remove value instead of adding it: Remove the value from a field, if it's contained in the list of existing items. If this removes the last remaining value of the field, then the field will be empty (for an example of this, see this issue).

Strip tags

Remove the tags or not.

Trim

Trims the field value or not.

Save entity

Saves the entity or not after setting the value.

Entity

Provide the token name of the entity that this action should operate with. Please provide the token name only, without brackets.