Salesforce ECA Events, Conditions, and Actions

Integrates Salesforce with Drupal's Event-Condition-Action (ECA) system. Build workflows that react to Salesforce operations without writing code.

Events

Push Events

Push to Salesforce allowed

Fires before entity push.

Tokens: entity, mapping, mapping_id, push_allowed

Push mapping object

Fires before processing push.

Tokens: entity, mapping, mapped_object

Push parameters

Fires when preparing push data.

Tokens: entity, mapping, mapped_object, params

Push success

Fires after successful push.

Tokens: entity, mapping, mapped_object, params

Push failure

Fires when push fails.

Tokens: entity, mapping, mapped_object, operation

Pull Events

Pull query

Fires before SOQL execution.

Tokens: mapping, query, query:query_string

Pull enqueue

Fires before queueing records.

Tokens: mapping, record, records, enqueue_allowed

Pull from Salesforce allowed

Fires before pull.

Tokens: entity, mapping, mapped_object, pull_allowed

Pull entity value

Fires for each field during pull.

Tokens: entity, mapping, field_plugin, entity_value

Pull presave

Fires before saving pulled entity.

Tokens: entity, mapping, mapped_object

Error Event

Error

Fires on Salesforce errors.

Tokens: error_message, error_context, entity_id, mapping_info, operation_type

Actions

Execute SOQL query

Inputs: SOQL query, Result token name

Tokens: [token:records:0:FieldName], [token:size], [token:field_names]

Trigger entity push

Inputs: Entity

Tokens: [token:success], [token:salesforce_ids], [token:errors]

Trigger entity pull

Inputs: Entity or Salesforce ID

Tokens: [token:success], [token:changed_fields], [token:error]

Call Salesforce API

Inputs: Endpoint, Method, Body, Headers

Tokens: [token:data], [token:status_code], [token:headers]

Get Salesforce field value(s)

Inputs: Object type, Record ID, Field names

Tokens: [token:FieldName], [token:success], [token:error]

Get Salesforce mapped object

Inputs: Entity

Tokens: [token:salesforce_id], [token:salesforce_object_type], [token:mapping_id]

Get Salesforce object metadata

Inputs: Salesforce object type, Performance options

Tokens: [token:fields:FieldName:label], [token:fields:FieldName:type], [token:field_count], [token:success]

Conditions

Entity is mapped to Salesforce

Inputs: Entity, Mapping ID (optional)

Can store mapping info in tokens.

Requirements

Drupal 10.3+ or 11

Salesforce module suite

ECA module