> For the complete documentation index, see [llms.txt](https://documentation.efalia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.efalia.com/produit/acropolis/administration/workflows.md).

# Workflows

## Définition

Il existe deux types de workflows, le workflow procédural et le workflow ad hoc.

Un workflow procédural a généralement pour but l'automatisation des processus métiers en se basant sur des procédures préétablies, contrairement à un workflow ad hoc qui laisse plus de libertés aux utilisateurs le cheminement étant dynamique.

Cette documentation détaillera uniquement l'utilisation et la création des workflows procéduraux.

Pour une utilisation dans Acropolis des workflows ad hoc, veuillez consulter la documentation concernant les diffusions.

A l'heure actuelle les workflows procéduraux sont implémentés pour les entités de type document, l'implémentations pour les dossiers, entreprises, contacts et actions est en cours de développement.

## Prérequis

La création de workflows nécessite de posséder les droits "Gestion des assistants".

Rappel : la mise en place de ces droits s'effectue au niveau de la fiche utilisateur (onglet Identité).

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-28cb0423cd860f90890bb5dc45a990b0aa8d24b7%2Fadmin-workflows-01.webp?alt=media" alt=""><figcaption></figcaption></figure>

## Création

La création et la modification d'une définition de workflow s'effectue uniquement en utilisant la version web d'Acropolis.

### Menus

Si l'utilisateur possède les droits, un menu Workflows est disponible dans le menu administration / paramétrage (engrenage).

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-59799769dadfa422b46a8db624866453ed162352%2Fadmin-workflows-02.png?alt=media" alt=""><figcaption></figcaption></figure>

Une fenêtre s'ouvre permettant de lister les définitions de workflows.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-14f458d288e9c5b384801fd78cb73a0096bad11d%2Fadmin-workflows-03.webp?alt=media" alt=""><figcaption></figcaption></figure>

Le bouton liste des workflows permet de lister les différents workflows lancés ainsi que leur état (en cours, terminé, erreur). En résumé, cette fenêtre permet de visualiser l'utilisation des définitions de workflows.

Ne pas confondre définition de workflow et workflow. Une définition de workflow est une sorte de modèle. Un workflow est le résultat de l'utilisation d'une structure sur une entité (ex document).

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-45b2341f637af7dbc75eed1d7b065f3a60f9f397%2Fadmin-workflows-04.webp?alt=media" alt=""><figcaption></figcaption></figure>

Dans l'exemple précédent, 3 workflows ont été lancés, ils sont tous terminés. 2 sont basés sur la définition "Réclamation" et 1 sur la définition "Ressources humaines".

### Création d'une définition de workflow.

Le bouton ajouter permet de créer une nouvelle définition de workflow.

Saisir un code (15 caractères max) ainsi qu'un libellé (50 caractères max) pour ce nouveau workflow. Sélectionner les domaines autorisés à lancer ce workflow.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-fc5e78567bb88d9eccf88756a6eb5abc111ded63%2Fadmin-workflows-05.webp?alt=media" alt=""><figcaption></figcaption></figure>

Valider ensuite avec le bouton OK.

L'écran de création apparaît ensuite.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-5ada7d84fc4b9861358d00e739696027871b7d7b%2Fadmin-workflows-06.webp?alt=media" alt=""><figcaption></figcaption></figure>

* Enregistrer : sauvegarde la définition de workflow
* Modifier : permet de modifier le titre de la définition ainsi que les domaines
* Supprimer : supprime la définition de workflow
* Copier : permet de copier la définition de workflow
* Exporter image : génère une image de la définition
* Retour à la liste : retour vers la fenêtre qui liste les définitions

Une étape est une tâche à réaliser. Elle est représentée par un rectangle.

Un déclencheur est un choix qui permet de relier les différentes étapes de la définition de workflow. Il est représenté par une flèche reliant deux étapes.

### Déplacement des éléments

Le concepteur graphique permet de repositionner les éléments de la définition de workflow afin qu'elle soit plus compréhensible visuellement.

Pour cela :

* Cliquer sur le fond de la fenêtre et maintenir le clic pour déplacer la définition de workflow.
* Cliquer sur une étape et maintenir le clic pour la déplacer.

### Etapes Début et Fin

Il existe obligatoirement une étape Début ainsi qu'une étape Fin permettant de délimiter la définition de workflow. Ces tâches sont de couleur verte.

Ces étapes ne sont pas modifiables, elles sont visibles uniquement dans les définitions de workflow (invisibles dans le workflow).

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-acc8ce27f4a939ee797c9b876aa3d079b90ee135%2Fadmin-workflows-07.png?alt=media" alt=""><figcaption></figcaption></figure>

### Ajout d'une étape

Cliquer sur Ajouter une étape puis cliquer sur le graphique pour ajouter l'élément.

Une fenêtre s'ouvre ensuite.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-c384fcaf5202700992e56f93a539c9ee12c7d190%2Fadmin-workflows-08.webp?alt=media" alt=""><figcaption></figcaption></figure>

Type de tâche :

* Interactive : (couleur bleue), nécessite l'intervention d'un utilisateur pour passer à l'étape suivante.
* Automatique : (couleur orange), pas d'arrêt ni d'intervention utilisateur.
* Asynchrone : (couleur violet), gestion des délais par ADC. En cours de développement.

Libellé : libellé de l'étape (visible dans l'éditeur)

