Flux de travail Discourse

:information_source: Résumé Un système de flux de travail pour les sujets qui met en œuvre un processus configurable en plusieurs étapes
:hammer_and_wrench: Lien vers le dépôt \u003chttps://github.com/merefield/discourse-workflow\u003e
:open_book: Guide d’installation Comment installer des plugins dans Discourse

Appréciez-vous ce plugin ? Merci de le :star: sur GitHub ! :pray:

Résumé

Un plugin qui fournit un cadre de flux de travail sécurisé pour les sujets qui sont transmis à travers un ensemble d’étapes personnalisables jusqu’à ce que le flux de travail soit terminé. Certaines branches et boucles sont prises en charge.

Utilisez-le pour un flux de travail d’entreprise que vous avez, comme un processus d’approbation ou de réponse à un problème.

Fonctionnalités

Un outil de flux de travail pour Discourse !

  • Flux de travail basé sur les sujets
  • Tire parti de la sécurité existante de la plateforme, des catégories, des utilisateurs et des groupes.
  • Nouveaux écrans d’administration pour créer de nouveaux flux de travail, étapes et options d’étape.
  • Nouvelle liste de découverte de flux de travail qui répertorie tous les sujets de flux de travail auxquels vous avez accès
  • Bannière de sujet pour les sujets de flux de travail qui vous indique :
    • flux de travail actuel
    • étape actuelle du flux de travail
    • boutons d’action si vous faites partie du groupe ayant accès pour sélectionner une option qui détermine comment le sujet progresse dans le flux de travail
    • lien vers une visualisation (voir ci-dessus).
  • Visualisation du flux de travail qui peut être lancée depuis :
    • bannière de sujet
    • liste de découverte
  • Petites actions de publication de sujet pour les transitions de flux de travail afin de montrer la piste d’audit.
  • Notifications lorsque les sujets arrivent à une étape (par exemple, une catégorie) que vous suivez (Premier message).
  • Support de l’Explorateur de données
    • Rapport de journal d’audit
    • Nombre quotidien d’instances de flux de travail/étapes afin que vous puissiez créer des graphiques de burndown/burnup.
  • L’IA peut être utilisée pour exécuter automatiquement les étapes du flux de travail.

NB Il s’agit d’une version préliminaire et l’ensemble des fonctionnalités évoluera probablement. Je suis ouvert aux intérêts commerciaux pour financer de nouvelles fonctionnalités et intégrations.

Concepts introductifs

Pour tirer parti de la plateforme Discourse telle quelle autant que possible, j’ai créé un cadre simple qui utilise de nombreuses fonctionnalités existantes de la plateforme.

Couloirs de nage

Chaque couloir de nage de flux de travail est une catégorie (ou sous-catégorie).

Au fur et à mesure qu’une instance d’un flux de travail progresse dans son parcours, elle se déplace entre les catégories selon un parcours personnalisable mais prédéfini.

Instances de flux de travail

Une seule instance d’un flux de travail (par exemple, un ticket) est un sujet. Vous pouvez ajouter des étiquettes à un sujet pour mettre en évidence sa priorité ou d’autres métadonnées. Vous ne pouvez pas modifier sa catégorie une fois qu’elle a commencé son parcours, sauf en effectuant des actions de flux de travail sur le sujet (sauf si vous êtes du personnel).

Acteurs

Tout groupe ayant accès à la création de sujets dans une catégorie peut agir sur les sujets de cette catégorie.

Ceux qui ont un accès de réponse peuvent commenter l’élément de flux de travail, tout comme ils le feraient pour un sujet normal.

Vous pouvez masquer les sujets dans une catégorie à des groupes spécifiques de la manière habituelle.

Actions via les options

Celles-ci sont définies pour chaque étape lors de la configuration du flux de travail. Les acteurs peuvent choisir de prendre n’importe quelle action disponible, car chaque option est présentée sous forme de bouton sur le sujet.

Les actions sur un sujet sont enregistrées dans un petit message d’action pour aider les utilisateurs à comprendre le parcours du sujet.

Tableau de bord

Un nouveau filtre de découverte de sujets « Flux de travail » sur la page d’accueil donne une liste des instances de flux de travail (sujets de flux de travail spéciaux).

Vous devez maintenir les catégories de flux de travail et idéalement les étiquettes distinctes, afin que vous puissiez également les utiliser pour filtrer toutes les instances de flux de travail qui se trouvent à une étape particulière, ou qui ont une étiquette spécifique.

Piste d’audit

Chaque fois qu’un sujet passe à une nouvelle étape, une note documentant cela est ajoutée en tant que petit message d’action sur le sujet.

Une requête Data Explorer groupée fournit un rapport d’audit de base du parcours qu’une instance de flux de travail a effectué.

