Références des flux
Donnez à chaque process flow une référence unique, générée à partir d'un format, saisie au démarrage ou transmise par un autre système, et découvrez ce qui se passe quand le même numéro est renvoyé.
Un process flow peut porter une référence, par exemple TV-2026-0042 ou EL-24-118734. Elle figure sous le nom du flux dans la barre de titre, dans la première colonne de la liste des flux, et en tête de chaque titre de notification et objet d'e-mail envoyé par le flux ([TV-2026-0042] Votre permis). La recherche de la liste des flux trouve un flux par sa référence comme par son nom.
Une référence est unique au sein d'un environnement d'espace de travail, et chaque environnement compte de son côté : le développement et la production peuvent utiliser les mêmes numéros, et la production n'est jamais influencée par un bac à sable.
Configuration
La référence est configurée une seule fois pour toute l'organisation, par un administrateur de l'organisation, dans la fiche de l'extension sous Platform › Paramètres › Extensions. L'onglet Configuration de la fiche comporte une étape Vérifier la référence, et l'onglet Contenu affiche une ligne par process flow avec sa référence. Tant que personne ne la modifie, la configuration est celle que suggère l'extension (voir Suggérer une référence dans votre extension).
| Origine de la référence | Ce qui se passe |
|---|---|
| Générée | Chaque flux reçoit le numéro suivant selon un format. {YYYY}, {YY} et {MM} correspondent à la date de démarrage ; les zéros de {0000} sont le compteur, qui recommence chaque année, chaque mois ou jamais. {WS} est le code de l'espace de travail (RB) : avec lui, chaque espace de travail compte de son côté ; sans lui, toute l'organisation compte ensemble. |
| Saisie au démarrage | La personne qui démarre le flux la saisit dans la boîte de dialogue de démarrage. Un exemple s'affiche dans le champ vide. L'administrateur choisit si un flux peut démarrer sans référence. |
| D'un autre système | Le système qui démarre le flux envoie son propre numéro dans une valeur de démarrage. L'administrateur choisit les systèmes qu'un espace de travail peut utiliser, avec un système par défaut : une connexion, ou un système qui n'est pour l'instant qu'un nom. Un lien contenant {reference} fait renvoyer les Détails du flux vers la page de ce système. |
| Pas nécessaire | Les flux ne sont connus que par leur nom. |
L'administrateur choisit aussi ce que les espaces de travail peuvent modifier : pour un numéro provenant d'un autre système, lequel des systèmes autorisés le fournit, et si un numéro est obligatoire. Le format et le compteur ne sont jamais modifiables par un espace de travail.
Les administrateurs de l'espace de travail voient la configuration sur la page Extensions : le menu ⋯ d'un process flow activé indique Voir la référence… quand rien ne peut être modifié, ou Gérer la référence… quand quelque chose peut l'être. Un champ modifié est signalé et peut revenir au paramètre de l'organisation.
La modification d'un format ne concerne que les flux démarrés ensuite ; les flux qui ont déjà un numéro le conservent.
Un numéro généré n'est jamais attribué deux fois : supprimer un flux laisse donc un trou dans la numérotation. La fiche Référence de l'organisation liste chaque numéro de production supprimé sous Numéros supprimés, avec qui l'a supprimé, quand, et dans quel espace de travail. Un numéro saisi au démarrage ou envoyé par un autre système y figure aussi.
Codes d'espace de travail
Chaque espace de travail partagé a un code, que reprend un format avec {WS} : 2 à 5 lettres majuscules ou chiffres, unique dans l'organisation. La création d'un espace de travail en demande toujours un, prérempli à partir du nom, qu'un format utilise déjà {WS} ou non ; un espace de travail créé sans code (via l'API, ou celui avec lequel démarre une nouvelle organisation) reçoit le premier code libre suggéré par son nom. Le tableau des espaces de travail de l'organisation affiche toujours chaque code, avec un code suggéré à accepter pour les espaces de travail plus anciens. Un espace de travail sans code n'est jamais bloqué : ses flux sont numérotés avec un code vide jusqu'à ce qu'un code soit défini. Un administrateur de l'organisation accepte ou modifie un code dans le tableau des espaces de travail, et un administrateur de l'organisation ou le propriétaire de l'espace de travail le modifient dans l'onglet Paramètres de la page Gérer de l'espace de travail, qui affiche toujours le code. Une modification y indique son effet avant l'enregistrement ; dès que des numéros portent un code, le tableau l'affiche comme verrouillé, et une modification laisse ces numéros tels quels : seuls les nouveaux flux reçoivent le nouveau code. Créer un espace de travail depuis le menu des espaces de travail du menu latéral demande le code de la même façon.
Suggérer une référence dans votre extension
Une extension suggère un point de départ dans template.reference. Ce champ est facultatif : une extension qui ne le renseigne pas demande à l'administrateur de l'organisation d'en configurer une, et chaque flux démarre quand même.
template: {
// …
reference: { kind: "format", format: "SEC-{WS}-{YYYY}-{0000}", restart: "yearly" },
// ou : { kind: "external", startValueKey: "zaaknummer", allowWithout: false }
// ou : { kind: "not-needed" }
},kind | Champs |
|---|---|
format | format (doit contenir un compteur comme {0000}), restart : never, yearly (par défaut) ou monthly |
external | startValueKey, une valeur de démarrage que le modèle déclare dans attributes ; allowWithout (par défaut false) |
not-needed | aucun |
La suggestion devient la configuration de l'organisation lorsque le process flow de l'extension est installé. Une version plus récente de l'extension la met à jour jusqu'à ce que l'administrateur de l'organisation enregistre la sienne ; à partir de ce moment, le choix de l'administrateur est conservé.
Démarrer un flux
La boîte de dialogue de démarrage affiche un champ Référence sous Modèle :
- une référence générée affiche, en lecture seule, le numéro que le flux recevra le plus probablement ;
- une référence saisie est un champ de texte ;
- un numéro provenant d'un autre système porte le nom de ce système (« numéro e-loket »), et sa valeur de démarrage n'est pas demandée une seconde fois.
Un numéro qu'un autre flux de l'environnement possède déjà est refusé, avec le nom de ce flux. Si un numéro généré ne peut pas être créé pour l'instant (Scrydon n'a pas pu lire l'environnement ou le code de l'espace de travail), le flux ne démarre pas et la boîte de dialogue invite à réessayer.
Si la connexion est coupée après Create, la boîte de dialogue renvoie le démarrage une fois. Scrydon le reconnaît comme le même démarrage et répond avec le flux créé par la première tentative : aucun deuxième flux n'est démarré, et une référence saisie n'est pas refusée comme déjà utilisée par ce flux. Il en va de même si vous rechargez la page et relancez le démarrage avec les mêmes valeurs dans le même onglet du navigateur. Si vous modifiez quoi que ce soit dans la boîte de dialogue, il s'agit d'un nouveau démarrage. Lorsque le flux existait déjà depuis un Create précédent, la boîte de dialogue indique que le flux avait déjà été démarré au lieu de le dire créé ; si aucune réponse ne revient, elle vous demande de réessayer, ce qui est sans risque pour la même raison.
Un client qui démarre des flux par l'API (POST /api/process-flows) obtient la même protection en envoyant un en-tête Idempotency-Key (16 à 128 lettres, chiffres, - ou _, par exemple un UUID aléatoire) et en renvoyant la requête avec la même clé. La répétition répond 200 avec l'id du flux et deduped: true au lieu de 201. Une clé appartient à la personne qui l'a envoyée et vaut jusqu'à la fin du flux. La même clé pour un autre modèle est refusée (409, idempotency_key_template_mismatch), et une clé mal formée avec 400 (invalid_idempotency_key).
Une clé désigne exactement une requête. Seul le modèle est vérifié lors d'une répétition : renvoyer la même clé avec un autre nom ou d'autres entrées répond avec le premier flux, inchangé, et ne démarre rien. Créez une nouvelle clé dès que la requête change, et ne réutilisez une clé que pour renvoyer la requête identique.
Détails
Détails, en premier dans le menu ⋯ de la barre de titre, affiche le nom du flux, sa référence, son modèle, ainsi que la personne qui l'a démarré et quand. Toute personne autorisée à modifier le flux peut le renommer, corriger une référence saisie ou ajouter une seule fois à la main une référence manquante. Un numéro généré et un numéro provenant d'un autre système ne peuvent pas être modifiés. Chaque modification est inscrite dans l'Activité du flux.
Le même numéro renvoyé
Lorsqu'un workflow démarre un flux avec un numéro externe qu'un flux du même type possède déjà, aucun second flux n'est démarré :
- Le flux existant conserve la nouvelle demande sous Comment tout a commencé, marquée Renvoyée, en ne listant que les valeurs de démarrage qui ont changé. La première demande reste repliée en dessous.
- Ses valeurs de démarrage ne sont jamais écrasées : les étapes déjà exécutées conservent ce qu'elles ont utilisé.
- Le responsable du dossier est notifié (Renvoyée dans ses notifications). Tant que les modèles ne désignent pas de responsable de dossier, il s'agit du propriétaire de la première étape attribuée du flux.
- Un flux déjà terminé reste fermé. Une note au-dessus de Comment tout a commencé propose En démarrer un nouveau flow, qui ouvre la boîte de dialogue de démarrage avec les valeurs de la demande déjà remplies, pour les personnes autorisées à démarrer des flux de ce type.