> ## Documentation Index
> Fetch the complete documentation index at: https://doc.qbilon.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Automations (Workflows)

> Create and manage automations, tasks, triggers, and execution runs.

[YouTube video player](https://www.youtube.com/embed/jSO0exJuurc?start=78)

## Overview

"Automations" enable managing the data import and consolidation within Qbilon. You can use them to connect external data sources, consolidate asset data with mergers and linkers, and write data to third-party systems. Within this context, [Centralized Variables](https://doc.qbilon.io/05-automations-workflows/variables.md), [Webhook Triggers](https://doc.qbilon.io/05-automations-workflows/webhooks.md), and [Custom Tasks](https://doc.qbilon.io/12-customizing-qbilon/custom-tasks/index) are powerful means to simplify and extend automations.

Clicking on `Automations` (fmr. workflows) in the main navigation sidebar opens the automations management section. This page uses a "master-detail layout" to improve navigation and visibility:

* The left sidebar ("Master") displays a searchable list of all your automations and their current execution status.
* The central, main view displays the topology of the currently selected automation.
* The right sidebar shows details of the selected execution run or automation.

## Automations Sidebar

The sidebar displays the search bar and a list of automations (sorted alphabetically).

Clicking on a specific automation provides immediate insight into its status (last runs) and execution schedules. Now, the automation can directly be modified in the visual representation in the center by either clicking on the separate tasks or hovering over them to show the "+" (add task) action button.

![5 – Automations (Workflows): Automations Sidebar](https://mintcdn.com/qbilon-docs/Jmla3tEw4FRYjkNT/.gitbook/assets/85de9aba-9b07-4d34-b8d6-543a354ca507-screenshot-2026-09-24-104506.png?fit=max\&auto=format\&n=Jmla3tEw4FRYjkNT\&q=85\&s=7559f5b143fbc0808267c6b66c869584)

The left panel shows all available automations. Selecting one provides a list of past and future executions below.

Clicking on a specific execution (box) reduces the visual representation in the center to illustrate which tasks were executed in the last run. Now, a specific task can be selected to show its details in the right sidebar.

![5 – Automations (Workflows): Automations Sidebar](https://mintcdn.com/qbilon-docs/lr-P4KF_9wn8x9Vs/.gitbook/assets/bfc26f68-d7d2-4136-b190-74adc4d98087-screenshot-2026-09-30-115001.png?fit=max\&auto=format\&n=lr-P4KF_9wn8x9Vs\&q=85\&s=102dc41c9a046e9d67b1305df58cf7e4)

After selecting an execution run in the left panel and clicking on a specific task in the visual representation, the task run details are shown in the right details panel.

### Automations List

Each item in the automation list includes:

* Trigger Icons – a preceding icon indicates the automation's trigger type:
  * `Onetime` (![Automations List](https://mintcdn.com/qbilon-docs/lr-P4KF_9wn8x9Vs/.gitbook/assets/cf38aefd-110d-4277-8146-b89ab2d3c92f-image.png?fit=max\&auto=format\&n=lr-P4KF_9wn8x9Vs\&q=85\&s=257aba716bef7bae7c5037de99e81446)), i.e., running a data source import or a data consolidation task is only executed once (it can still be triggered manually anytime),
  * `Scheduled` (![Automations List](https://mintcdn.com/qbilon-docs/lr-P4KF_9wn8x9Vs/.gitbook/assets/d0ba0913-872c-461f-91ce-a6b1a1d533da-image.png?fit=max\&auto=format\&n=lr-P4KF_9wn8x9Vs\&q=85\&s=dd9c267c039b8cf8fe7bf65a7933a458)), i.e., running a data source import or a data consolidation task is triggered periodically according to a specified interval and
  * `Webhook` (![Automations List](https://mintcdn.com/qbilon-docs/aJQhbcvq7mtvhV0w/.gitbook/assets/1895932d-c36d-4931-86ce-183675ef8e3e-image.png?fit=max\&auto=format\&n=aJQhbcvq7mtvhV0w\&q=85\&s=e0e185e345c27fac10db00097489b430)), i.e., running a data source import or a data consolidation task depends on the triggering of a webhook endpoint in Qbilon (see [Webhook Trigger](https://doc.qbilon.io/05-automations-workflows/webhooks.md) for details).
* Running Status: If an automation is currently executing, an animated status spinner appears next to it.
* Selection: Clicking an automation highlights it and loads its details in the main view.

![5 – Automations (Workflows): Automations List](https://mintcdn.com/qbilon-docs/lr-P4KF_9wn8x9Vs/.gitbook/assets/ee152cee-5cb9-4220-b5c7-32227f272956-screenshot-2026-09-30-134255.png?fit=max\&auto=format\&n=lr-P4KF_9wn8x9Vs\&q=85\&s=e06bdcef4d09c5da9f8e91ea1cf1168a)

The "trigger type" of each automation is shown by the icons on the left. The progress bar on the right side indicates a currently running automation.

### Status Indicators & Tooltips

Colored dots may appear next to an automation name to indicate specific states. Hovering over these dots also reveals a tooltip with more details. There are two different status indicators currently:

* Failed Execution (🔴 red dot): indicates that the last run was not successful.
* Update Available (🔵 blue dot): indicates that a template used in the automation has a newer version available.

### Executions Panel

Located at the bottom of the sidebar, this section displays execution data for the currently selected automation. This information is read-only.

There are at most two different execution cards available at once:

* `Next Scheduled Run`: If the automation has a schedule trigger, this card displays the date and time of the upcoming execution.
* `Status` & `Progress`, if currently an automation is running or has a past execution:
  * `Running`: shows a progress bar (share of completed tasks)
  ![5 – Automations (Workflows): Executions Panel](https://mintcdn.com/qbilon-docs/aJQhbcvq7mtvhV0w/.gitbook/assets/54cace82-3080-4e79-b0ad-fa7eccdfda53-screenshot-2026-04-27-094635.png?fit=max\&auto=format\&n=aJQhbcvq7mtvhV0w\&q=85\&s=c3613cd6622a0a5ce6a8f41809760847)
  * `Completed`: displays the final status (e.g., "success" or "failed"), the duration, and how long ago the execution finished. Hovering over the relative time (e.g., "15 mins ago") shows the exact timestamp.
  ![5 – Automations (Workflows): Executions Panel](https://mintcdn.com/qbilon-docs/Jmla3tEw4FRYjkNT/.gitbook/assets/97ddae7e-9de8-47d5-860e-a426b087fd31-screenshot-2026-04-27-095016.png?fit=max\&auto=format\&n=Jmla3tEw4FRYjkNT\&q=85\&s=30598db732303650072d0b27bfe05e5d)
  * `Failed`: displays the name of the specific task that caused the failure is displayed.
  ![5 – Automations (Workflows): Executions Panel](https://mintcdn.com/qbilon-docs/aJQhbcvq7mtvhV0w/.gitbook/assets/22ae2feb-77ad-425a-83af-5f0d4ad3cd77-screenshot-2026-04-27-094854.png?fit=max\&auto=format\&n=aJQhbcvq7mtvhV0w\&q=85\&s=3fdffedfd92464147ed1a48f3ceea5c1)

If there are no past or future executions, a `No executions yet` placeholder is shown.

## Automation Topology View

Once an automation is selected, the main content area loads its topology.

![5 – Automations (Workflows): Automation Topology View](https://mintcdn.com/qbilon-docs/aJQhbcvq7mtvhV0w/.gitbook/assets/25b214a8-677b-4095-babb-4f35ecd7c0ad-screenshot-2026-07-23-132036.png?fit=max\&auto=format\&n=aJQhbcvq7mtvhV0w\&q=85\&s=1af361b32e559a019cc38905614fb017)

The visual diagram of tasks connected by arrows, showing their execution order and statuses.

### Header Actions

The header displays the automation name on the left and action buttons on the right.

* `Run (Trigger)`: A multi-choice button to trigger the automation manually.
* `Rename`/`Delete`: Options to modify or remove the automation.

### Topology

The topology provides a visual, interactive representation of the task sequence.

* Visual Status: Tasks display their current status (`Ready`, `Running`, `Error`). If a task has a newer template available, a blue dot (🔵) appears on the task node.
* Task Toolbar: When a task is selected in the topology, a toolbar appears at the bottom:
  * `Run` → Trigger the execution of that specific task.
  * `Upgrade` /`Downgrade`→ If a newer or older template version is available, use the "Upgrade" or "Downgrade" button to switch to that version.
  * `Edit/Deactivate/Delete` → Manage the selected task directly.
* `Add successor task` → The "plus button" appears when hovering over a specific task. Clicking on it opens a dialog for defining a new task at this position.
  * ![5 – Automations (Workflows): Topology](https://mintcdn.com/qbilon-docs/aJQhbcvq7mtvhV0w/.gitbook/assets/261045df-8db6-45e8-af14-aafcba4a1d56-screenshot-2026-07-23-131625.png?fit=max\&auto=format\&n=aJQhbcvq7mtvhV0w\&q=85\&s=65d721d9385eff60b40b285f244bb941)
* Task Details Panel: Clicking a task node in the topology opens a details panel on the right side with three tabs: `Data Source Details`, `Warnings & Errors`, and `Execution Details`.
  * `Data Source Details` → provides details about the task such as the specific configuration of a merger.
  * `Warnings & Errors` → shows log messages from prior executions such as the number of processed nodes.
  * `Execution Details` → displays the time of the next and last execution (together with its duration).

## Managing Automations

To create a new automation (workflow), click on the "plus button" in the left sidebar. After typing in a name and selecting the trigger type, a new automation is finished by clicking on the "Create" button within the overlay dialog.

Now, new tasks can be added by hovering over the "cursor icon circle" in the central topology view and clicking on `+ Add Successor Task`.

![5 – Automations (Workflows): Managing Automations](https://mintcdn.com/qbilon-docs/Jmla3tEw4FRYjkNT/.gitbook/assets/a5d72025-b716-45fd-8e3a-2c52e566e455-screenshot-2026-09-30-140235.png?fit=max\&auto=format\&n=Jmla3tEw4FRYjkNT\&q=85\&s=8b5d1e27008f262da386f8c00d8c26ed)

This will show a `Create Task` panel on the right side where the user can browse and select tasks from three different categories:

* `Data Sources`: add a new data source (as shown below). See [Data Sources](https://doc.qbilon.io/06-data-sources/index) for details.
* `Data Consolidation`: create consolidation tasks such as [Mergers](https://doc.qbilon.io/07-data-consolidation-writer/custom-merger.md) and [Linkers](https://doc.qbilon.io/07-data-consolidation-writer/custom-linker.md).
* `Data Writer`: create writer tasks such as [PRTG Sensor Creator](https://doc.qbilon.io/07-data-consolidation-writer/prtg-group-creator.md) or [ServiceNow Writer](https://doc.qbilon.io/07-data-consolidation-writer/servicenow-writer.md). Details on consolidation and writer tasks are available in the chapter "[Data Consolidation & Writer](https://doc.qbilon.io/07-data-consolidation-writer/index)".

![5 – Automations (Workflows): Managing Automations](https://mintcdn.com/qbilon-docs/aJQhbcvq7mtvhV0w/.gitbook/assets/47a68ebd-654e-4572-8d46-ce28a0a6a2d4-screenshot-2026-09-18-163253.png?fit=max\&auto=format\&n=aJQhbcvq7mtvhV0w\&q=85\&s=4e4ab7a582912454f876812d9d2c13fd)

Overview of available "connectors" and data tasks.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.