Étant donné que les requêtes Data Explorer peuvent être exposées à des utilisateurs autres que les administrateurs, vous pouvez choisir à qui les montrer.

Graphiques d’avancement/de recul

Il existe une requête Data Explorer groupée qui présente les états du flux de travail à la fin de la journée, vous pouvez donc exporter les données pour créer des graphiques d’avancement/de recul dans, par exemple, Excel.

Visualisation

Il y a un bouton sur chaque sujet de flux de travail qui vous permet d’afficher une visualisation de l’endroit où se trouve le sujet dans son flux de travail.

Ceci est également accessible depuis les champs de flux de travail sur le tableau de bord de découverte des flux de travail.

Différences majeures de comportement par rapport au stock

  • vous ne pouvez pas créer un nouveau sujet dans une catégorie qui se trouve au-delà de la première étape d’un flux de travail
  • vous ne pouvez pas changer la catégorie d’un sujet qui se trouve dans un flux de travail (sauf si vous êtes du personnel).
  • seuls les « créateurs » de catégorie peuvent agir sur un sujet dans un flux de travail.

Démarrage

Le plugin de flux de travail n’est pas livré avec un flux de travail, vous devez en créer un.

Les écrans pour en créer un se trouvent dans Administration → Plugins → Flux de travail Discourse.

Créez d’abord un nouveau flux de travail en cliquant sur le bouton, enregistrez-le, puis peuplez-le avec des étapes en modifiant le flux de travail. Chaque étape, une fois créée, peut être modifiée pour ajouter des options, choisies dans une liste d’options prédéfinies.

Vous pouvez modifier l’étiquette d’une option dans Administration → Personnaliser → Texte.

J’ai pré-rempli le système avec une bonne gamme d’options, mais si vous souhaitez modifier le texte de chacune, allez-y.

Dans chaque catégorie de flux de travail, vous devez ensuite vous assurer que vos « acteurs » sont configurés comme ayant des droits de création. Tous les autres doivent avoir un droit de réponse ou moins.

Vos « acteurs » peuvent également souhaiter suivre la catégorie dont ils sont responsables en sélectionnant « Suivre le premier message ». Ensuite, lorsqu’un nouveau sujet de flux de travail arrive, ils seront avertis avec un lien.

Conseils

  • Envisagez de faire de toutes les étapes du flux de travail pour un flux de travail particulier une sous-catégorie au sein d’une seule catégorie. Bien que cela ne soit pas nécessaire, cela vous permettra de simplement filtrer cette catégorie en utilisant la liste déroulante de catégories existante de Discourse dans la liste de découverte pour voir toutes les instances de flux de travail pour ce flux de travail spécifique.
  • Dans la nouvelle liste de découverte des flux de travail, vous pouvez cliquer sur le nom du flux de travail, la position ou l’étape pour visualiser où se trouve cette instance sur son chemin.
  • Utilisez les outils officiels existants pour créer des modèles structurés pour les sujets utilisés dans le flux de travail :
  • Créez un lien dans la barre latérale (ou n’importe où) pour créer un nouvel élément de flux de travail et lancer le flux de travail : Creating a link to start a new topic with pre-filled information

Actions de l’IA

Vous pouvez utiliser l’IA pour gérer une étape. Vous avez besoin d’une clé OpenAI valide ajoutée aux paramètres du flux de travail. Vous devez activer l’IA sur l’étape. Vous devez également écrire une invite qui doit inclure {{options}} pour faire savoir à l’IA quelles options elle a et {{topic}} pour inclure le contenu.

Exemple d’invite :

« vos options sont {{options}}. si le texte suivant indique qu’il est délicieux, veuillez accepter, sinon rejeter. {{topic}} répondez avec un seul mot parmi ces options »

Problèmes connus :

C’est encore en phase expérimentale, attendez-vous donc à des problèmes, signalez-les et je les listerai ici jusqu’à ce qu’ils soient résolus.

25 « J'aime »

Reçoit de l’amour.

4 « J'aime »

Quelques correctifs ont été déployés :

2 « J'aime »

Offre une vue plus pratique sur mobile :

  • AMÉLIORER : La liste des sujets Workflow fonctionne très bien sur ordinateur, mais sur mobile elle est trop large. Ainsi, au lieu d’ajouter toutes ces colonnes sur mobile, ajoutez un badge Workflow au titre et limitez l’ensemble complet des colonnes aux ordinateurs de bureau.
2 « J'aime »

quelques ajustements mineurs mais importants.

1 « J'aime »

Salut Robert,
Je joue avec le plugin workflow, sans IA. Il s’agit d’un workflow simple destiné à être utilisé comme chaîne de support pour un café Linux qui aide les gens à migrer depuis Windows. De nouveaux sujets sont créés via des e-mails RFC 6233 avec sous-adressage et arrivent dans la première sous-catégorie (niveau 1).

