Aller au contenu

Vérifier la préparation avant une clôture

Les jours qui comptent le plus (fin de mois, remise d’une prévision, dossier de conseil d’administration), la question n’est pas « qu’est-ce que Weave a remarqué ? » mais « sommes-nous prêts ? ». Un ensemble de préparation désigne les workflows dont dépend une échéance, et la sélection de l’ensemble répond à cette question pour tous à la fois, dans une seule liste de contrôle qui s’ouvre sur son propre décompte :

11 of 13 ready; 1 not ready; 1 couldn’t check.

Chaque workflow de l’ensemble reçoit l’une des trois réponses, la pire de ses lignes. Il est Pas prêt lorsqu’un contrôle a détecté un problème ; le problème est alors listé en dessous avec les mêmes boutons Corriger, Aller à et Comment Weave le sait que dans l’onglet Weave. Sinon, il est Vérification impossible lorsqu’un contrôle n’a eu aucun moyen de le juger, et la raison est indiquée en toutes lettres. Il n’est Prêt que lorsque chaque contrôle que Weave a pu exécuter dessus a réussi. Tout ce que Weave n’a pas jugé n’est jamais présenté comme prêt, à une exception près : une dernière exécution disposant de trop peu d’historique antérieur pour être comparée est considérée comme habituelle, comme décrit ci-dessous.

Un problème que quelqu’un a marqué comme attendu rend tout de même sa ligne Pas prêt, et la ligne précise qu’il a été marqué comme attendu. L’onglet Weave cesse de signaler un tel problème ; la liste de contrôle, elle, dit toujours ce qui est vrai.

Les contrôles sont les règles que Weave exécute déjà. Pour savoir ce que ces règles lisent et ce que signifient leurs réponses, consultez Ce que Weave vérifie.

  1. Ouvrez l’onglet Weave du projet et cliquez sur Préparation sous Close checks dans le rail Monitor.
  2. Cliquez sur Nouveau. Donnez un nom à l’ensemble, par exemple « Clôture de fin de mois », et cochez les workflows dont il dépend. Saisissez du texte dans la zone de filtre pour retrouver un workflow, ou utilisez Affecté pour ne voir que ceux qui font déjà partie de l’ensemble.
  3. Cochez éventuellement A une échéance et indiquez quand l’ensemble est dû, sous forme d’expression cron et du fuseau horaire dans lequel elle est écrite, avec les mêmes choix que pour un événement planifié. 0 9 5 * * correspond à 09:00 le 5 de chaque mois, et 0 8 * * 1 à 08:00 chaque lundi, dans ce fuseau horaire. Les décalages sont interprétés comme le fait un événement planifié : UTC +0 correspond à l’heure de Londres, heure d’été britannique comprise, certains autres décalages suivent l’heure d’été d’un lieu situé à ce décalage et les autres sont fixes. La page Event Scheduler indique comment chaque décalage est interprété.
  4. Pour un ensemble doté d’une échéance, sous Tell the owner this many hours before it is due, indiquez combien de temps avant l’échéance Weave doit envoyer son message, de 1 à 168 heures. La valeur par défaut est 24.
  5. Cliquez sur Enregistrer.

Un ensemble appartient au projet, et toute personne disposant de Monitor dans l’onglet Weave du projet peut le vérifier. Seul un Architecte du projet peut créer, modifier ou supprimer un ensemble, et chaque workflow d’un ensemble doit appartenir à ce projet. La dernière personne à avoir enregistré un ensemble en est le propriétaire. Deux personnes qui modifient le même ensemble en même temps sont tenues séparées : le second enregistrement est refusé, l’ensemble est relu, et le formulaire affiche la copie la plus récente avec la raison.

Lorsqu’un projet n’a aucun ensemble de préparation et que ses workflows s’exécutent selon une planification mensuelle, Constatations suggère un ensemble constitué à partir de ces planifications. Un Architecte du projet peut cliquer sur Make this your month-end set sur celui-ci pour l’enregistrer.

Weave ne peut considérer une table d’entrée comme à jour que si quelque chose indique quand elle aurait dû être écrite : une planification sur le workflow qui l’écrit, ou un seuil de fraîcheur sur la table. Définissez-les d’abord, faute de quoi la première ligne de la plupart des workflows indiquera Vérification impossible.

La fenêtre Préparation avec un ensemble de clôture de fin de mois, un workflow prêt et un workflow pas prêt

Sélectionnez un ensemble à gauche. Weave lit l’ensemble du projet, avec la même lecture que celle de l’onglet Weave, et juge chaque workflow de l’ensemble. Cliquez sur Revérifier après avoir corrigé quelque chose.

Chaque élément affiche le nom du workflow, son verdict et une ligne par contrôle qui s’y applique. Lorsqu’une ligne indique Vérification impossible, la raison est écrite en toutes lettres à côté ; voici les raisons que vous rencontrerez le plus probablement :

