Manual Trigger

Ben Tiedt — Wed, 19 Jun 2019 21:07:34 GMT

Current Revision posted to Developer Training by Ben Tiedt on 06/19/2019 21:07:34

Automations can be triggered from themes, widgets, other automations, or [[Plugins|plugins]] by enabling manual triggering. In situations where an artificial or custom event without [[Automation Event Definitions|API integration]] is required to trigger an automation, a manual trigger can be used.

Enabling Manual Triggering

Manual triggering allows an automation to be triggered programmatically from other [[Scripting|scripted customizations]] or [[Plugins|plugins]]. To enable manual triggering,

On the automation's Overview, locate Triggers, and check Manual Execution.
Take note of the inline documentation used to trigger the automation. This includes the identifier used to uniquely identify this automation in the APIs used to initiate a manual trigger.

Triggering an Automation Manually

Any [[Scripting|scripted customization]] (theme, widget, automation) or [[Plugins|plugin]] can trigger a manually triggerable automation using one of the APIs identified in the inline documentation for a manually triggerable automation in Automation Studio.

When triggering an automation manually, the relevant API accepts:

The Automation's Identifier. This identifies which automation should be triggered.
Parameters. Custom parameters that should be provided to the automation from the caller. Any string-based key/value pairs can be provided.

If there are enabled instances of the requested automation, they will be executed with the provided arguments and the response from the automation(s) will be returned to the caller for review. The response is always a string.

Using Manual Triggers in Automation Implementations

When an automation is triggered manually, details about the manual execution are made available through the context_v2_automationTrigger API which provides the following members:

Entity. For manual triggers, the Entity is always "Manual"
Event. For manual triggers, the Event is always "Trigger"
Arguments. For manual triggers, Arguments is an object with two properties:
- Parameters. The key / value parameters, if provided, by the caller.
- Response. The string response to return to the caller.

See the inline documentation for context_v2_automationTrigger for more details about manual trigger arguments.

Manual Trigger Notes

Manual execution enablement is provided on an automation, however, the automation is not enabled until an instance is created in Administration > Automations > Automations. Until at least one instance of the automation is enabled, the manual execution will always return an empty response.
Automations support multiple instances, but only one response can be provided to the caller. For automations that can be triggered manually, if there are multiple enabled instances defined in Administration > Automations > Automations, the automation will be executed multiple times (once for each instance) when a manual trigger is executed.

Manual Trigger

Ben Tiedt — Wed, 19 Jun 2019 21:07:18 GMT

Revision 3 posted to Developer Training by Ben Tiedt on 06/19/2019 21:07:18

Enabling Manual Triggering

Manual triggering allows an automation to be triggered programmatically from other [[Scripting|scripted customizations]] or [[Plugins|plugins]]. To enable manual triggering,

On the automation's Overview, locate Triggers, and check Manual Execution.
Take note of the inline documentation used to trigger the automation. This includes the identifier used to uniquely identify this automation in the APIs used to initiate a manual trigger.

Triggering an Automation Manually

Any [[Scripting|scripted customization]] (theme, widget, automation) or [[Plugin|plugin]] can trigger a manually triggerable automation using one of the APIs identified in the inline documentation for a manually triggerable automation in Automation Studio.

When triggering an automation manually, the relevant API accepts:

The Automation's Identifier. This identifies which automation should be triggered.
Parameters. Custom parameters that should be provided to the automation from the caller. Any string-based key/value pairs can be provided.

Using Manual Triggers in Automation Implementations

When an automation is triggered manually, details about the manual execution are made available through the context_v2_automationTrigger API which provides the following members:

Entity. For manual triggers, the Entity is always "Manual"
Event. For manual triggers, the Event is always "Trigger"
Arguments. For manual triggers, Arguments is an object with two properties:
- Parameters. The key / value parameters, if provided, by the caller.
- Response. The string response to return to the caller.

See the inline documentation for context_v2_automationTrigger for more details about manual trigger arguments.

Manual Trigger Notes

Manual execution enablement is provided on an automation, however, the automation is not enabled until an instance is created in Administration > Automations > Automations. Until at least one instance of the automation is enabled, the manual execution will always return an empty response.
Automations support multiple instances, but only one response can be provided to the caller. For automations that can be triggered manually, if there are multiple enabled instances defined in Administration > Automations > Automations, the automation will be executed multiple times (once for each instance) when a manual trigger is executed.

Manual Trigger

Former Member — Tue, 18 Jun 2019 18:47:18 GMT

Revision 2 posted to Developer Training by Former Member on 06/18/2019 18:47:18

This option allows this automation to run via a method call from a widget, javascript, or in-process code such as a plugin. Syntax documentation and further links are provided when selecting this option.

Manual Trigger

Ben Tiedt — Fri, 14 Jun 2019 20:53:13 GMT

Revision 1 posted to Developer Training by Ben Tiedt on 06/14/2019 20:53:13

TBD