Skip to content

Processing migration row value

Plugin ID: migrate:process

Available since: 1.0.0

Provided tokens

Token Description
[user] The current user.
Alias: current_user
[htmx] Information about the current HTMX request.
[htmx:is_request] Whether the current request was sent by HTMX ("1" or "0").
[htmx:boosted] Whether the current request was boosted by HTMX ("1" or "0").
[htmx:history_restore] Whether the current request is for HTMX history restoration ("1" or "0").
[htmx:target] The identifier of the element the response is targeted at.
[htmx:trigger] The identifier of the element that triggered the request. On Drupal 11 this is the element id, on Drupal 12 and later it is the CSS selector that htmx 4 sends. Prefer "trigger_name", which means the same thing on both.
[htmx:trigger_name] The name attribute of the element that triggered the request, or empty if it has none. This has the same meaning on all supported Drupal versions.
[htmx:source] The CSS selector of the element that triggered the request, for example button[name="first_item"]. Empty on Drupal 11, which does not send this information.
[htmx:request_type] Whether the request targets a full page or a fragment: "full" or "partial". Empty on Drupal 11, which does not send this information.
[htmx:current_url] The URL of the page the request was sent from.
[migration_id] The migration plugin id being run.
[row] The row about to be imported.
[row:source] The current migration row source and its properties. Source properties can be accessed by [row:source:PROPERTY_NAME].
[row:destination] The current migration row destination and its properties. Destination properties can be accessed by [row:destination:PROPERTY_NAME]. However, such properties only exist if they have been processed before during the migration of the current row.
[row:is_stub] Whether the current migration row is a stub.
[value] The migration row value to process.
[destination_property] The destination property.
[event] The event.
[event:machine_name] The machine name of the ECA event.
[session_user] The user account that dispatched the event, regardless if ECA is processing models under a different account. This is only available if ECA is configured to always run under a specific account.

Fires during the processing of a migration row value when using the ECA migrate process plugin. This allows transforming field values using ECA actions instead of writing PHP code.

The [value] token holds the current value being processed. Set the result using the token specified in the configuration.

Fields

Token name holding the processed value — config key: token_name

The name of the token to hold the processed value.

Type: textfield · Required: yes · Default: empty string

The name of the token to hold the processed result. After ECA actions run, the value of this token becomes the transformed output.

Restrict by migration — config key: migration_id

Optionally restrict this event to a single migration. Leave any to react on all migrations.

Type: select · Required: no · Default: empty string

Allowed values: '', d7_gauth

Restrict by destination property — config key: destination_property

Optionally restrict this event to a single destination property. Leave empty to react on all destination properties. Tokens are not supported.

Type: textfield · Required: no · Default: empty string