Deux problèmes :

  1. Les identifiants des étapes du workflow ne sont pas uniques. J’ai trois étapes avec le même identifiant. ??
  2. Une action « start » sur le sujet entrant crée un contenu « 422 unprocessable content ». Peut-être que c’est le résultat de 1)
3 « J'aime »

Merci de votre patience et de vos commentaires. J’apprécie votre intérêt pour le plugin.

Il est un peu expérimental et, comme vous pouvez le constater, il n’a pas encore reçu beaucoup de commentaires, il y aura donc forcément des problèmes de jeunesse.

J’essaierai de recréer votre flux de travail et de tenter de reproduire le problème.

En attendant, pouvez-vous faire une capture d’écran du flux de travail dans l’écran d’administration et la partager ?

@Thomas_Rother avez-vous une trace de la pile sur cela ?

3 « J'aime »

Salut Robert,
ne t’inquiète pas, je suis conscient que c’est expérimental. Par conséquent, il n’est installé que sur une instance de test auto-hébergée. Tu peux t’y inscrire et je pourrais te donner des permissions d’administrateur :

https://forum2.netzwissen.de/login

2 « J'aime »

OK, voici un aperçu de la façon dont j’ai procédé :

  • Configuration de la catégorie de tickets « Café Internet »
  • Configuration de toutes les étapes comme sous-catégories, ce qui donne ceci :

Jusqu’ici tout va bien.

Créons maintenant les étapes :

OK, je vois au moins deux problèmes ! (Mais l’un d’eux est probablement causé par l’autre)

C’est étrange car j’étais sûr que cela fonctionnait auparavant. Je regarde ça maintenant et si j’ai le temps, je publierai un correctif sous peu.

3 « J'aime »

@Thomas_Rother essaie ça :

(Tu devras peut-être supprimer et recréer les étapes affectées)

2 « J'aime »

Quels sont les cas d’utilisation les plus courants de ce plugin et est-ce qu’il fonctionne avec Gemini flash 2.0 ?

Tout processus métier (dans des limites raisonnables) avec plusieurs étapes et acteurs. Peut nécessiter une extension pour des intégrations spécifiques.

Il est actuellement limité à OpenAI, mais les PR sont les bienvenues (il utilise Chat Completions donc ce n’est pas une quantité de travail énorme).

1 « J'aime »

Grandes nouvelles : vous pouvez désormais obtenir les statistiques pour créer des graphiques d’avancement/de régression :

  • Ajoute une tâche quotidienne pour créer des statistiques de nombre d’états que vous pouvez utiliser dans des graphiques de régression/d’avancement.
  • Ajoute une tâche qui vérifie la présence ou ajoute deux requêtes utiles pour l’explorateur de données
    • Journal d’audit pour toutes les transitions
    • Nombre quotidien d’instances de flux de travail à chaque étape de leur flux de travail, facilitant les graphiques de régression/d’avancement (il suffit d’exporter les résultats).
    • Vous pouvez accorder à des groupes spécifiques l’accès à ces rapports.

NB Discourse Workflow n’est désormais compatible qu’avec les tests réussis pour le moment en raison des changements dans la manière dont les dépendances des gems sont gérées dans le cadre du regroupement majeur de plugins. Cela devrait changer lors de la prochaine version stable.

4 « J'aime »

J’essaie de comprendre pourquoi mon site est devenu lent…

Avertissement de dépréciation

[PLUGIN discourse-workflow] Avis de dépréciation : L’accès à site.mobileView ou site.desktopView pendant la phase d’initialisation du site est déprécié. Dans les futures mises à jour, le mode mobile sera déterminé par la taille de la fenêtre d’affichage et, par conséquent, l’utilisation de ces valeurs pendant l’initialisation peut entraîner des erreurs et des incohérences lors du redimensionnement de la fenêtre du navigateur. Veuillez déplacer ces vérifications vers un composant, un transformateur ou un rappel d’API qui s’exécute pendant le rendu de la page. [déprécié depuis Discourse 3.5.0.beta9-dev] [id de dépréciation : discourse.static-viewport-initialization] [info : Designing for Different Devices (Viewport Size, Touch/Hover, etc.)] deprecated.js:62:13

Je doute fort que ce soit la cause de la lenteur de votre site !! :rire: - c’est un avertissement de dépréciation.

J’attends votre PR avec impatience :léger_sourire:

1 « J'aime »

Eh bien, cela ne devrait pas être dû à Discourse Workflow car j’ai corrigé plusieurs problèmes N+1, y compris sur la liste des sujets et la visualisation :

etc.

2 « J'aime »