 |
Résumé | Discourse Workflows permet aux administrateurs de créer des automatisations avancées via un constructeur visuel pour automatiser presque tout dans votre communauté. |
 |
Guide d’installation | Ce plugin est inclus dans le noyau de Discourse. Il n’est pas nécessaire d’installer le plugin séparément. |
Workflows est un constructeur d’automatisation visuelle qui permet aux administrateurs de créer des automatisations avancées et multiétapes à l’aide d’un canevas par glisser-déposer — en connectant des déclencheurs, des conditions, des actions et des nœuds de contrôle de flux pour automatiser presque tout sur votre site Discourse.
Discourse Workflows est disponible sur les plans Business ou Enterprise.
Concepts clés
Si vous êtes familier avec d’autres outils d’automatisation, vous reconnaîtrez probablement la plupart des termes utilisés dans Workflows :
- Workflow : Une automatisation enregistrée composée de nœuds connectés.
- Nœud : Une étape unique dans un workflow : déclencheurs, conditions, actions et contrôle de flux / utilitaires.
- Déclencheur : Le point de départ d’un workflow. Un déclencheur peut être manuel ou initié par un événement spécifique — création d’un sujet, exécution d’un calendrier, ou réception d’un webhook.
- Condition : Un nœud de routage qui évalue une règle et divise le flux en branches. Par exemple, un nœud Si achemine le flux en fonction d’une évaluation vraie ou fausse.
- Action : Un nœud qui effectue une tâche spécifique — création d’un message, attribution d’un badge, appel à une API externe, etc.
- Élément : Les données qui circulent entre les nœuds. Les éléments sont des objets JSON que vous pouvez inspecter dans les journaux d’exécution et référencer à l’aide d’expressions.
- Expression : Une valeur dynamique écrite sous la forme
{{ ... }}qui est résolue à l’exécution et utilisée pour référencer des données provenant de nœuds antérieurs, de variables de workflow ou de paramètres du site.
Création d’un workflow
Pour créer un workflow :
- Allez dans Admin > Plugins > Workflows et cliquez sur Nouveau workflow.
- Nommez votre workflow.
- Cliquez sur Ajouter la première étape et choisissez votre déclencheur.
- Utilisez le bouton + pour ajouter des nœuds supplémentaires.
- Double-cliquez sur un nœud pour le configurer. Dans le panneau de configuration, les détails concernant les entrées du nœud s’afficheront sur le côté gauche et les détails concernant les sorties du nœud s’afficheront sur le côté droit de l’écran. Vous devrez peut-être exécuter le workflow une fois avant de voir tous les différents détails.
- Lorsque vous êtes prêt à le mettre en ligne, cliquez sur Publier.
Conseils :
- Utilisez les post-it, situés dans le menu à trois points en haut à droite du constructeur, pour documenter ce que fait votre workflow. Les post-it n’ont aucun effet sur le workflow, mais facilitent la compréhension des modèles et des workflows partagés.
- Utilisez le nœud journal pendant le développement pour envoyer des valeurs de débogage dans le journal d’exécution sans affecter le comportement du workflow.
- Vous pouvez exporter et importer des workflows au format JSON pour les partager avec vos collègues ou recréer des workflows provenant d’autres sites.
Expressions et données dynamiques
Les champs qui acceptent des expressions affichent un bouton {/} dans l’éditeur. Cliquez dessus pour parcourir les données disponibles provenant du déclencheur et des nœuds antérieurs et insérer une référence.
Expressions courantes
| Expression | Ce qu’elle retourne |
|---|---|
{{ $json.topic.title }} |
Le titre du sujet de l’élément actuel |
{{ $json.post.url }} |
L’URL du message de l’élément actuel |
{{ $json.user.username }} |
Le nom d’utilisateur de l’utilisateur associé à l’élément actuel |
{{ $vars.my_variable }} |
La valeur d’une variable de workflow nommée my_variable |
{{ $site_settings.title }} |
Le titre de votre site |
{{ $execution.id }} |
L’identifiant unique de l’exécution actuelle |
{{ $('Nom du nœud').item.json.property }} |
La sortie d’un nœud en amont spécifique, référencé par son nom sur le canevas |
Valeurs statiques et dynamiques
Les champs commençant par = sont traités comme des expressions. Les champs sans = initial sont traités comme du texte brut. Le sélecteur d’expressions gère cela automatiquement pour vous.
Gestion des workflows
Il existe plusieurs fonctionnalités pour vous aider à gérer vos workflows existants.
Exécutions
Chaque fois qu’un workflow s’exécute, Discourse enregistre une exécution. Allez dans Workflows → Exécutions pour voir l’historique.
Chaque exécution affiche la date et l’heure de sa complétion ainsi que son statut :
- Terminé : S’est exécuté jusqu’au bout sans erreur.
- Erreur : A échoué à un nœud spécifique ; cliquez sur l’exécution pour voir l’erreur et les données qui l’ont causée.
- En cours : En cours de traitement.
- En attente : Mis en pause en raison d’un nœud Attendre ; en attente d’une réponse dans un formulaire, une modale, une approbation par chat ; ou un nœud Appeler un workflow en attente de la complétion d’un sous-workflow.
- Limité par le débit : Le workflow a été ignoré en raison de la limitation de débit.
- Ignoré : Le déclencheur s’est activé, mais le workflow n’était pas publié.
Vous pouvez cliquer sur le bouton Afficher pour un examen plus approfondi de l’exécution du workflow. Cela affiche chaque étape du workflow, que vous pouvez développer pour afficher les détails exacts, ainsi que la durée de cette étape.
En bas de la page, vous pouvez voir la durée totale du workflow. Vous pouvez également Exporter le journal si nécessaire pour le partager ou pour le dépannage.
Paramètres
Sur l’onglet Workflows → Paramètres, vous pouvez :
- Configurer un workflow d’erreur qui doit se déclencher en cas d’échec lors de l’exécution de ce workflow. Si le workflow possède un déclencheur d’erreur, il gérera les erreurs comme défini par ce déclencheur.
- Définir le fuseau horaire pour les déclencheurs de calendrier. Le workflow utilisera par défaut le fuseau horaire du site si cela n’est pas défini.
- Supprimer le workflow.
Cette action est définitive, vous devriez donc envisager d’exporter votre workflow (accessible dans le menu à trois points en haut à droite du constructeur de workflow) avant de continuer.
Versions
Chaque fois que vous mettez à jour le workflow, nous sauvegardons la ou les version(s) précédente(s). Cela facilite la Annulation des changements qui ne fonctionnaient pas comme prévu.
Variables
Les variables sont des paires clé-valeur limitées à un seul workflow. Définissez-les dans le panneau Variables du workflow et référencez-les n’importe où avec {{ $vars.nom_clé }}. Utilisez les variables pour stocker des valeurs de configuration (comme un ID de catégorie ou un nom d’utilisateur destinataire) que vous souhaitez pouvoir modifier sans modifier le graphique du workflow.
Identifiants
Certains nœuds — comme la requête HTTP ou l’Agent IA — doivent s’authentifier auprès de services externes. Stockez les clés API et les secrets dans Workflows → Identifiants plutôt que de les coller directement dans les champs des nœuds. Les identifiants sont chiffrés au repos et peuvent être réutilisés entre les workflows.
Types d’identifiants pris en charge :
- Authentification de base (nom d’utilisateur + mot de passe)
- Jeton Bearer
- Authentification par en-tête (nom et valeur d’en-tête personnalisés)
Tableaux de données
Les tableaux de données sont des tableaux structurés persistants internes au plugin Workflows. Utilisez le nœud Tableau de données pour lire ou écrire dans ceux-ci. Ils prennent en charge les types de colonnes string, number, boolean et date.
Les tableaux de données sont utiles pour :
- Dédoublonnage — enregistrer quels utilisateurs ou sujets un workflow a déjà traités
- État — suivre si un sujet est à une étape particulière d’un processus
- Requêtes — stocker des mappages (comme ID de sujet → membre du personnel assigné) que vos workflows peuvent interroger
Exécutions
Vous pouvez afficher toutes les exécutions de tous les workflows depuis l’onglet Exécutions. Le format et la fonction sont très similaires aux exécutions spécifiques au workflow, mais s’affichent pour tous les workflows pour une surveillance plus facile.
Modèles
Lorsque vous créez un nouveau workflow, vous pouvez commencer à partir d’un modèle plutôt que d’un canevas vierge. Les modèles sont des workflows préconstruits pour des cas d’utilisation courants — ils sont annotés avec des post-it expliquant comment ils fonctionnent et constituent un bon moyen d’apprendre le système.
Intéressé par la vue de plus de modèles ? Nous travaillerons à l’expansion de la bibliothèque de modèles disponibles au fil du temps, mais n’hésitez pas à nous faire savoir s’il y a un modèle que vous aimeriez voir ici pour faciliter votre utilisation de Workflows.
Vous pouvez également exporter n’importe quel workflow en tant que fichier JSON pour le partager avec d’autres ou l’utiliser comme point de départ.