Assistant : assistant qui sera lancé lors de l'exécution de l'étape

Erreur sur Assistant : (choix du fonctionnement en cas d'erreur de l'assistant)

* Arrêt du workflow en erreur
* Retour à la dernière étape interactive :
* Ignorer

Erreur sur Workflow: (choix du fonctionnement en cas d'erreur de l'étape)

* Arrêt du workflow en erreur
* Retour à la dernière étape interactive
* Ignorer

Dans le cas d'une étape interactive, le type de cible doit être précisé. Le type de cible correspond au choix de l'utilisateur qui sera en charge de cette étape lors de l'exécution du workflow.

Liste des différents types de cible :

* Utilisateur fixe
* Liste fixe
* Site fixe
* Domaine fixe
* Utilisateur sélectionné
* Liste sélectionnée
* Site sélectionné
* Domaine sélectionné
* Utilisateur en cours
* Utilisateur des paramètres Assistant
* Liste des paramètres Assistant
* Programme externe
* Créateur de l'entité (ex : rédacteur d'un document)
* Utilisateur sélectionné dans une liste
* Responsable de la liste 1 (responsable de l'utilisateur qui est intervenu lors de l'étape précédente)
* Responsable de la liste 2
* Liste 1
* Liste 2
* Acteur de l'étape précédente du workflow exécuté
* Dernier acteur d'une étape nommée du workflow exécuté
* Utilisateur ou liste de la dernière diffusion pour un motif
* Responsable de la liste de la dernière diffusion pour un motif
* Responsable de la liste fixe

{% hint style="info" %}
Une étape ne peut pas exister sans liaison avec au minimum un déclencheur en Entrée et en Sortie (elle ne sera pas sauvegardée). Cela implique de créer un déclencheur après la création d'une tache et de les relier.
{% endhint %}

### Ajout d'un déclencheur

Un déclencheur doit nécessairement relier 2 tâches de la définition de workflow.

Cliquer sur Ajouter un déclencheur puis cliquer sur la tache de départ, maintenir le clic et le relâcher sur la tâche de destination.

Une fenêtre s'ouvre ensuite.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-f1c7d0670e9fca9355de004a7a7af163d15e11ea%2Fadmin-workflows-09.webp?alt=media" alt=""><figcaption></figcaption></figure>

Libellé : libellé du déclencheur (visible sous forme de bouton dans le parapheur)

Assistant : assistant qui sera lancé lors de l'exécution du déclencheur

Couleur : couleur du bouton correspondant à ce déclencheur dans le parapheur.

Message de confirmation : uniquement disponible dans le parapheur, affiche un message de confirmation après le clic sur le bouton.

