 |
Riepilogo | Discourse Workflows consente agli amministratori di creare automazioni avanzate tramite un builder visuale per automatizzare quasi tutto nella tua community. |
 |
Guida all’installazione | Questo plugin è incluso nel core di Discourse. Non è necessario installare il plugin separatamente. |
Workflows è un builder visuale per l’automazione che consente agli amministratori di creare automazioni avanzate e multistep utilizzando un canvas drag-and-drop — collegando trigger, condizioni, azioni e nodi di controllo del flusso per automatizzare quasi tutto sul tuo sito Discourse.
Discourse Workflows è disponibile nei piani Business o Enterprise.
Concetti chiave
Se hai familiarità con altri strumenti di automazione, riconoscerai probabilmente la maggior parte del vocabolario utilizzato in Workflows:
- Workflow: Un’automazione salvata composta da nodi collegati.
- Nodo: Un singolo step in un workflow: trigger, condizioni, azioni e controllo del flusso / utilità.
- Trigger: Il punto di partenza di un workflow. Un trigger può essere manuale o attivato da un evento specifico — creazione di un topic, attivazione di una pianificazione o ricezione di un webhook.
- Condizione: Un nodo di instradamento che valuta una regola e divide il flusso in rami. Ad esempio, un nodo If instrada il flusso in base a una valutazione vera o falsa.
- Azione: Un nodo che esegue un’operazione specifica — creare un post, assegnare un badge, chiamare un’API esterna, ecc.
- Elemento: I dati che fluiscono tra i nodi. Gli elementi sono oggetti JSON che puoi ispezionare nei log di esecuzione e a cui puoi fare riferimento utilizzando espressioni.
- Espressione: Un valore dinamico scritto come
{{ ... }}che viene risolto al runtime e utilizzato per fare riferimento ai dati dei nodi precedenti, alle variabili del workflow o alle impostazioni del sito.
Creazione di un workflow
Per creare un workflow:
- Vai su Admin > Plugin > Workflows e clicca su Nuovo workflow.
- Dai un nome al tuo workflow.
- Clicca su Aggiungi primo step e scegli il tuo trigger.
- Usa il pulsante + per aggiungere nodi aggiuntivi.
- Fai doppio clic su un nodo per configurarlo. Nel pannello di configurazione, i dettagli sugli input per il nodo verranno mostrati sul lato sinistro e i dettagli sugli output del nodo verranno mostrati sul lato destro dello schermo. Potrebbe essere necessario eseguire il workflow una volta prima di visualizzare tutti i vari dettagli.
- Quando sei pronto per andare in produzione, clicca su Pubblica.
Suggerimenti:
- Usa gli appunti, disponibili nel menu dei tre puntini in alto a destra del builder, per documentare cosa fa il tuo workflow. Gli appunti non hanno alcun effetto sul workflow ma rendono più facili da capire i template e i workflow condivisi.
- Usa il nodo log durante lo sviluppo per inviare valori di debug nel log di esecuzione senza influenzare il comportamento del workflow.
- Puoi esportare e importare i workflow come JSON per condividerli con i colleghi o ricreare workflow da altri siti.
Espressioni e dati dinamici
I campi che accettano espressioni mostrano un pulsante {/} nell’editor. Cliccalo per sfogliare i dati disponibili dal trigger e dai nodi precedenti e inserire un riferimento.
Espressioni comuni
| Espressione | Cosa restituisce |
|---|---|
{{ $json.topic.title }} |
Il titolo del topic dall’elemento corrente |
{{ $json.post.url }} |
L’URL del post dall’elemento corrente |
{{ $json.user.username }} |
Il nome utente dell’utente associato all’elemento corrente |
{{ $vars.my_variable }} |
Il valore di una variabile di workflow chiamata my_variable |
{{ $site_settings.title }} |
Il titolo del tuo sito |
{{ $execution.id }} |
L’ID univoco dell’esecuzione corrente |
{{ $('Nome Nodo').item.json.property }} |
Output da un nodo upstream specifico, riferito per nome nel canvas |
Valori statici e dinamici
I campi che iniziano con = sono trattati come espressioni. I campi senza un = iniziale sono trattati come testo normale. Il selettore di espressioni gestisce questo automaticamente per te.
Gestione dei workflow
Ci sono diverse funzionalità che ti aiutano a gestire i tuoi workflow esistenti.
Esecuzioni
Ogni volta che un workflow viene eseguito, Discourse registra un’esecuzione. Vai su Workflows → Esecuzioni per vedere la cronologia.
Ogni esecuzione mostra la data e l’ora in cui è stata completata e il suo stato:
- Completato: Eseguito fino al termine senza errori.
- Errore: Fallito a un nodo specifico; clicca sull’esecuzione per vedere l’errore e i dati che lo hanno causato.
- In esecuzione: Attualmente in elaborazione.
- In attesa: In pausa a causa di un nodo Wait; in attesa di una risposta in un form, modale, approvazione chat; o un nodo Call Workflow in attesa che un sotto-workflow si completi.
- Limitato dalla frequenza: Il workflow è stato saltato a causa del rate limiting.
- Saltato: Il trigger è stato attivato ma il workflow non era pubblicato.
Puoi cliccare il pulsante Mostra per un esame più approfondito dell’esecuzione del workflow. Questo mostra ogni step del workflow, che puoi espandere per visualizzare i dettagli esatti, e la durata di quello step.
In fondo alla pagina, puoi vedere la durata complessiva del workflow. Puoi anche Esportare il log se necessario per scopi di condivisione o risoluzione dei problemi.
Impostazioni
Nella scheda Workflows → Impostazioni, puoi:
- Configurare un workflow di errore che dovrebbe attivarsi se ci sono fallimenti durante l’esecuzione di questo workflow. Se il workflow ha un trigger di errore, gestirà gli errori come definito da quel trigger.
- Impostare il fuso orario per i trigger pianificati. Il workflow utilizzerà di default il fuso orario del sito se non è impostato.
- Eliminare il workflow.
Questa azione è permanente, quindi dovresti considerare di esportare il tuo workflow (accessibile nel menu dei tre puntini nell’angolo in alto a destra del builder di workflow) prima di procedere.
Versioni
Ogni volta che apporti un aggiornamento al workflow, salviamo le versioni precedenti. Questo rende facile Annullare i cambiamenti che non hanno funzionato come previsto.
Variabili
Le variabili sono coppie chiave-valore limitate a un singolo workflow. Definiscile nel pannello Variabili del workflow e fai riferimento ovunque con {{ $vars.nome_chiave }}. Usa le variabili per memorizzare valori di configurazione (come un ID categoria o un nome utente destinatario) che desideri poter modificare senza modificare il grafico del workflow.
Credenziali
Alcuni nodi — come la richiesta HTTP o l’Agente AI — necessitano di autenticarsi con servizi esterni. Memorizza le chiavi API e i segreti in Workflows → Credenziali invece di incollarli direttamente nei campi dei nodi. Le credenziali sono crittografate a riposo e possono essere riutilizzate tra i workflow.
Tipi di credenziali supportati:
- Autenticazione di base (nome utente + password)
- Token Bearer
- Autenticazione Header (nome e valore personalizzati dell’header)
Tabelle dati
Le tabelle dati sono tabelle strutturate persistenti interne al plugin Workflows. Usa il nodo Tabella dati per leggere o scrivere in esse. Supportano tipi di colonna string, number, boolean e date.
Le tabelle dati sono utili per:
- Deduplicazione — registrare quali utenti o topic un workflow ha già elaborato
- Stato — tracciare se un topic è in una particolare fase di un processo
- Ricerche — memorizzare mappature (come ID topic → membro del personale assegnato) che i tuoi workflow possono interrogare
Esecuzioni
Puoi visualizzare tutte le esecuzioni di tutti i workflow dalla scheda Esecuzioni. Il formato e la funzione sono molto simili alle esecuzioni specifiche del workflow, ma mostrano tutte le esecuzioni per un monitoraggio più facile.
Template
Quando crei un nuovo workflow, puoi partire da un template invece che da un canvas vuoto. I template sono workflow predefiniti per casi d’uso comuni — sono annotati con appunti che spiegano come funzionano e sono un buon modo per imparare il sistema.
Interessato a vedere più template? Lavoreremo per espandere la libreria di template disponibili nel tempo, ma ti preghiamo di farci sapere se c’è un template che vorresti vedere qui per facilitare l’uso di Workflows.
Puoi anche esportare qualsiasi workflow come file JSON per condividerlo con altri o usarlo come punto di partenza personale.
