Ation Service Agent icon

Ation Service Agent

Interact with the Ation Service Agent API

Overview

This node interacts with the Ation Service Agent API to execute tasks within specified projects and templates. It is useful for automating task execution workflows where tasks are defined by project and template IDs. For example, it can be used to trigger a task run in a project management or automation system, optionally simulating the run without actual execution (dry run) or adding descriptive metadata to the task execution.

Use Case Examples

  1. Running a task in a selected project using a specific template.
  2. Simulating a task run to verify configuration without performing the actual task.
  3. Adding an execution description to a task run for better tracking.

Properties

Name Meaning
Project Name or ID Specifies the project in which the task will be run. The user can select from a list or provide an ID via expression.
Template Name or ID Specifies the template to use for running the task within the selected project. The user can select from a list or provide an ID via expression.
Execution Description Optional description to add context or notes about the task run.
Dry Run Boolean flag to simulate the task execution without actually performing any actions.
Batching - Items per Batch Number of items to process per batch to throttle requests. -1 disables batching, 0 treated as 1.
Batching - Batch Interval (ms) Time interval in milliseconds between each batch of requests. 0 disables interval delay.
Ignore SSL Issues (Insecure) Whether to accept responses even if SSL certificate validation fails.
Proxy HTTP proxy URL to route requests through, including optional authentication.
Timeout Timeout in milliseconds to wait for server response headers before aborting the request.

Output

JSON

  • id - Identifier of the executed task run.
  • status - Current status of the task run (e.g., running, completed).
  • result - Result or output data from the task execution.
  • description - Description provided for the task run, if any.

Dependencies

  • Ation Service Agent API with credentials including base URL and authentication token

Troubleshooting

  • Missing or incorrect API credentials will cause authentication errors. Ensure the API URL and token are correctly configured.
  • Selecting a project or template that does not exist or is inaccessible will result in errors. Verify project and template IDs.
  • Network issues or SSL certificate problems may cause request failures. Use the 'Ignore SSL Issues' option cautiously if needed.
  • Timeouts can occur if the server is slow to respond. Adjust the timeout setting as necessary.
  • Batching settings must be configured properly to avoid request throttling issues.

Links

Discussion