Ricerca e monitoraggio delle esecuzioni dei flussi di lavoro

Dopo l'esecuzione di un flusso di lavoro, Flow fornisce un registro di ciò che è accaduto, chiamato esecuzione del flusso di lavoro, che ti consente di monitorarne le prestazioni e il comportamento.

Attenzione

Le esecuzioni dei flussi di lavoro vengono archiviate per 14 giorni dopo il completamento di un’esecuzione. Dopo 14 giorni, l’esecuzione viene rimossa dal sistema e non è più disponibile.

Accesso alle esecuzioni dei flussi di lavoro

Puoi monitorare tutte le esecuzioni dei flussi di lavoro nell'app Flow. Il controllo delle esecuzioni dei flussi di lavoro può aiutarti a identificare potenziali problemi nel comportamento del flusso di lavoro.

Potrebbe essere utile controllare le esecuzioni di tutti i flussi di lavoro durante la risoluzione dei problemi o se non sai quale flusso di lavoro controllare. Se sai esattamente quale flusso di lavoro vuoi esaminare, puoi accedere alle esecuzioni recenti solo per quel flusso di lavoro.

Suggerimento

È possibile accedere alle esecuzioni del flusso di lavoro che contengono un’attività di marketing anche dall’app Shopify Messaging.

Passaggi:

Controllo di tutte le esecuzioni dei flussi di lavoro

1. Dal pannello di controllo Shopify, vai su App > Flow.

2. Clicca su Esecuzioni recenti.

3. Facoltativo: clicca su un’esecuzione specifica per esaminarne i dettagli.

Controllo delle esecuzioni per un flusso di lavoro specifico

1. Dal pannello di controllo Shopify, vai su App > Flow.

2. Seleziona il flusso di lavoro di cui vuoi controllare le esecuzioni.

3. Nella sezione Esecuzioni recenti, controlla le esecuzioni elencate.

4. Facoltativo: clicca su un’esecuzione specifica per esaminarne i dettagli.

Ricerca di un'esecuzione specifica del flusso di lavoro

Puoi cercare le esecuzioni dei flussi di lavoro in Flow utilizzando uno dei seguenti metodi:

• Dalle pagine delle risorse nel pannello di controllo Shopify, ad esempio un ordine o un prodotto.
• Dall'app Flow, puoi filtrare gli elenchi delle esecuzioni recenti utilizzando i seguenti filtri di ricerca comuni:
  • Per testo nei dati dei passaggi, come un ID cliente o un ID ordine.
  • Per intervallo di tempo, ad esempio la data e l'ora in cui l'esecuzione avrebbe dovuto avere luogo.

Cosa può essere cercato

L'elenco Esecuzioni recenti nell'app Flow contiene l'opzione per filtrare l'intero elenco di esecuzioni in base a qualsiasi combinazione dei seguenti filtri:

• Include testo: filtra in base ai contenuti testuali non elaborati dei dati utilizzati nell'esecuzione del flusso di lavoro, ad esempio un ID ordine in un payload del trigger o il nome del tag in una condizione.
• Flussi di lavoro: filtra per nome del flusso di lavoro.
• Azioni intraprese: filtra in base al fatto che l'esecuzione abbia eseguito delle azioni (vero) o nessuna (falso).
• Errori: filtra in base al fatto che l'esecuzione contenga errori.
• Ora di inizio: filtra in base a un intervallo di data e ora in cui l'esecuzione avrebbe dovuto iniziare. Scopri di più su come filtrare le esecuzioni per ora.
• Tipo di trigger: filtra in base a come è iniziata l'esecuzione. Le opzioni includono un evento trigger, un'esecuzione manuale o un nuovo tentativo manuale.
• Stato nuovo tentativo: filtra in base al fatto che l'esecuzione contenga nuovi tentativi.
• ID esecuzione: filtra in base a un ID esecuzione specifico. Puoi anche scegliere di includere i nuovi tentativi correlati a un ID esecuzione specifico.
• Tag: filtra in base ai tag del flusso di lavoro che si applicano all'esecuzione.

Prima di effettuare la ricerca, valuta quali informazioni puoi cercare nell'esecuzione del flusso di lavoro. Queste informazioni vengono visualizzate all'interno dei dettagli dell'esecuzione del flusso di lavoro e includono i seguenti tipi:

• Eventuali ID per le risorse utilizzate nell'esecuzione del flusso di lavoro, come ID ordini o ID clienti.
• Eventuali testi o dati inclusi nell'esecuzione del flusso di lavoro, come il nome di un tag o il titolo di un prodotto.

Inoltre, quando cerchi l'esecuzione di un flusso di lavoro, considera le seguenti limitazioni:

• La ricerca non distingue tra maiuscole e minuscole.
• La stringa di ricerca non deve includere la punteggiatura. Ad esempio, se cerchi un ID ordine, cerca 43843493 anziché gid://shopify/Order/43843493.
• I log non contengono tutti i dettagli sulle risorse utilizzate nel flusso di lavoro. Ad esempio, se utilizzi un ID prodotto nel flusso di lavoro, il log dell'esecuzione del flusso di lavoro non conterrà il nome o il titolo del prodotto, a meno che tu non abbia utilizzato anche tali campi.
• La ricerca è limitata agli ultimi 14 giorni di esecuzioni dei flussi di lavoro.

Ricerca dal pannello di controllo Shopify

Per le risorse con un menu Altre azioni, puoi avviare una ricerca delle esecuzioni del flusso di lavoro scegliendo l'opzione Cerca esecuzioni di Flow. Questa opzione è disponibile per le seguenti risorse:

• Ordini
• Bozze di ordini
• Clienti
• Prodotti
• Varianti
• Collezioni

Se hai problemi a trovare un'esecuzione, controlla cosa può essere cercato.

Passaggi:

1. Nel pannello di controllo Shopify, apri la risorsa che desideri cercare, ad esempio un ordine o un prodotto.
2. Clicca su Altre azioni.
3. Clicca su Cerca esecuzioni di Flow.

Ricerca per testo nei dati dei passaggi

Nell'app Flow, puoi cercare qualsiasi dato incluso nelle sezioni dei dati dei passaggi in un'esecuzione del flusso di lavoro.

Se hai problemi a trovare un'esecuzione, controlla cosa può essere cercato.

Passaggi:

1. Nell'elenco Esecuzioni recenti dell'app Flow, clicca su Aggiungi filtro.
2. Scegli Include testo.
3. Inserisci il testo o l'ID da cercare.

Ricerca per intervallo di tempo

Esamina le seguenti considerazioni per trovare l'esecuzione di un flusso di lavoro in base all'intervallo di tempo:

• Se il fuso orario del tuo dispositivo è diverso da quello del tuo negozio, la data e l'ora di un'esecuzione del flusso di lavoro potrebbero non essere precise. Tieni conto di questa differenza nel filtro Ora di inizio che utilizzi.
• Nei negozi con volumi elevati, potrebbe essere necessario utilizzare un intervallo di tempo ristretto e altri filtri per trovare più facilmente l'esecuzione di un flusso di lavoro specifico.
• Le esecuzioni dei flussi di lavoro vengono archiviate solo per 14 giorni dopo il completamento dell'esecuzione.
• Potrebbe verificarsi un ritardo tra l'esecuzione di un flusso di lavoro e la visualizzazione dei relativi risultati nella pagina Esecuzioni recenti. Se i risultati di un flusso di lavoro recente non sono ancora disponibili, attendi qualche minuto e riprova.

Passaggi:

1. Nell'elenco Esecuzioni recenti dell'app Flow, clicca su Aggiungi filtro, quindi su Ora di inizio.
2. Nel campo Da, inserisci una data e un'ora uguali all'ora in cui si sarebbe dovuto verificare l'evento. Ad esempio, per un trigger Ordine creato, utilizza l'ora in cui è stato creato l'ordine. Assicurati di inserire il valore corretto per AM/PM.
3. Nel campo A, inserisci una data e un'ora che siano 10 minuti dopo la data e l'ora del campo Da.
4. Controlla i risultati della ricerca. I flussi di lavoro vengono in genere eseguiti esattamente nello stesso momento di un evento scatenante o subito dopo.
5. Clicca su un risultato che corrisponda all'ora e verifica che la risorsa visualizzata corrisponda alla risorsa che stai cercando, ad esempio l'ordine.

Colonne nell'elenco delle esecuzioni recenti

L'elenco delle esecuzioni recenti di un flusso di lavoro mostra i dati principali sulle esecuzioni del flusso di lavoro:

Dati inclusi nella tabella delle esecuzioni del flusso di lavoro

Colonna	Descrizione
Ora di inizio	L'ora in cui è iniziata l'esecuzione del flusso di lavoro.
Stato dell’esecuzione	In corso - in esecuzione o nuovo tentativo in corso. In attesa - un passaggio di attesa ha ritardato un flusso di lavoro. Frequenza limitata - il flusso di lavoro stava utilizzando troppe risorse, quindi Flow ha limitato l'esecuzione delle esecuzioni. Scopri di più sulla risoluzione dei problemi relativi alle esecuzioni con frequenza limitata. Annullato - il flusso di lavoro è stato annullato prima di poter essere completato. Completato - terminato.
Risultati	Elenco delle azioni completate ed elenco degli errori per passaggio.
Nuovi tentativi	Se l’esecuzione è stata ritentata, viene fornito un link all'elenco dei nuovi tentativi.
Tipo di trigger	Nuovo tentativo manuale - l'esecuzione è un nuovo tentativo di un'esecuzione precedente Trigger manuale - il flusso di lavoro è stato eseguito manualmente dal pannello di controllo Shopify Evento trigger - attivato da un evento o una pianificazione

Visualizzazione dei dettagli per l'esecuzione di un flusso di lavoro

Per accedere alle informazioni dettagliate su un singolo flusso di lavoro, clicca sulla riga relativa all'esecuzione del flusso di lavoro.

