Workflow di Discourse

Plugin
1
:information_source: Riepilogo Un sistema di workflow per argomenti che implementa un processo multi-fase configurabile
:hammer_and_wrench: Link al Repository https://github.com/merefield/discourse-workflow
:open_book: Guida all’installazione Come installare plugin in Discourse

Ti piace questo plugin? Per favore, :star: su GitHub ! :pray:

Una persona in un abito elegante sta scrivendo su un foglio di carta con una penna a un tavolo, indicando un grafico. (Didascalia dell'IA)
Una persona in un abito elegante sta scrivendo su un foglio di carta con una penna a un tavolo, indicando un grafico. (Didascalia dell'IA)1440×608 49.2 KB

L'immagine raffigura un flusso di lavoro di acquisto che include la stesura di una richiesta di acquisto, l'invio per l'approvazione e quindi l'acquisto degli articoli approvati. (Didascalia dell'IA)
L'immagine raffigura un flusso di lavoro di acquisto che include la stesura di una richiesta di acquisto, l'invio per l'approvazione e quindi l'acquisto degli articoli approvati. (Didascalia dell'IA)1992×1584 139 KB

Riepilogo

Un plugin che fornisce un framework di workflow sicuro per gli argomenti che vengono passati attraverso un insieme personalizzabile di passaggi fino al completamento del workflow. Sono supportate alcune diramazioni e cicli.

Usalo per un flusso di lavoro aziendale che hai, come un processo di approvazione o di risposta a un problema.

FunzionalitĂ 

Uno strumento di workflow per Discourse!

  • Workflow basato su argomenti
  • Sfrutta la sicurezza esistente della piattaforma, Categorie, Utenti e Gruppi.
  • Nuove schermate di amministrazione per creare nuovi Workflow, Passaggi e Opzioni di Passaggio.
  • Nuovo elenco di scoperta dei workflow che elenca tutti gli argomenti di workflow a cui hai accesso
  • Banner dell’argomento per gli argomenti di workflow che ti dice:
    • workflow corrente
    • passaggio del workflow corrente
    • Pulsanti di azione se fai parte del gruppo con accesso per selezionare un’Opzione che determina come l’argomento progredisce attraverso il workflow
    • link a una visualizzazione (vedi sopra).
  • Visualizzazione del workflow che può essere avviata da:
    • Banner dell’argomento
    • Elenco di scoperta
  • Piccole azioni post dell’argomento per le transizioni del workflow per mostrare la traccia di controllo.
  • Notifiche per quando gli argomenti arrivano a un passaggio (ad es. Categoria) che stai monitorando (Primo Post)
  • Supporto per Data Explorer
    • Report del registro di controllo
    • Conteggi giornalieri di istanze di workflow/passaggi in modo da poter creare grafici burndown/burnup.
  • L’IA può essere sfruttata per eseguire automaticamente i passaggi del workflow.

NB Questa è una versione iniziale e l’insieme delle funzionalità probabilmente evolverà. Sono aperto a interessi commerciali per finanziare nuove funzionalità e integrazioni.

Concetti introduttivi

Per sfruttare al massimo la piattaforma Discourse così com’è, ho creato un semplice framework che utilizza molte delle funzionalità esistenti della piattaforma.

Corsie di nuoto

Ogni corsia di nuoto del workflow è una Categoria (o Sottocategoria).

Man mano che un’istanza di un workflow prosegue nel suo percorso, si sposta tra le Categorie in un percorso personalizzabile ma predefinito.

Istanze di Workflow

Una singola istanza di un workflow (ad es. un ticket) è un Argomento. Puoi aggiungere tag a un Argomento per evidenziarne la priorità o altri metadati. Non puoi modificare la sua Categoria una volta che ha iniziato il suo percorso, se non intraprendendo azioni di workflow sull’Argomento (a meno che tu non sia staff).

Attori

Qualsiasi Gruppo che abbia accesso alla creazione di argomenti in una Categoria può agire sugli argomenti in quella Categoria.

Coloro che hanno accesso alla risposta possono commentare l’elemento del workflow proprio come possono fare per un normale Argomento.

Puoi nascondere gli Argomenti all’interno di una Categoria a gruppi specifici nel modo normale.

Azioni tramite Opzioni

Queste sono definite per ogni passaggio durante la configurazione del Workflow. Gli attori possono scegliere di intraprendere qualsiasi azione disponibile poiché ogni Opzione viene presentata come un pulsante sull’Argomento.

Le azioni su un Argomento vengono registrate in un Post di Azione Minima per aiutare gli utenti a comprendere il percorso dell’Argomento.

Dashboard

Un nuovo filtro di scoperta degli argomenti “Workflow” sulla homepage fornisce un elenco di istanze di workflow (argomenti di workflow speciali)

Dovresti mantenere distinte le Categorie di Workflow e idealmente i tag, in modo da poterli utilizzare anche per filtrare tutte le istanze di workflow che si trovano in una particolare fase o che hanno un tag specifico.

Traccia di controllo

Ogni volta che un Argomento transita a un nuovo passaggio, viene aggiunta una nota che lo documenta come un Post di Azione Minima sull’Argomento.

Una query Data Explorer inclusa fornisce un report di controllo di base del percorso che un’istanza di workflow ha intrapreso.

PoichĂŠ le query Data Explorer possono essere esposte a utenti oltre agli amministratori, puoi scegliere a chi mostrarle.

Grafici Burn-up/Burn-down

È inclusa una query Data Explorer che presenta gli stati del workflow per fine giornata in modo da poter esportare i dati per creare grafici burn-up/down in ad es. Excel.

Visualizzazione

C’è un pulsante su ogni argomento del workflow che ti permette di visualizzare dove si trova l’argomento nel suo workflow

Questo è accessibile anche dai campi del workflow nella Dashboard di Scoperta del Workflow

Principali differenze di comportamento rispetto allo stock

  • non puoi creare un nuovo Argomento in una Categoria che va oltre il primo passaggio di un workflow
  • non puoi cambiare la Categoria di un Argomento che si trova all’interno di un workflow (a meno che tu non sia staff).
  • solo i “Creatori” di Categoria possono agire su un Argomento in un Workflow.

Iniziare

Il plugin workflow non è fornito con un Workflow, devi crearne uno.

Le schermate per crearne uno si trovano in Amministrazione → Plugin → Discourse Workflow.

Prima crea un nuovo Workflow premendo il pulsante, salvalo, quindi popolalo con i Passaggi modificando il workflow. Ogni Passaggio, una volta creato, può essere modificato per aggiungere Opzioni, scelte da un elenco di Opzioni predefinite.

Puoi cambiare l’etichetta di un’Opzione in Amministrazione → Personalizza → Testo.

Ho pre-caricato il sistema con una buona gamma di Opzioni, ma se desideri cambiare il testo su ciascuna, fallo pure.

In ogni Categoria di Workflow, devi quindi assicurarti che i tuoi “Attori” siano impostati come aventi diritti di Creazione. Tutti gli altri devono avere Diritti di Risposta o inferiori.

I tuoi “Attori” potrebbero anche voler Monitorare quella Categoria di cui sono responsabili selezionando “Monitora Primo Post”. Quindi, quando arriva un nuovo Argomento di Workflow, verranno notificati con un link.

Suggerimenti

  • Considera di rendere tutti i passaggi del workflow per un particolare workflow una Sottocategoria all’interno di una singola Categoria. Sebbene non sia necessario, ti permetterĂ  di filtrare semplicemente per quella Categoria utilizzando il menu a discesa Categoria esistente nell’elenco di Scoperta per vedere tutte le istanze di workflow per quel workflow specifico.
  • Nel nuovo elenco di Scoperta dei Workflow puoi fare clic sul Nome del Workflow, Posizione o Passaggio per visualizzare dove si trova quell’istanza lungo il suo percorso.
  • Utilizza gli strumenti ufficiali esistenti per creare modelli strutturati per gli Argomenti utilizzati nel Workflow:
  • Crea un link nella Sidebar (o ovunque) per creare un nuovo elemento di Workflow e avviare il workflow: Creating a link to start a new topic with pre-filled information

Azioni AI

Puoi sfruttare l’IA per gestire un passaggio. Devi avere una chiave OpenAI valida aggiunta alle impostazioni del Workflow. Devi abilitare l’IA sul passaggio. Devi anche scrivere un prompt che deve includere {{options}} per far sapere all’IA quali opzioni ha e {{topic}} per includere il contenuto.

Esempio di prompt:

“le tue opzioni sono {{options}}. se il testo seguente afferma che è delizioso, per favore accetta, altrimenti rifiuta. {{topic}} rispondi con una sola parola tra quelle opzioni”

Problemi noti:

È ancora in fase sperimentale, quindi aspettati problemi, segnalali e li elencherò qui finchÊ non verranno risolti.

25 Mi Piace
2

Riceve un po’ d’amore.

4 Mi Piace
3

Sono state distribuite alcune correzioni:

2 Mi Piace
4

Rende la visualizzazione piĂš pratica su dispositivi mobili:

  • MIGLIORAMENTO: L’elenco argomenti Workflow funziona benissimo su desktop, ma su mobile è troppo largo, quindi invece di aggiungere tutte quelle colonne su mobile, aggiungi un badge Workflow al Titolo e limita l’intero set di colonne ai dispositivi desktop.
2 Mi Piace
5

alcune modifiche minori ma importanti.

1 Mi Piace
6

Ciao Robert,

Sto sperimentando con il plugin workflow, senza AI. Questo è un semplice workflow destinato ad essere utilizzato come catena di supporto per un linux cafe che aiuta le persone a migrare da Windows. Nuovi argomenti vengono creati tramite email RFC 6233 con subaddressing e arrivano nella prima sottocategoria (livello1).

L'immagine è un diagramma di flusso che raffigura un processo che inizia con "incoming" al livello 1, che porta a "workinprogress" al livello 2, quindi procede a "solved", che ha diramazioni a "Finish" o "Close" prima di passare alle fasi "archiv" o "documentation". (Sottotitolato dall'IA)
L'immagine è un diagramma di flusso che raffigura un processo che inizia con "incoming" al livello 1, che porta a "workinprogress" al livello 2, quindi procede a "solved", che ha diramazioni a "Finish" o "Close" prima di passare alle fasi "archiv" o "documentation". (Sottotitolato dall'IA)1000×740 20.3 KB

Due problemi:

  1. Gli ID dei passaggi del workflow non sono univoci. Ho tre passaggi con lo stesso ID. ??
  2. Un’azione “start” sull’argomento in arrivo crea “422 contenuto non processabile”. Forse è un risultato di 1)
3 Mi Piace
7

Grazie per la pazienza e per il tuo feedback. Apprezzo il tuo interesse per il plugin.

È un po’ sperimentale e, come puoi vedere, non ha ancora ricevuto molti feedback, quindi ci saranno sicuramente dei problemi iniziali.

Cercherò di ricreare il tuo flusso di lavoro e di tentare di ricreare il problema.

Nel frattempo, puoi fare uno screenshot del flusso di lavoro nella schermata di amministrazione e condividerlo?

@Thomas_Rother hai una traccia dello stack per questo?

3 Mi Piace
8

Ciao Robert,
nessun problema, sono consapevole che si tratta di una versione sperimentale. Pertanto è installata solo su un’istanza di test self-hosted. Puoi registrarti lì e potrei darti i permessi di amministratore:

https://forum2.netzwissen.de/login

2 Mi Piace
9

OK, come esempio pratico, ecco come ho proceduto:

  • Impostazione della categoria Biglietti Internet Cafe
  • Impostazione di tutti i passaggi come Sottocategorie, con il seguente risultato:

image
image503×124 2.02 KB

Fin qui tutto bene.

Ora creiamo i passaggi:

Un elenco di categorie di stato del progetto in un'interfaccia di applicazione software, con "risolto", "in arrivo" e "in lavorazione" elencati sotto varie impostazioni relative ai prompt dell'IA. (Sottotitolato dall'IA)
Un elenco di categorie di stato del progetto in un'interfaccia di applicazione software, con "risolto", "in arrivo" e "in lavorazione" elencati sotto varie impostazioni relative ai prompt dell'IA. (Sottotitolato dall'IA)862×260 6.47 KB

OK, vedo almeno due problemi! (Ma uno dei due è probabilmente causato dall’altro)

È strano perché ero sicuro che prima funzionasse. Ci sto dando un’occhiata ora e, se avrò tempo, rilascerò presto una correzione.

3 Mi Piace
10

La pagina visualizza una pagina di configurazione per un Flusso di lavoro esistente intitolato Flusso ticket, che include opzioni di attivazione/disattivazione per una funzionalitĂ  AI e passaggi come in arrivo, in lavorazione, risolto, archivio e documentazione all'interno di un sistema di ticketing. (Sottotitolato dall'IA)
La pagina visualizza una pagina di configurazione per un Flusso di lavoro esistente intitolato Flusso ticket, che include opzioni di attivazione/disattivazione per una funzionalità AI e passaggi come in arrivo, in lavorazione, risolto, archivio e documentazione all'interno di un sistema di ticketing. (Sottotitolato dall'IA)910×759 20.5 KB

@Thomas_Rother prova questo:

(Potrebbe essere necessario eliminare e ricreare i passaggi interessati)

2 Mi Piace
11

Quali sono i casi d’uso più comuni per questo plugin e funziona con Gemini flash 2.0?

12

Qualsiasi processo aziendale (entro limiti ragionevoli) con più passaggi e attori. Potrebbe richiedere un’estensione per integrazioni specifiche.

Attualmente funziona solo con OpenAI, ma le PR sono ben accette (utilizza Chat Completions, quindi non è un lavoro enorme).

1 Mi Piace
13

Grandi novitĂ : ora puoi ottenere le statistiche per creare grafici burn-up/down:

  • Aggiunge un processo giornaliero per creare statistiche sul conteggio degli stati che puoi utilizzare nei grafici burndown/burnup.
  • Aggiunge un processo che verifica la presenza o aggiunge due utili query Data Explorer
    • Registro di controllo per tutte le transizioni
    • Conteggi giornalieri per le istanze di workflow in ogni fase del loro workflow, facilitando i grafici burndown/up (basta esportare i risultati).
    • Puoi concedere a gruppi specifici l’accesso a questi report.

Nota: Discourse Workflow è ora compatibile solo con test superati per il momento a causa delle modifiche nel modo in cui vengono gestite le dipendenze delle gem come parte del principale raggruppamento di plugin. Questo dovrebbe cambiare al momento del prossimo rilascio stabile.

4 Mi Piace
14

Sto cercando di capire perché il mio sito è diventato lento…

Avviso di deprecazione

[PLUGIN discourse-workflow] Avviso di deprecazione: L’accesso a site.mobileView o site.desktopView durante la fase di inizializzazione del sito è deprecato. Nei futuri aggiornamenti, la modalità mobile sarà determinata dalle dimensioni della viewport e di conseguenza l’utilizzo di questi valori durante l’inizializzazione può portare a errori e incongruenze quando la finestra del browser viene ridimensionata. Si prega di spostare questi controlli in un componente, transformer o callback API che viene eseguito durante il rendering della pagina. [deprecato da Discourse 3.5.0.beta9-dev] [id deprecazione: discourse.static-viewport-initialization] [info: Designing for Different Devices (Viewport Size, Touch/Hover, etc.)] deprecated.js:62:13

15

Dubito molto che questo stia causando il rallentamento del tuo sito!! :laughing: - è un avviso di deprecazione.

attendo con ansia il tuo PR :slight_smile:

1 Mi Piace
16

Beh, non dovrebbe essere dovuto a Discourse Workflow poichĂŠ ho risolto diversi problemi N+1, inclusi quelli nella Lista Argomenti e nella Visualizzazione:

ecc.

2 Mi Piace