Saisie des remarques : permet de saisir des remarques visibles uniquement par le destinataire (attention à ne pas confondre avec les remarques sur entité).

Traitement de masse : bascule le bouton sur l'écran principal des documents dans le parapheur.

Condition d'exécution : permet de filtrer l'exécution du déclencheur, utilisé en général en sortie d'étape automatique pour orienter le workflow.

* Aucune
* Autre tests non réalisés : s'exécute si aucun test n'est réalisé (autre)
* Test sur zone : réservé Odyssée Ingénierie
* Indexé par : s'exécute si l'entité est indexée par un descripteur d'un thésaurus
* Lié à un dossier type : s'exécute si l'entité est liée à un dossier de ce type

{% hint style="info" %}
Un nœud de départ ne peut avoir qu'un seul lien.
{% endhint %}

## Lancement d'un Workflow

A partir d'une fiche d'un document, utiliser le sous menu Workflow situé dans le menu Envoyer vers.

Une fenêtre s'ouvre permettant de sélectionner la définition de workflow souhaitée.

## Workflows en cours

### Par entité

Disponible uniquement dans le client riche pour le moment.

Pour visualiser les workflows concernant un document, dans la fiche du document, utiliser le menu Workflows en cours dans le menu Traitement.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-3096f0f0d3df937625fcebd84adc59253ceb527e%2Fadmin-workflows-10.png?alt=media" alt=""><figcaption></figcaption></figure>

Une fenêtre s'ouvre permettant de lister, tous les workflows concernant ce document.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-05f911465cb25dc05327bba1d369e808145a4cb0%2Fadmin-workflows-11.webp?alt=media" alt=""><figcaption></figcaption></figure>

Par défaut seuls les workflows en Cours sont affichés, mais il est possible à l'aide du menu déroulant de choisir ceux qui sont terminés ou en erreur.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-de49540546fca63102d0654b5a54d1ec98f92d3b%2Fadmin-workflows-12.png?alt=media" alt=""><figcaption></figcaption></figure>

Il est alors possible de visualiser l'avancement sous forme graphique, d'arrêter ou de supprimer un workflow.

### Par définition de workflow

Disponible uniquement dans le client riche uniquement pour les utilisateurs possédants les droits de création de définition de workflow.

Dans la section Administration – Paramétrage choisir Workflows.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-3e3eecf6fc89ba5ac58cfce657737c77cdc6e902%2Fadmin-workflows-13.webp?alt=media" alt=""><figcaption></figcaption></figure>

La liste des définitions de workflows apparaît.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-d1da2d7790548b65ed0f349e50674cc63ed38317%2Fadmin-workflows-14.webp?alt=media" alt=""><figcaption></figcaption></figure>

Faire un double clic sur la définition voulue.

L'onglet workflow liste les différents workflows associés à cette définition.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-e6c3f7beea0ca54799eacc47eabfc2202c003186%2Fadmin-workflows-15.webp?alt=media" alt=""><figcaption></figcaption></figure>

## Préférences d'affichage du parapheur

Accès via la section Administration – Paramétrage / Workflows (voir paragraphe précédent).

L'onglet paramètres permet de paramétrer la visibilité de certains éléments dans le parapheur.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-7157497ff35f29c0a1c93177da406948b67f160a%2Fadmin-workflows-16.webp?alt=media" alt=""><figcaption></figcaption></figure>

L'option Etat d'affichage en liste permet de changer l'affichage des documents dans le parapheur en se basant sur un état.

## Préférences client riche

Disponible uniquement dans le client riche.

Menu préférence utilisateur.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-c3e792a4e836bc42f469681ec4be145b08c35f75%2Fadmin-workflows-17.webp?alt=media" alt=""><figcaption></figcaption></figure>

Afficher les parapheurs Workflow : affiche les tuiles correspondantes aux workflows, un clic sur la tuile permet de lancer le parapheur riche.

Afficher les indicateurs Workflow : affiche les tuiles correspondantes aux indicateurs, un clic sur la tuile ouvre une fenêtre listant les workflows.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://documentation.efalia.com/produit/acropolis/administration/workflows.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
