Test e cronologia delle esecuzioni

Prima che un'automazione lavori per i Suoi membri, vorrà vederla funzionare per Lei. Un'esecuzione di prova la avvia una volta su richiesta. La cronologia delle esecuzioni mostra poi ogni esecuzione, reale o di prova, passo per passo, così può vedere che cosa è successo e perché un'esecuzione non è riuscita.

Apra le automazioni

Che cosa fa davvero un'esecuzione di prova

Un'esecuzione di prova non è una simulazione. Esegue l'automazione una volta, subito:

• Le azioni vengono eseguite davvero. Le email partono, tag, gruppi e accessi ai corsi cambiano, e webhook e richieste esterne vengono inviati. Faccia i test con il Suo account o con un membro di prova, non con un cliente reale.
• Usa l'ultima versione salvata, anche se non l'ha ancora pubblicata. Gli eventi reali continuano a usare la versione pubblicata finché non pubblica.
• Funziona anche mentre l'automazione è disattivata.
• Quando il flusso raggiunge un passaggio Ritardo o Attendi fino alla data, l'esecuzione di prova attende come un'esecuzione reale. I passaggi restanti vengono eseguiti davvero una volta terminata l'attesa.
• Un passaggio Esegui workflow avvia davvero l'altra automazione. Quell'esecuzione compare nella cronologia dell'altra automazione con l'origine Automatico.
• Ogni integrazione che il flusso usa deve essere collegata. Altrimenti il test si ferma con "Collega prima queste integrazioni:" e i nomi mancanti.

Le esecuzioni di prova non contano nell'elenco: Ultima esecuzione, Esecuzioni (7 g), Successo (7 g) e la vista Non riuscito le ignorano. Un test non riuscito non segna la Sua automazione come non riuscita.

Creare un'automazione

Avviare un'esecuzione di prova dall'elenco

Apra il menu di un'automazione nell'elenco e scelga Esecuzione di prova. La finestra spiega: "Esegue una volta la bozza attuale con dati di prova vuoti. Le azioni vengono eseguite davvero." Questo test parte senza dati del trigger e senza un membro. È adatto a un controllo rapido. Per testare con un membro o con dati propri, avvii il test nell'editor.

Se l'automazione ha più trigger, ne scelga uno in Inizia dal trigger. Poi clicchi su Avvia esecuzione di prova. Il risultato compare nella stessa finestra:

• Esecuzione di prova completata, con la durata.
• L'esecuzione di prova è in attesa in un passaggio di ritardo o di attesa quando il flusso si è fermato a un passaggio Ritardo o Attendi fino alla data. Il resto segue più tardi.
• Esecuzione di prova non riuscita, con il messaggio di errore dell'esecuzione.

Esegui di nuovo avvia un altro test. Se l'automazione non ha un trigger, la finestra mostra "Questa automazione non ha un trigger da cui partire."

Avviare un'esecuzione di prova nell'editor

Clicchi su Esecuzione di prova nell'intestazione dell'editor. La finestra offre più controllo:

• Se ha modifiche non salvate, una nota dice "Le modifiche non salvate vengono salvate prima dell'esecuzione di prova." Il test prima salva e poi parte. Se il salvataggio non riesce, il test non parte.
• Con un solo trigger, la finestra lo nomina. Con più trigger, ne scelga uno in Trigger.
• Payload sono i dati che il trigger fornirebbe. Parte come {}. Inserisca i campi che i Suoi passaggi leggono, per esempio il campo che una condizione controlla o che un segnaposto come {{order_id}} usa: {"order_id": 1042, "amount": 4900}. Finché il testo non è JSON valido, la finestra mostra "JSON non valido. Controlla il payload e riprova." e non esegue.
• UUID del membro è il membro a cui si riferisce l'esecuzione. Le azioni che agiscono su un membro, per esempio aggiungere un tag o concedere un corso, ne hanno bisogno. Lo lasci vuoto per i flussi senza membro, come una pianificazione o un webhook. Trova l'UUID alla fine dell'indirizzo web quando apre il membro nell'area di amministrazione. Un UUID sconosciuto ferma il test con "Questo membro non è stato trovato in questa azienda."

Clicchi su Esegui prova. La finestra si chiude, si apre la cronologia delle esecuzioni e il canvas mostra la nuova esecuzione.

Questi messaggi fermano un test prima che parta:

• "Salva l'automazione almeno una volta prima di avviare un'esecuzione di prova."
• "Aggiungi un trigger e salva prima di avviare un'esecuzione di prova."
• "Questo trigger non è ancora nella versione salvata. Salva e riprova."
• "Questa automazione non ha trigger da testare."

