Add an Ansible Automation Platform workflow template step

The details panel opens.

After you select an integration, a credential status appears below the field. If a credential is already configured, its name appears. If no credential is configured, click Set up connection and select a credential from the dropdown. To create a new credential without leaving the step configuration, select Create new credential at the top of the dropdown.

If you open an existing step and the previously selected integration is no longer available, a warning appears. The system clears the integration and credential fields. Select a new integration to continue.

• To manually select a specific workflow template:

  1. In the Organization field, select the Ansible Automation Platform organization that contains the workflow template you want to run. When you select an organization, the Workflow template dropdown list populates with the available workflow templates.
  2. Select a workflow template. The field supports typeahead search. After you select a template, a View workflow template in AAP link appears so you can verify the template configuration.

• To use expressions to select the workflow template dynamically based on output from a previous step:

  1. Toggle Use input variables at the top of the Parameters pane. Text fields that accept expressions and input variables replace the Organization and Workflow template dropdown lists. Any enabled prompt-on-launch fields appear.
  2. In the Organization field, enter the organization name or drag an expression from the Input pane.
  3. In the Workflow template field, enter the template name or drag an expression from a previous step's output. For example, drag workflow_template_name from a task agent step that analyzed the environment and recommended a provisioning pipeline.

• Inventory: Override the default inventory for the workflow.
• Labels: Select or create labels for the workflow job.
• Limit: Enter a host pattern to restrict which hosts the workflow runs against.
• Source control branch: Override the default source control branch for project syncs within the workflow.
• Job tags: Enter tags to filter which tasks run. Type a tag and press Enter or comma to add it.
• Skip tags: Enter tags for tasks to skip.
• Extra variables: Enter additional variables as a JSON object. Click the expand icon to open a larger editor.

• On failure behavior: Controls what happens when a step fails.

  • System default: Uses the system-wide setting configured by an administrator.
  • Continue on failure: The step is marked as failed and the workflow continues to the next step.
  • Stop workflow or branch on failure: The step fails and the workflow or current branch stops execution.

• Timeout: The maximum number of seconds the step can run before automation orchestrator marks it as failed with a timeout error. If left unset, the step uses the global default for its step type.

• Retry policy: Configures automatic retry behavior when a step fails due to transient errors. Toggle Override retry policy to enable the following fields:

  • max_retries: The number of retry attempts after the initial failure.
  • initial_interval: Seconds to wait before the first retry.
  • max_interval: Maximum seconds to wait between retries.
  • backoff_coefficient: Multiplier applied to the wait interval after each retry (1.0 = fixed interval, greater than 1.0 = exponential backoff).

  When the toggle is off, the system default retry policy applies.