Skip to main content
Version: 2024.1

Automation Actions

Automation actions allow you to configure actions that consist of one or multiple steps and will be executed asynchronously via the Job Execution Engine.

The available actions must be configured first before initiating them through Pimcore Copilot or scheduling them via a cron definition.

Configuration of Actions

In the Admin Backend UI you can create/edit the configurations for the Copilot. The configuration is located under Settings -> Pimcore Copilot -> Pimcore Copilot Configuration.

Configuration OverviewConfiguration OverviewConfiguration Overview

Additionally, you also can configure automation actions directly in symfony configuration files.

Triggers

You can define scheduled and manual triggers for the action.

Triggers TabTriggers TabTriggers Tab

Scheduled Triggers

Activate schedule to automatically execute automation actions based on a schedule.

  • Cron definition (Required): defines when action should be executed (e.g. daily at 7am)
  • Subjects for the action: Defines what elements the action should be executed on (e.g. all event objects)
    • Type (Objects, Assets, Documents) and Class (if type objects is selected): defines element types
    • Workspace: defines folders of elements to be included
    • Precondition: allows additional filtering of elements to be included
Manual trigger

Activate manual trigger to allow manually starting automation actions via Pimcore Copilot.

  • Context limitations: Limit context when action should be available (e.g. only when asset image is open). If left empty, the action is always available. For more information about available contexts, see Contexts.

Environment Variables

Define a form of variables, that the user needs to enter when starting the action in Pimcore Copilot. These variables can be used in the action steps. They only make sense for manually triggered actions. Details see Environment Variables.

Steps

Defines the actual steps of the action and their order. Use the Add button to add new steps to the action. Use the up and down buttons on the right to change the order of the steps. Use the delete button to remove a step from the action.

StepsUpDownAddRemoveStepsUpDownAddRemoveStepsUpDownAddRemove

Available Step Configuration
  • Name (Required)
    • Display name, must be unique within the action.
  • Step Implementation (Required)
    • Select a step implementation from the list of available step implementations.
  • Condition (optional)
    • Condition when step should be executed. The condition is a symfony expression with access to the variables context (current JobRun context) and environmentData (defined environment variables).
  • Configuration (optional)
    • Optional additional configuration for step in YAML format depending on step implementation.
    • For further information on the configuration of built-in steps, please refer to the documentation of the respective step implementation. Additionally, the configuration UI also offers inline help for further insights.

automation-action-step-configuration-help.pngautomation-action-step-configuration-help.pngautomation-action-step-configuration-help.png

Action Permissions

Permission configuration for user and roles, please see Permissions for further information.

Post Interaction

You can define an interaction that will be triggered after the action has been executed successfully.

Currently, there are two options available:

  • None
  • Reload Data Element
    • Reloads the subject of the action after execution. This is useful if the action changes the subject, and you want to see the changes immediately.

Post InteractionPost InteractionPost Interaction