La cronologia delle esecuzioni

Clicchi su Esecuzioni nell'intestazione dell'editor. Il pulsante funziona una volta salvata l'automazione. Il pannello elenca le 50 esecuzioni più recenti che corrispondono ai Suoi filtri, dalla più recente, e si aggiorna ogni pochi secondi. Ogni voce mostra lo stato, l'origine, il trigger, quando l'esecuzione è partita e, una volta terminata, quanto è durata. Per un'esecuzione in attesa, mostra anche quando riprende.

Stato

• In esecuzione: l'esecuzione è in corso.
• In attesa: l'esecuzione attende a un passaggio Ritardo o Attendi fino alla data. La voce mostra Riprende con la data e l'ora nel Suo orario locale in cui prosegue. Se attendono più percorsi, è l'orario più vicino.
• Completato: l'esecuzione ha raggiunto la sua fine.
• Fallito: un passaggio non è riuscito o l'esecuzione ha raggiunto un limite. Apra l'esecuzione per vedere perché.
• Annullato: l'esecuzione era in attesa ed è stata fermata perché l'automazione è stata disattivata, archiviata o eliminata. Maggiori dettagli più sotto.

Origine

• Automatico: qualcosa nella Sua piattaforma ha avviato l'esecuzione, per esempio un nuovo membro o un ordine. Anche le esecuzioni avviate da un passaggio Esegui workflow di un'altra automazione mostrano questa origine.
• Pianificatore: l'orologio della piattaforma ha avviato l'esecuzione. Questo riguarda i trigger Pianificato (cron), Membro inattivo, Evento in arrivo e Rinnovo imminente.
• Manuale: un'esecuzione di prova o un replay.
• Webhook: un webhook in entrata o una chiamata da un servizio esterno.
• Altro: qualsiasi altro avvio.

Filtri

Sopra l'elenco può filtrare per stato (Qualsiasi stato), per origine (Qualsiasi origine) e per data e ora di inizio in Da. Non c'è un filtro di stato separato per le esecuzioni in attesa: compaiono sotto In esecuzione. Cancella filtri reimposta tutti i filtri e mostra quanti sono attivi. Quando nulla corrisponde, il pannello dice "Nessuna esecuzione corrisponde ai tuoi filtri" con un link Mostra tutto. Prima della prima esecuzione dice "Nessuna esecuzione ancora".

Guardare un'esecuzione

Clicchi su un'esecuzione nell'elenco. Il canvas passa a quell'esecuzione e mostra il flusso com'era nella versione usata dall'esecuzione. Un banner in alto mostra quando è partita l'esecuzione, il suo stato e "Il replay è di sola lettura." Non può modificare mentre guarda un'esecuzione. Esci dal replay riporta la Sua bozza attuale.

Ogni passaggio raggiunto dall'esecuzione riceve un anello colorato e un piccolo badge:

• Verde: Completato.
• Rosso: Fallito.
• Blu: In esecuzione.
• Viola con una clessidra: In attesa. Il passaggio è un Ritardo o un Attendi fino alla data e l'esecuzione prosegue più tardi.
• Grigio: Saltato. Il passaggio è stato oltrepassato, per esempio perché un filtro ha fermato questo percorso o l'esecuzione è stata annullata durante l'attesa.

I passaggi senza anello non sono stati raggiunti.

Clicchi su un passaggio per aprirlo nel pannello a destra. Impostazioni mostra la sua configurazione, in sola lettura. Esecuzione mostra che cosa è successo:

• Stato, Avviato e Completato. Un passaggio in attesa mostra Riprende con l'orario in cui l'esecuzione prosegue.
• Input e Output: i dati che il passaggio ha ricevuto e trasmesso.
• Un riquadro rosso con l'errore se il passaggio non è riuscito. Mostra traccia apre dettagli tecnici che può inviare al supporto.
• Una Nota gialla su un passaggio completato significa che il passaggio è stato eseguito ma non ha cambiato nulla, per esempio "The member already has this badge."

Un passaggio che l'esecuzione non ha mai raggiunto dice "Nessuna traccia disponibile". Se l'intera esecuzione non è riuscita, il banner mostra in rosso anche l'errore dell'esecuzione.

Ripetere un'esecuzione

Replay nel banner avvia di nuovo l'esecuzione. Dopo la domanda Ripetere questa esecuzione? la finestra avvisa: "Esegue di nuovo la bozza attuale con gli stessi dati. Le azioni vengono eseguite davvero." Il replay usa gli stessi dati del trigger e lo stesso membro dell'esecuzione originale, ma l'ultima versione salvata del Suo flusso. Questo lo rende il modo più rapido per verificare una correzione: trovi l'esecuzione non riuscita, corregga il passaggio, salvi, ripeta.

