Sphère·Documentation

Dépannage

Workflow — Dépannage

Symptôme → cause probable → solution. Chaque entrée est autonome.

Ma carte revient à sa colonne quand je la déplace #

Dans le module Workflow, l'étape que vous quittez a une sortie conditionnée et des champs exigés sont vides sur l'objet. Le déplacement est refusé et la carte reprend sa place.

  1. Lisez la fenêtre Ce qui manque : elle nomme le processus, l'étape, la valeur visée et les champs à renseigner.
  2. Ouvrez la fiche de l'objet et renseignez ces champs.
  3. Refaites le déplacement.

Si vous ne pouvez pas renseigner ces champs, demandez à un administrateur de la sphère de Passer outre : il devra saisir un motif, inscrit au journal du suivi.

Mon déplacement est refusé avec « Condition non remplie » #

Dans le module Workflow, une Condition du processus n'autorise pas la branche que vous visez. La fenêtre détaille chaque règle de la condition, avec la valeur réellement lue sur l'objet.

  1. Comparez la valeur lue à ce qu'attend la règle.
  2. Corrigez la donnée sur la fiche de l'objet, puis refaites le déplacement.
  3. Si la donnée est correcte et que le déplacement doit passer malgré tout, un administrateur de la sphère peut passer outre avec un motif.

Mon suivi n'avance plus #

Dans le module Workflow, plusieurs causes possibles, à vérifier dans cet ordre :

  1. Le suivi est marqué « Gelé » → le processus est repassé en brouillon, ou a été supprimé. Un administrateur doit le réactiver.
  2. L'étape a une sortie conditionnée → des champs sont vides sur l'objet ; l'encart Workflow de la fiche porte alors la mention Sortie conditionnée.
  3. Une condition bloque la transition → son verdict contredit la valeur visée.
  4. La valeur de l'objet n'a pas changé → un suivi avance quand le champ liste référencé par le dessin change. Tant que l'objet garde sa valeur, il reste sur son étape.
  5. La valeur prise par l'objet n'est référencée par aucune étape → le suivi a été interrompu (« Étape disparue du dessin ») ; un nouveau suivi s'ouvrira quand l'objet reprendra une valeur du dessin.

Je n'ai pas reçu la relance annoncée #

Dans le module Workflow, ouvrez le journal du suivi : c'est lui qui dit ce qui s'est passé. Les causes fréquentes :

  1. La minuterie n'a pas encore sonné → la colonne Minuterie de l'écran Suivis indique le temps restant. Le journal donne, pour chaque rappel, l'échéance calculée.
  2. La minuterie n'a pas de réaction → une minuterie sans réaction signale seulement l'état du suivi, elle n'envoie rien.
  3. La minuterie n'a pas de durée → sans échéance, rien ne tire.
  4. L'action a échoué → le suivi affiche Actions en échec avec son motif, par exemple « l'objet n'a pas de responsable » ou « aucun N+1 trouvé ». Corrigez la cause nommée : renseignez le responsable de l'objet, ou choisissez un autre destinataire dans le processus.
  5. Le suivi est gelé → le processus est en brouillon : aucune minuterie ne tire.
  6. Le suivi a changé d'étape avant l'échéance → la minuterie de l'étape quittée est levée, et le journal l'indique (« Minuterie levée »).

Mon suivi affiche « Aucune minuterie » alors qu'une durée est réglée #

Dans le module Workflow, vérifiez d'abord sur quelle étape se trouve le suivi : les minuteries sont réglées par nœud, et l'étape courante n'en porte peut-être aucune. L'écran Suivis et l'encart Workflow des fiches affichent les minuteries réellement armées sur l'étape en cours.

Vérifiez ensuite la version du dessin sur laquelle avance le suivi : un suivi ouvert avant votre modification reste figé sur son ancienne version et ne connaît donc pas la minuterie que vous venez d'ajouter. Le badge de version de la ligne le dit, et le panneau Versionnement du suivi liste les étapes dont la durée a changé.

Mon suivi est marqué « Bloqué » alors que l'équipe travaille dessus #

Dans le module Workflow, la minuterie de blocage compte le temps sans aucun événement sur l'objet : aucune modification de champ, aucun changement d'étape. Elle est réarmée à chaque modification de l'objet.

Les appels, e-mails et réunions ne réarment pas ce compte : si l'équipe travaille sans rien modifier sur la fiche, le suivi est légitimement signalé Bloqué. Mettez la fiche à jour, ou demandez à un administrateur d'allonger la durée de blocage de l'étape.

Mon suivi est marqué « En retard » mais tout a été fait #

Dans le module Workflow, En retard signifie que le temps alloué de l'étape est dépassé : le suivi continue, il n'est pas arrêté. Ce n'est pas une erreur.

Regardez la colonne Minuterie : si elle indique action exécutée le …, la réaction attachée a bien eu lieu. Si le retard est systématique sur cette étape, la durée réglée est probablement trop courte : signalez-le à l'administrateur qui gère le processus.

Le compteur « En retard » ou « Bloqués » ne correspond pas à la liste #