In alto, la sezione Stato indica se il flusso di lavoro è stato completato. La sezione Azioni indica quante azioni del flusso di lavoro sono state eseguite correttamente.

La sezione Dettagli mostra un'anteprima del flusso di lavoro ed evidenzia i percorsi che il flusso di lavoro ha intrapreso.

Dopo l'anteprima del flusso di lavoro, puoi visualizzare i risultati, i log e i dati per ogni passaggio del flusso di lavoro.

Per ogni passaggio, puoi espandere la sezione Dati del passaggio per visualizzare i dati utilizzati nell'esecuzione del flusso di lavoro. Questi dati includono tutti gli ID per le risorse utilizzate nell'esecuzione del flusso di lavoro, come gli ID ordine o gli ID cliente, e qualsiasi testo o dato incluso nell'esecuzione del flusso di lavoro, come il nome di un tag o il titolo di un prodotto.

Flussi di lavoro con azioni ‘Ciclo for each’

I flussi di lavoro che includono l'azione Ciclo for each (iterazione) ripetono i passaggi più volte. Flow evidenzia quanti articoli hanno seguito un percorso nell'anteprima del flusso di lavoro.

Flow mostra anche i risultati di ogni iterazione del ciclo e ti consente di filtrare per azioni eseguite ed errori per risolvere rapidamente i problemi dei cicli.

Annullamento delle esecuzioni dei flussi di lavoro in corso

Puoi annullare l'esecuzione di un flusso di lavoro con stato In corso o Frequenza limitata quando vuoi interrompere un flusso di lavoro prima che venga completato. L'annullamento dell'esecuzione di un flusso di lavoro può essere un'opzione utile per evitare di raggiungere i limiti dell'API, quando noti che il flusso di lavoro non viene eseguito come previsto o se le esecuzioni non riuscite ingombrano l'elenco delle Esecuzioni recenti.

Considerazioni sull'annullamento delle esecuzioni dei flussi di lavoro in corso

Prima di annullare l'esecuzione di un flusso di lavoro in corso, esamina le seguenti considerazioni:

• Devi utilizzare un dispositivo desktop per annullare le esecuzioni dei flussi di lavoro nell'app Flow.
• Non puoi annullare le esecuzioni già completate.
• Le esecuzioni annullate non possono essere riprese in un secondo momento. Se hai bisogno che il flusso di lavoro venga eseguito di nuovo, puoi attendere che si attivi automaticamente, ritentare l'esecuzione o avviare manualmente una nuova esecuzione del flusso di lavoro.
• L'annullamento delle esecuzioni di un flusso di lavoro non disattiva automaticamente il flusso di lavoro associato. Tuttavia, disattivando un flusso di lavoro, tutte le relative esecuzioni in corso vengono annullate automaticamente.
• L'annullamento delle esecuzioni dei flussi di lavoro può richiedere da pochi secondi a un minuto, a seconda della complessità del flusso di lavoro.

Annullare le esecuzioni dei flussi di lavoro in corso

Puoi annullare in qualsiasi momento l'esecuzione di un flusso di lavoro in corso. Esistono diversi modi per annullare le esecuzioni dei flussi di lavoro in corso:

• Per annullare un'esecuzione specifica, puoi procedere direttamente dalla pagina dei dettagli dell'esecuzione del flusso di lavoro.
• Per annullare più esecuzioni per un singolo flusso di lavoro, puoi annullare le esecuzioni in blocco dall'elenco Esecuzioni recenti del flusso di lavoro.

Suggerimento

Puoi anche annullare tutte le esecuzioni in corso di un flusso di lavoro disattivando completamente il flusso di lavoro; in questo modo, anche le nuove esecuzioni del flusso di lavoro verranno interrotte.

Passaggi:

Annullare un'esecuzione specifica di un flusso di lavoro

1. Dal pannello di controllo Shopify, vai su App > Flow.

2. Clicca sul flusso di lavoro con l'esecuzione in corso che desideri annullare.

3. Nella sezione Esecuzioni recenti, clicca sull'esecuzione in corso che desideri annullare.

4. Clicca su Annulla.

Annullare più esecuzioni per un flusso di lavoro

1. Dal pannello di controllo Shopify, vai su App > Flow.

2. Clicca sul flusso di lavoro con l'esecuzione in corso che desideri annullare.

3. Nella sezione Esecuzioni recenti, seleziona tutte le esecuzioni in corso che desideri annullare.

4. Clicca su Annulla esecuzione.

Risoluzione dei problemi delle esecuzioni dei flussi di lavoro

In alcuni casi, l'esecuzione di un flusso di lavoro può riscontrare un errore o non essere eseguita come previsto. In genere questo si verifica quando c'è un problema di configurazione con il flusso di lavoro. Scopri di più sulla risoluzione degli errori di Flow e su come ritentare le esecuzioni dei flussi di lavoro per correggere retroattivamente il risultato delle esecuzioni passate.