Exécuter un workflow
Vous pouvez lancer l’exécution complète d’un workflow en cliquant sur l’icône d’exécution dans la hiérarchie Workflows, ou en sélectionnant Run All dans le menu Actions d’un workflow donné.
Vous pouvez également cliquer sur le bouton Toggle Start/Stop en haut de la table des workflows. Ce bouton à bascule arrête un workflow en cours d’exécution ou démarre un workflow.
Si vous cliquez sur Exécuter pour un workflow déjà en cours d’exécution, PlaidCloud vous en informe au lieu de lancer une seconde exécution.
Choisir un mode d’écriture
Section intitulée « Choisir un mode d’écriture »Chaque exécution porte un mode d’écriture ERP. Pour en choisir un dans PlaidCloud, utilisez Exécuter avec le mode d’écriture dans le menu contextuel d’un workflow, ou le bouton de mode d’exécution sur le canevas du workflow. Un simple Démarrer le workflow ou Exécuter le workflow demande le mode Réel, toujours soumis au plafond du projet décrit plus bas. Vous pouvez aussi choisir le mode au lancement d’une exécution via l’API d’exécution ou l’assistant.
| Mode | Ce qui se passe |
|---|---|
| Réel | Les étapes d’écriture comptabilisent exactement comme elles l’ont toujours fait. C’est le mode par défaut. |
| Simulation | Chaque étape d’écriture ERP construit et valide exactement ce qu’elle comptabiliserait, puis ne valide rien et ne contacte jamais l’ERP. Les écritures qui auraient été comptabilisées sont enregistrées pour que vous puissiez les examiner avant d’exécuter en mode Réel : celles d’une étape Comptabiliser des documents dans le Registre des écritures sous Serait comptabilisé (consultez Comptabiliser des documents dans les systèmes ERP), celles de l’étape de comptabilisation propre à un système dans l’historique des écritures ERP, marquées comme simulées. |
| Désactivé | Les étapes d’écriture sont ignorées en totalité. |
Un projet porte également son propre plafond de mode d’écriture, défini via l’API du projet ou l’assistant par tout membre disposant d’un accès en écriture à un projet déverrouillé. Le plafond ne peut que rendre une exécution plus sûre, jamais plus permissive : le mode effectif d’une exécution est le plus restrictif entre le mode que vous avez choisi et le plafond du projet. Un projet plafonné à Simulation reste donc simulé, même si vous lancez l’exécution en mode Réel.
Un événement planifié conserve son propre mode d’écriture : une planification réglée sur Simulation s’exécute donc en simulation à chaque déclenchement.
Le mode se propage à tout ce que l’exécution touche. Un sous-workflow, une macro et une étape Run Model, Conditional Run Model ou Loop Model héritent tous du mode de l’exécution parente, tout comme une exécution que vous reprenez après un arrêt : une exécution simulée ne peut comptabiliser réellement nulle part à l’intérieur d’elle-même.
Autoriser le projet à comptabiliser
Section intitulée « Autoriser le projet à comptabiliser »Une exécution de workflow comptabilise dans un ERP en tant que projet, et non en tant que personne qui l’a lancée. Avant qu’une exécution puisse comptabiliser, le projet a besoin d’une autorisation pour chaque connexion et chaque environnement ERP utilisés par ses étapes d’écriture. Sans autorisation, l’étape échoue avec le message « This project isn’t authorized to post to connection … », qui nomme la connexion et l’environnement. Les étapes Call SAP Financial Document Attachment, Call SAP Master Data Table RFC et Call SAP RFC n’en ont pas besoin.
Pour autoriser un projet, ouvrez sa page d’accueil et sélectionnez Autorisations d’écriture ERP sous Écriture ERP. Chaque ligne correspond à une connexion dans un environnement. Cochez Autorisé pour permettre au projet de comptabiliser à cet endroit, ou décochez-le pour l’en empêcher. Autorisé par et Autorisé le indiquent qui a autorisé la connexion en dernier et quand.
- Le bouton est affiché aux Architectes du projet et aux administrateurs de l’espace de travail, mais seul un Architecte peut modifier une autorisation, et seulement tant que le projet est déverrouillé. Un administrateur de l’espace de travail qui n’est pas Architecte peut d’abord s’ajouter lui-même comme Architecte.
- Sélectionner une ligne pour autoriser ou retirer une autorisation ne recharge pas la liste : la position de défilement et le tri de colonne que vous avez choisi sont conservés. La fenêtre peut être redimensionnée, et la remarque sur les projets publics s’affiche en entier.
- Pour autoriser une connexion, vous devez aussi disposer vous-même d’un accès en écriture à celle-ci : vous en êtes propriétaire, ou elle est partagée avec vous nommément ou via l’un de vos groupes de sécurité. Une connexion définie sur Tous les membres de l’espace de travail n’est pas prise en compte.
- Un projet défini sur Tous les membres de l’espace de travail est autorisé comme n’importe quel autre. Chaque membre en est Architecte : tout membre disposant d’un accès en écriture à une connexion peut donc autoriser le projet à l’utiliser. Une fois le projet autorisé, n’importe quel membre peut comptabiliser sur cette connexion à partir des workflows du projet, et la fenêtre l’indique au-dessus de la grille.
- Une nouvelle copie privée, créée avec des données de table ou des membres de dimension, conserve les autorisations de la source que vous pourriez accorder vous-même, et arrive en mode Simulation si la source était en mode Réel. Voir Autorisations d’écriture ERP dans la copie. Toute autre copie, ou un projet créé à partir d’une archive de projet, démarre sans aucune autorisation. Autorisez-le avant qu’il comptabilise.
Suivre l’état d’une étape
Section intitulée « Suivre l’état d’une étape »Pendant l’exécution d’un workflow, chaque étape affiche une icône d’état indiquant où elle en est, ainsi que depuis combien de temps elle s’exécute. Survolez l’icône pour afficher le message correspondant.
| État | Signification |
|---|---|
| En attente | L’étape est en file d’attente et n’a pas encore démarré. |
| En cours | L’étape est en train de s’exécuter et sa durée augmente au fil du temps. |
| Terminée | L’étape s’est terminée avec succès. |
| Avertissement | L’étape s’est terminée, mais a signalé un point qui mérite d’être lu dans le journal du workflow. |
| Erreur | L’étape a échoué. Voir Gérer les erreurs d’étape. |
| Ignorée | L’étape a été passée : elle est désactivée, ou ses conditions d’exécution n’étaient pas remplies. Voir Ignorer des étapes dans un workflow. |
| Poursuivie | L’étape a échoué mais est configurée pour continuer en cas d’erreur, de sorte que le workflow a poursuivi. Voir Continuer en cas d’erreur. |
| Arrêtée | L’exécution a été arrêtée avant que l’étape puisse se terminer. |
| Abandonnée | L’exécution de l’étape a été interrompue et ne se terminera jamais. Reprenez l’exécution ou relancez le workflow. |
Une vue de workflow ouverte s’actualise d’elle-même à mesure que l’exécution progresse : les états affichés restent à jour sans recharger la page.
Étapes abandonnées
Section intitulée « Étapes abandonnées »Une étape est marquée abandonnée lorsque ce qui l’exécutait a disparu en cours d’exécution, le plus souvent parce que quelqu’un a appuyé sur Arrêter, ou parce qu’une maintenance de la plateforme a interrompu l’exécution. La durée de l’étape cesse d’augmenter et l’infobulle d’état explique ce qui s’est passé.
Une étape abandonnée ne s’est pas terminée et n’a produit aucune sortie. Ce n’est pas une étape lente, et ce n’est pas un problème lié à vos données ou à votre configuration.
Pour reprendre le travail, vous pouvez soit Reprendre l’exécution, auquel cas l’étape abandonnée est exécutée de nouveau, soit relancer le workflow entier. Les deux options sont sûres.
Étapes interrompues
Section intitulée « Étapes interrompues »Si le serveur qui exécute une étape est perdu en cours d’exécution, PlaidCloud réexécute automatiquement l’étape lorsqu’il est sûr de la répéter : une étape qui remplace sa sortie aboutit au même résultat qu’une seule exécution propre, et vous n’avez donc rien à vérifier. Le journal de l’étape affiche un avertissement à l’endroit où commence la seconde tentative : « Restarted: the server running this step stopped before it finished (e.g. out of memory or a restart); running it again from the start. »
Une étape qui ne peut pas être répétée sans risque n’est pas réexécutée. Elle échoue une seule fois avec un message Interrompu, car l’exécuter une seconde fois pourrait dupliquer ce que la première tentative a déjà écrit. Les étapes qui écrivent des sorties dont le nom ou le chemin contient {date} ou {date_iso} sont considérées comme non sûres à répéter, puisqu’une réexécution pourrait tomber à une autre date. Pour récupérer, vérifiez dans la cible de l’étape ce que la première tentative a écrit, nettoyez-la si nécessaire, puis réexécutez l’étape ou Reprenez l’exécution.
Étapes qui ne démarrent jamais
Section intitulée « Étapes qui ne démarrent jamais »Pendant qu’une étape attend un worker, son message d’état indique « Waiting for a worker… N min. No import worker has picked this step up yet. » (le type de worker correspond à l’étape, par exemple import ou export). Le message disparaît dès que le travail démarre.
Si le job d’une étape ne peut jamais démarrer, l’étape échoue en indiquant la raison au lieu d’attendre indéfiniment :
| Cause | Échoue après environ |
|---|---|
| Aucun worker ne prend en charge le job d’une étape d’importation ou de dimension | 40 minutes |
| Le pod de l’étape reste bloqué à l’état Pending | 20 minutes |
| L’image de l’étape ne peut pas être récupérée | 5 minutes |
| Aucun pod n’est créé pour l’étape | 20 minutes |
| Aucun runner ne prend en charge une synchronisation de connecteur (Singer) | 30 minutes |
Le message de synchronisation de connecteur nomme la synchronisation. Si un worker a démarré le job puis a disparu, l’étape échoue également, avec un message indiquant que le worker s’est arrêté. Les messages d’importation et de dimension indiquent « Use Run from here to retry. »
Exécutions qui ne répondent plus
Section intitulée « Exécutions qui ne répondent plus »Une exécution ne reste jamais En cours d’exécution une fois que le travail qui la sous-tend a disparu. Si le serveur qui exécute le workflow est perdu, l’exécution se termine en échec. Une exécution peut durer au plus 12 heures : une exécution encore en cours à ce moment-là échoue avec le message « Run failed: still running at the 12-hour limit. Re-run the workflow. »
Suspendre, arrêter et reprendre
Section intitulée « Suspendre, arrêter et reprendre »Pendant l’exécution d’un workflow, vous pouvez le Suspendre, de sorte que les étapes en cours se terminent et que les nouvelles étapes attendent, ou l’Arrêter, ce qui annule les étapes en file d’attente ainsi que les jobs d’importation ou d’exportation encore en cours, ainsi que la requête d’entrepôt qu’une exportation était en train de lire. Les étapes d’importation et de dimension encore en file d’attente sont annulées proprement, afin de ne pas retarder les importations et chargements de dimension suivants dans l’espace de travail. L’arrêt interrompt aussi les synchronisations de connecteur (Singer) du workflow, en file d’attente ou en cours, de sorte qu’une synchronisation ne continue pas de s’exécuter après l’arrêt du workflow.
Une macro peut s’exécuter à plusieurs endroits à la fois, appelée par d’autres workflows ou par une étape Macro : exécution parallèle. Arrêter la macro arrête toutes ses copies en cours d’exécution. Arrêter une seule copie n’arrête que cette copie et ce qu’elle a lancé, et laisse le workflow qui l’a appelée continuer de s’exécuter, tout comme une étape Macro Concurrent qui abandonne une copie qui ne répond plus. Une macro qui ne s’exécute qu’au sein d’autres workflows apparaît comme En cours d’exécution dans la liste des workflows, avec Arrêter disponible, et son ouverture affiche l’état, l’heure de début et l’heure de fin de chaque étape lors de sa dernière exécution.
Reprendre relance une exécution suspendue, arrêtée ou en échec là où elle s’était interrompue, au lieu de repartir de zéro. L’action est disponible chaque fois que la dernière exécution d’un workflow s’est terminée à l’état suspendu, arrêté ou en erreur.
Ce que signifie « là où elle s’était interrompue » dépend de la manière dont le workflow s’exécute :
| Exécution | À la reprise |
|---|---|
| Série | Redémarre à l’étape qui s’exécutait à la fin de l’exécution, puis continue à partir de là. Si cette étape se trouve dans un groupe, Reprendre relance l’ensemble du groupe de premier niveau qui la contient : les étapes du groupe déjà terminées avec succès sont laissées de côté, les autres sont exécutées, et l’exécution se poursuit après le groupe. |
| Parallèle | Réexécute chaque étape qui ne s’était pas encore terminée avec succès et laisse de côté les étapes terminées. |
| Avancée (graphe) | Réexécute le nœud en échec et tout ce qui attend encore après lui, et laisse de côté les nœuds terminés. |
Les étapes qui appellent un autre workflow (Run Model, Conditional Run Model et Loop Model) reprennent le workflow qu’elles appellent au lieu de le redémarrer, quel que soit le nombre de niveaux d’imbrication. Une étape de boucle reprend l’itération qui avait été interrompue et saute les itérations déjà terminées.
Lorsque vous reprenez un workflow qui s’est exécuté comme enfant imbriqué d’un autre (appelé par une étape Run Model d’un parent), PlaidCloud propose Reprendre depuis le début de la chaîne. Reprendre l’enfant seul ne peut pas poursuivre l’orchestration du parent. Cette option reprend donc le parent de niveau supérieur, c’est-à-dire la racine de la chaîne, et poursuit toute la chaîne là où elle s’était arrêtée. La reprise d’un workflow de niveau supérieur reste inchangée. Le début de la chaîne est déterminé au sein du même projet : une chaîne qui passe dans un autre projet reprend depuis le début de la portion située dans le projet.
Reprendre poursuit toujours l’exécution d’origine. Il réexécute chaque étape de cette exécution qui ne s’est pas terminée avec succès (une étape en échec ou abandonnée est réexécutée, et non considérée comme terminée), et réexécuter entre-temps une étape individuelle seule ne change pas ce que Reprendre prendra en charge ensuite. Cela vaut aussi pour un workflow enfant : si vous avez réexécuté seule l’une de ses étapes, la reprise du parent exécute quand même tout ce qu’il restait à l’enfant, et pas seulement cette étape.
Une exécution reprise est enregistrée comme une nouvelle exécution dans l’historique des exécutions du workflow, et ne contient que les étapes qu’elle a réexécutées. L’exécution d’origine conserve sa propre entrée d’historique. Lorsqu’une même exécution appelle plusieurs fois le même workflow enfant, chaque appel dispose de sa propre entrée dans l’historique des exécutions de l’enfant. Les itérations d’une étape de boucle comptent comme un seul appel.