Ligne Ce que Weave compare Raisons courantes d’une « vérification impossible »
Inputs are fresh Chaque table que le workflow lit, par rapport aux planifications des workflows qui l’écrivent ou au seuil de fraîcheur propre à la table. Votre rôle ne peut pas lire les tables ; Weave n’a pas pu déterminer quelles tables il lit, ou il n’en lit aucune que Weave puisse suivre ; une table qu’il lit vous est masquée ; une étape lit une table que Weave ne peut pas déterminer, par exemple une table choisie avec une variable ; une table qu’il lit n’a ni écrivain planifié ni seuil de fraîcheur, donc rien n’indique quand elle aurait dû être écrite ; le workflow qui l’écrit est en cours d’exécution, en file d’attente ou vient de se terminer.
Last run succeeded L’exécution la plus récente du workflow, qui doit être terminée. Une exécution en échec est Pas prêt. Il n’a aucune exécution enregistrée, son historique d’exécutions n’a pas pu être lu, ou sa dernière exécution a été arrêtée ou est toujours en cours.
Last run looked usual La durée de la dernière exécution, le nombre de lignes que ses tables contenaient ensuite, le nombre de valeurs vides qu’elles contenaient et la répartition de leurs valeurs, par rapport aux exécutions précédentes. La dernière exécution a échoué, a été arrêtée ou est toujours en cours, il n’y a donc rien d’habituel à comparer ; l’accès aux lignes s’applique à une table qu’elle a écrite, de sorte que les valeurs de cette table ne sont pas comparées ; l’exécution comprend des étapes que votre rôle ne peut pas voir.
Inputs unchanged since it last ran Si une table qu’il lit a été modifiée par un autre workflow après sa dernière lecture. Votre rôle ne peut pas lire les tables ; Weave ne peut pas suivre ce que le workflow lit ; ou le workflow n’a aucune exécution avec laquelle comparer.
Schedule is healthy Ses événements planifiés : calendriers valides, synchronisés avec le planificateur, aucune exécution due manquée, aucune échéance perdue à cause d’une exécution toujours en cours. Le planificateur n’a pas pu être lu.
Reconciliations tie out Chaque rapprochement lié au workflow, dans sa version approuvée, exécuté sous votre identité. L’un d’eux n’a pas encore été approuvé ; votre rôle ne peut pas lire les données des tables ; l’accès aux lignes ne vous montre qu’une partie des lignes d’un côté ; une table ou une colonne qu’il utilise a changé ; la liste de contrôle a manqué de temps pour les traiter.

Un workflow sans événement planifié n’a pas de ligne Schedule is healthy, et l’élément indique qu’il n’est pas planifié. Un workflow sans rapprochement lié n’a pas de ligne Reconciliations tie out. C’est une propriété du workflow, pas quelque chose que Weave n’a pas réussi à vérifier.

Un workflow supprimé du projet depuis la création de l’ensemble, ou que votre rôle ne peut pas voir, est tout de même compté. Il apparaît comme Vérification impossible avec la raison, de sorte que le décompte ne diminue jamais discrètement.

Une exécution ne peut sembler inhabituelle que par rapport à des exécutions précédentes. Lorsque Weave dispose de trop peu d’historique antérieur à comparer, Last run looked usual considère l’exécution comme habituelle et l’indique. Cela couvre un workflow ou une étape nouveaux, un workflow qui s’exécute trop rarement pour avoir assez d’exécutions au cours des 30 derniers jours, comme un workflow hebdomadaire, et une exécution qui a été la première à remplir une table :

Weave has too little earlier history to compare its last run with, so it counts as usual.

Lorsqu’une partie de l’exécution a pu être comparée, la ligne nomme ce qui se situait dans sa plage habituelle et ajoute « Where Weave has too little earlier history to compare with, it counts as usual. » L’onglet Weave continue de les lister comme des contrôles que Weave n’a pas pu effectuer. Un workflow qui n’a jamais été exécuté reste Vérification impossible sur ses deux lignes Last run succeeded et Last run looked usual, tout comme celui dont la dernière exécution a été arrêtée ou est toujours en cours.

Pour un ensemble doté d’une échéance, Weave exécute le contrôle de lui-même à l’approche de l’échéance et avertit le propriétaire de l’ensemble (la dernière personne à l’avoir enregistré), une seule fois pour chaque échéance de l’ensemble, par un message dans l’application :

“Month-end close” is due in 3 days (31 Oct 17:00 UTC): 11 of its 13 workflows ready, 1 not ready, 1 Weave couldn’t check.

