-
Notifications
You must be signed in to change notification settings - Fork 3
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
b0dc094
commit 31c611a
Showing
2 changed files
with
73 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,73 @@ | ||
--- | ||
title: Workflow in progress | ||
sidebar_position: 4 | ||
--- | ||
|
||
# Workflow in progress | ||
|
||
[[API Docs](/api/workflow-execution)] | ||
[[SDK](https://www.npmjs.com/package/@epilot/workflow-client)] | ||
|
||
Workflows consist of two primary components, and their advancement can be interpreted in various ways depending on specific factors. | ||
|
||
Workflows components: | ||
- Task | ||
- Phase | ||
|
||
## Tasks | ||
A task represents an individual unit of work. | ||
|
||
|
||
![workflow task](../../static/img/workflows/task.png) | ||
|
||
## Phases | ||
Phases are another integral part of workflows, with the distinction that phases can encompass tasks. | ||
|
||
|
||
![workflow phase](../../static/img/workflows/phase.png) | ||
|
||
## Progression Tracking | ||
The progression within a workflow is visualized through the combined use of tasks, phases, and the status field. | ||
|
||
## Status | ||
The status fields, used to indicate the state of the workflow and its components, are as follows: | ||
- workflows status: `STARTED`, `CANCELLED`, `DONE` | ||
- task status: `ASSIGNED`, `UNASSIGNED`, `IN_PROGRESS`, `SKIPPED`, `DONE` | ||
- phase status: `OPEN`, `IN_PROGRESS`, `COMPLETED` | ||
|
||
### Phase status logic | ||
- `OPEN` | ||
- contains at least 1 `OPEN` and none `IN_PROGRESS`/`DONE`/`SKIPPED` tasks | ||
- `IN_PROGRESS` | ||
- the first phase of a started workflow | ||
- contains at least 1 `IN_PROGRESS` task | ||
- contains at least 1 `DONE`/`SKIPPED` task BUT not all tasks are `DONE`/`SKIPPED` (implying work has started on the phase) | ||
- considering linear workflows, a phase which follows a `COMPLETED` phase/task AND contains the NEXT_OPEN_TASK | ||
- `COMPLETED` | ||
- all tasks `DONE` or `SKIPPED` | ||
|
||
> ⚠️ Statuses play a crucial role when data is presented based on them. | ||
One approach to monitoring workflow progress is by tallying and considering phases in the IN_PROGRESS state. | ||
![workflow phases in progress](../../static/img/workflows/phases_in_progress.png) | ||
|
||
|
||
--- | ||
|
||
|
||
|
||
## Current Workflow Position | ||
Another valuable tool for monitoring workflow progression is the concept of the `current task` and `current phase`. | ||
- `current task` | ||
|
||
In a sequential workflow, the current task is always the first task that falls into one of the following states: `ASSIGNED`, `UNASSIGNED`, `IN_PROGRESS` when viewing the workflow from top to bottom, regardless of whether the task is at the root level or a child of a phase. | ||
![workflow current task](../../static/img/workflows/current_task.png) | ||
The current task is identifiable by a blue border when viewing a workflow. | ||
|
||
- `current phase` | ||
|
||
Similar to the `current task`, the `current phase` is represented by a phase that contains the `current task` as one of its children. In the image below, "Prüfung" is the `current phase`. | ||
![workflow current phase](../../static/img/workflows/current_phase.png) | ||
|
||
> ⚠️ The present positions of tasks and phases within the workflow are employed when updating entity attributes. Workflow configurations can enable the updating of entity attributes directly from the workflow hub, as illustrated in the image below: | ||
![workflow configure entity update](../../static/img/workflows/configure_entity_update.png) | ||
![workflow entity attribute updated](../../static/img/workflows/entity_attribute_updated.png) |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.