Il replay è una nuova esecuzione con l'origine Manuale, e il canvas passa subito a essa. Se dopo l'esecuzione originale ha sostituito il trigger, il replay si ferma con "Il trigger di questa esecuzione non esiste più nella versione attuale. Avvia invece una nuova esecuzione di prova."

Individuare gli errori nell'elenco

Non deve aprire ogni automazione per trovare i problemi. L'elenco li mostra, basandosi solo sulle esecuzioni reali:

• La vista Non riuscito accanto alle Sue cartelle elenca ogni automazione la cui ultima esecuzione non è riuscita. Quando non ce n'è nessuna, mostra Nessuna automazione non riuscita.
• La colonna Ultima esecuzione mostra Mai, oppure l'orario dell'ultima esecuzione con un punto colorato: verde per completata, blu per in corso, grigio per annullata. Un'ultima esecuzione non riuscita compare come badge rosso con il tooltip L'ultima esecuzione non è riuscita.
• Successo (7 g) è la quota di esecuzioni completate tra le esecuzioni terminate degli ultimi sette giorni. Le esecuzioni ancora in corso non contano. Le esecuzioni non riuscite e annullate lo abbassano. Esecuzioni (7 g) conta tutte le esecuzioni degli ultimi sette giorni ed è nascosta per impostazione predefinita.
• Il filtro Stato ultima esecuzione trova le automazioni per Completato, Non riuscito, In corso, Annullato o Mai.

Da lì, apra l'automazione, apra Esecuzioni, filtri per Fallito e clicchi sull'esecuzione per vedere quale passaggio non è riuscito e perché.

Attività: chi ha cambiato che cosa

Attività nel menu di un'automazione elenca le sue ultime 50 modifiche, ciascuna con la persona e l'orario: Creato, Salvato, Pubblicato, Ripristinata, Attivato, Disattivato, Archiviato, Ripristinata dall'archivio, Eliminato, Duplicato, Importato per un'automazione creata da un modello, e Segreto del webhook rigenerato. Le modifiche fatte per più automazioni insieme compaiono in ciascuna di esse. Le esecuzioni di prova e i replay non fanno parte dell'attività; li trova nella cronologia delle esecuzioni. Una nuova automazione senza modifiche mostra "Ancora nessuna attività."

Panoramica delle automazioni

Che cosa succede alle esecuzioni in attesa

Un'esecuzione che attende a un passaggio Ritardo o Attendi fino alla data controlla di nuovo l'automazione quando l'attesa è finita:

• Disattivata: un'esecuzione reale che arriva a scadenza mentre l'automazione è disattivata viene annullata. I suoi passaggi restanti non vengono eseguiti. Se riattiva l'automazione prima della fine dell'attesa, l'esecuzione prosegue normalmente. Le esecuzioni di prova e i replay proseguono anche mentre l'automazione è disattivata.
• Archiviata: l'esecuzione viene annullata, comprese le esecuzioni di prova. L'archiviazione disattiva anche l'automazione.
• Eliminata: l'esecuzione viene annullata.
• Nuova versione pubblicata: un'esecuzione già partita termina con la versione con cui è partita. Solo le esecuzioni che partono dopo la pubblicazione usano la nuova versione. Lo stesso vale per un ripristino.

Un'esecuzione annullata mostra Annullato nella cronologia delle esecuzioni, e il suo passaggio in attesa diventa Saltato. L'errore dell'esecuzione dice perché: "L'automazione è stata messa in pausa mentre l'esecuzione era in attesa.", oppure lo stesso con archiviata o eliminata.

Condizioni, rami e ritardi

Per quanto tempo vengono conservate le esecuzioni

La cronologia delle esecuzioni conserva le esecuzioni per 90 giorni. Una volta al giorno, le esecuzioni più vecchie vengono eliminate insieme all'input e all'output dei loro passaggi. Le esecuzioni ancora in attesa vengono conservate finché non sono terminate.

Errori frequenti e il loro significato

Problemi segnalati dall'editor

L'editor segna i passaggi con problemi prima che esegua qualsiasi cosa. Il salvataggio funziona comunque, ma l'automazione potrebbe non comportarsi come si aspetta:

• "Il trigger non ha nessun tipo di evento selezionato.": scelga a che cosa reagisce il trigger.
• "Il trigger non deve avere un collegamento in entrata.": un trigger avvia sempre il flusso. Rimuova il collegamento che entra in esso.
• "L'azione non ha nessun tipo selezionato.": scelga che cosa fa l'azione.
• "L'azione richiede un'integrazione, ma non ne è stata scelta nessuna." e "L'integrazione richiesta non è collegata.": colleghi il servizio in Integrazioni e selezioni il collegamento nel passaggio.
• "«Giorni di inattività» deve essere almeno 1.", "«Giorni prima del rinnovo» deve essere almeno 1." e "«Ore prima dell'inizio» deve essere almeno 1.": i trigger Membro inattivo, Rinnovo imminente ed Evento in arrivo non partono mai senza questo numero. Inserisca un numero intero pari o superiore a 1.
• "Il ritardo non ha una durata.": inserisca una durata maggiore di zero.
• "Nessun workflow selezionato in "Esegui workflow".": scelga l'automazione che il passaggio deve avviare.
• "Nessun collegamento in entrata. Questo nodo non è raggiungibile.": colleghi il passaggio al flusso o lo elimini.
• "Il grafico non ha un nodo trigger.": aggiunga un trigger.
• "Rispondi al webhook viene eseguito dopo un passaggio di ritardo o di attesa. Chi chiama il webhook riceve invece la risposta predefinita.": sposti la risposta prima dell'attesa.

Errori in un'esecuzione non riuscita

L'errore di un'esecuzione non riuscita nomina il passaggio e il suo tipo, per esempio "Il passaggio "Invia email" (Azione) non è riuscito." o "Il passaggio "Invia email" (Azione) si è interrotto con un errore.", seguito dal motivo. Trigger e azioni compaiono con il loro nome nella libreria, gli altri passaggi con il nome mostrato nel canvas. Clicchi sul passaggio rosso nel canvas per leggere il messaggio completo. Questi errori compaiono nella lingua predefinita della Sua piattaforma, anche per le esecuzioni di prova e i replay. Cause frequenti:

• "… si è interrotto con un errore.": il passaggio ha incontrato un errore, spesso un servizio esterno che ha rifiutato la richiesta o un collegamento che deve essere rinnovato.
• "La richiesta ha restituito HTTP …", "Impossibile inviare la richiesta: …" o "L'URL "…" non è valido o non è consentito.": un passaggio Fai richiesta esterna ha ricevuto un errore dal Suo server, nessuna risposta in tempo, un reindirizzamento, oppure un indirizzo che non può chiamare.
• "Il workflow da eseguire non è stato trovato.", "Il workflow da eseguire non ha una versione pubblicata." o "Il workflow da eseguire non ha un trigger.": l'automazione che un passaggio Esegui workflow avvia è stata eliminata, non è mai stata pubblicata o non ha un trigger.
• "Un workflow non può eseguire se stesso." e "I workflow sono annidati troppo in profondità (al massimo 5 livelli).": i passaggi Esegui workflow si richiamano a vicenda in cerchio o troppo in profondità.
• "Il workflow "…" non è riuscito.": l'altra automazione non è riuscita. Guardi la sua cronologia delle esecuzioni.
• "È stato raggiunto il limite di 500 passaggi.": un'esecuzione esegue al massimo 500 passaggi in una volta. Di solito dipende da un ciclo su un elenco lungo con diversi passaggi all'interno.
• "L'esecuzione è durata troppo ed è stata interrotta.": l'esecuzione è durata più di quanto la piattaforma consenta, per esempio perché un servizio esterno ha risposto troppo lentamente.

Note sui passaggi completati

Una nota gialla segnala un passaggio completato senza svolgere il suo compito:

• "No member of this business could be resolved for this run.": l'esecuzione non ha un membro. Testi di nuovo con un UUID del membro, oppure verifichi se il membro è stato eliminato durante un'attesa.
• "The configured course no longer exists.", oppure lo stesso per un gruppo o un badge: ne scelga uno nuovo nel passaggio.
• "The course is not published, so no access was granted.": pubblichi prima il corso.
• "Nessuna data trovata in "…". Il flusso è proseguito senza attendere." o "Non è stato possibile leggere la data "…". Il flusso è proseguito senza attendere.": un passaggio Attendi fino alla data non ha trovato una data utilizzabile ed è proseguito senza attendere.
• "Il workflow "…" è in pausa. Il flusso è proseguito senza di esso.": attivi l'automazione che il passaggio Esegui workflow avvia.

Non ogni azione lascia una nota. Se un passaggio sui membri mostra Completato ma non è cambiato nulla, verifichi se l'esecuzione aveva un membro sotto Input.