Cliquez sur Ouvrir Weave dans le message pour ouvrir l’onglet Weave du projet et la liste de contrôle de cet ensemble. Le message ne contient que des décomptes ; les noms et les raisons figurent dans la liste de contrôle. Il reste à l’écran pendant 30 secondes et n’est affiché que si le propriétaire est connecté à ce moment-là ; il n’est pas renvoyé pour cette échéance, mais la liste de contrôle est toujours disponible dans la fenêtre. Si le propriétaire ne peut plus ouvrir le projet, rien n’est envoyé.

Weave vérifie une fois par heure : le message arrive donc dans l’heure qui suit le moment du préavis ; avec un préavis de 24 heures, dans l’heure qui suit les 24 heures précédant l’échéance. Un ensemble enregistré après le moment de son préavis est averti lors du contrôle suivant. Si un contrôle démarre en retard et que l’échéance passe avant son exécution, ce contrôle avertit tout de même le propriétaire, par « was due 20 minutes ago », sauf si l’ensemble a été enregistré après l’échéance. Le contrôle s’exécute sous l’identité du propriétaire et ne lit les tables que si le propriétaire pouvait les lire lorsqu’il a enregistré l’ensemble pour la dernière fois.

Pour un ensemble enregistré doté d’une échéance, Weave effectue un contrôle de clôture : il parcourt l’ensemble de lui-même, prépare ce qu’il peut et ne vous laisse que les décisions. Il contrôle l’ensemble :

  • une fois par jour, à l’heure d’échéance de l’ensemble ;
  • après la fin d’une exécution qui a écrit une table que l’ensemble lit ;
  • après la fin d’une modification que vous avez approuvée depuis la clôture ; et
  • lorsque le propriétaire de l’ensemble clique sur Check now.

Tant que l’ensemble se trouve dans son délai de préavis avant l’échéance, une carte au-dessus de Constatations donne le dernier contrôle, par exemple Month-end close is 92% done. Two things need you., avec l’heure à laquelle il a été effectué. Le chiffre est la part des lignes de l’ensemble qui sont prêtes ; il n’atteint donc 100 % que lorsque chaque ligne est prête. En dessous, chaque décision est numérotée :

  • Une exécution en échec comporte la correction que Weave a préparée pour elle.
  • Une entrée qui n’est pas à jour, ou qui a changé, comporte un plan pour ré-exécuter le workflow qui l’écrit, puis celui qui la lit, par exemple Re-run “Load GL”, then “Allocate Costs”, avec la portée des ré-exécutions.
  • Une exécution planifiée qui n’a pas démarré comporte Run “Load GL” now.
  • Un chiffre en dehors de sa plage habituelle, ou un rapprochement qui ne concorde pas, est une question qui vous est posée, avec Ask Weave about this et C’est attendu, car Weave n’a aucune correction prête pour ce cas.

Cliquez sur Ouvrir sur une décision pour voir sa carte sur place, et approuvez-la à cet endroit avec Approuver, sur le web. Chaque carte couvre un seul plan, et chaque exécution qu’elle lance a la comptabilisation ERP désactivée. Il n’existe pas d’approbation globale. Un workflow qui attend son exécution planifiée est listé sans numéro. Pourquoi liste ce que Weave n’a pas pu contrôler, et les décisions prises par quelqu’un d’autre sont comptées, pas listées.

Lors du contrôle quotidien, lorsque des décisions attendent ou que l’ensemble arrive à échéance ce jour-là, le propriétaire est averti dans PlaidCloud et sur son téléphone, par exemple Weave needs you: Month-end close is 92% done. Two things need you. Le contrôle apparaît aussi dans les tâches du dock sous la forme Close check: suivi du nom de l’ensemble. Les contrôles effectués après une exécution mettent à jour la carte sans avertir personne.

  • Un contrôle de clôture appartient à la dernière personne qui a enregistré l’ensemble et s’exécute sous son identité. Il s’arrête si elle ne peut plus ouvrir le projet.
  • Seul le propriétaire peut cliquer sur Check now.
  • Toute personne qui peut lire la liste de contrôle voit l’avancement de la clôture. Ses décisions sont affichées au propriétaire et à toute personne dont le rôle permet d’exécuter les workflows.
  • Le contrôle lui-même ne modifie rien et n’exécute jamais une étape qui écrit en dehors de PlaidCloud.

Les ensembles de préparation sont disponibles via l’API de la plateforme sous /analyze/weave/readiness : GET /sets liste les ensembles d’un projet, GET /set, POST /set, PUT /set et DELETE /set en lisent, créent, remplacent et suppriment un, et GET /check renvoie la liste de contrôle telle que la fenêtre l’affiche, avec les constats de chaque ligne. Un ensemble lu via l’API porte un etag ; renvoyez-le en tant que if_match sur PUT pour faire refuser une modification par-dessus un enregistrement plus récent. Sans lui, la dernière écriture l’emporte.