Dans le module Workflow, sur l'écran Suivis, ces deux compteurs sont calculés sur la page affichée, pas sur l'ensemble des suivis. Un suivi situé sur une autre page n'apparaît ni dans la liste, ni dans le compteur de l'onglet.

Le nombre est alors précédé du signe ≥, et un message le rappelle. Parcourez les pages pour voir tous les suivis concernés.

Mon appel entrant est bien reçu, mais rien ne se passe #

Dans le module Workflow, la ligne Dernier appel du volet Déclencheurs ne prouve qu'une chose : l'appel est arrivé. L'issue réelle se lit dans le journal du suivi.

  1. Ouvrez le journal du suivi et cherchez la ligne Webhook appliqué ou Webhook refusé.
  2. Si l'appel est refusé, le motif est donné en clair : champs requis manquants, condition non remplie, valeur refusée par l'objet, ou objet introuvable. Quand un appel est refusé, ni l'objet ni le suivi ne bougent.
  3. Si l'appel est appliqué mais que le suivi n'a pas avancé, regardez les valeurs ignorées listées dans le journal : une valeur recopiée dont l'alias ne porte pas le code du champ liste référencé par le dessin est ignorée.
  4. Vérifiez enfin que le processus est activé : en brouillon, un appel reçu n'ouvre aucun suivi.

L'adresse ou le secret de mon webhook ne fonctionne plus #

Dans le module Workflow, trois causes possibles :

  1. Le secret a été régénéré → l'ancien cesse de fonctionner immédiatement ; le logiciel appelant doit utiliser le nouveau. L'adresse, elle, ne change pas.
  2. Le webhook a été révoqué → son adresse ne répond plus. Il reste listé pour la traçabilité ; créez-en un nouveau.
  3. La signature de l'appel est fausse ou périmée → elle n'est valable qu'un court moment après son calcul.

Le secret n'est jamais réaffiché après sa création : si vous l'avez perdu, la seule issue est de le régénérer et de le copier immédiatement.

Je ne peux pas activer mon processus #

Dans le module Workflow, deux causes usuelles :

  1. Le dessin n'est pas enregistré → l'écran affiche « Enregistrez le dessin avant d'activer le processus ». Cliquez sur Enregistrer, puis sur Activer.
  2. Un autre processus est déjà actif sur la même famille et le même pipeline → l'activation est refusée et un lien mène au processus en place. Désactivez-le d'abord.

Les avertissements du dessin, eux, n'empêchent pas d'activer : ils signalent ce qui reste à compléter.

Mon processus est actif mais aucun suivi ne s'ouvre #

Dans le module Workflow, vérifiez ces points, dans l'ordre :

  1. Les étapes référencent-elles des valeurs ? Une étape sans valeur référencée est hors pipeline : aucun objet ne s'y arrête. Les avertissements du dessin le signalent.
  2. Les objets portent-ils le bon pipeline ? Si le processus est ancré sur un pipeline, un objet qui ne le porte pas n'ouvre aucun suivi.
  3. Le dessin a-t-il un nœud Début ? Sans lui, aucun suivi ne peut démarrer.
  4. Les objets ont-ils été créés ou modifiés depuis l'activation ? Un processus observe sa famille à partir de son activation.

Le bouton Essai à blanc répond à cette question en une manipulation : il dit, pour un objet réel, où le suivi s'ouvrirait — ou pourquoi il ne s'ouvrirait pas.

Je ne trouve pas de bouton pour démarrer ou annuler un suivi #

C'est normal : dans le module Workflow, un suivi ne se démarre ni ne s'arrête à la main. Il s'ouvre sur un événement de l'objet ou sur un appel entrant, se termine sur un nœud Fin, et s'interrompt quand l'objet quitte le dessin.

Pour engager un objet existant, donnez-lui une valeur que le dessin référence. Pour suspendre l'ensemble des suivis, un administrateur peut désactiver le processus.

L'encart Workflow n'apparaît pas sur ma fiche #

Dans Sphère, l'encart Workflow ne s'affiche sur une fiche Affaire, Ticket, Contact ou Organisation que si un suivi ouvert existe sur cet objet. Une absence d'encart signifie donc qu'aucun suivi n'est ouvert.

Vérifiez qu'un processus actif existe sur la famille de l'objet, et que l'objet porte bien une valeur référencée par une étape du dessin. Vérifiez aussi le pipeline de l'objet si le processus est restreint à un pipeline.

L'écran Suivis affiche « Objet introuvable » ou « Objet illisible » #

Dans le module Workflow, l'écran Suivis lit les objets dans leur module d'origine.

  • Objet introuvable : l'objet a été supprimé. Le suivi est interrompu, mais sa ligne et son journal restent consultables.
  • Objet illisible pour l'instant : l'objet n'a pas pu être lu au moment de l'affichage. Cliquez sur Actualiser ; si le message persiste, signalez-le à votre administrateur.

Le module Workflow n'apparaît pas dans ma barre latérale #

Dans Sphère, le module Workflow n'est visible que s'il est ouvert pour votre compte. Demandez à un administrateur de votre organisation de vous y donner accès.

Le module s'épingle aussi dans la barre latérale : s'il n'y figure pas alors que vous y avez accès, vérifiez la liste complète des modules avant de conclure à un problème.

Mis à jour le .