Storici di esecuzione e revisione dei flussi di lavoro

Informazioni su Esegui e modifica flussi di lavoro; Cronologie di revisione

Dopo aver configurato i flussi di lavoro, probabilmente vorrai controllarne lo stato e valutare le modifiche apportate ad essi. Le sezioni Cronologia esecuzione e Cronologia revisioni in Workflow consentono di visualizzare le esecuzioni passate dei flussi di lavoro, i dettagli di tali esecuzioni e le modifiche apportate a qualsiasi flusso di lavoro. Questa sezione è particolarmente utile per valutare il motivo per cui un workflow potrebbe non essere riuscito. Il reporting conterrà informazioni sul motivo per cui il flusso di lavoro non è riuscito o se è stata apportata una modifica, contribuendo a identificare e risolvere il problema.

È possibile visualizzare la Cronologia esecuzioni e la Cronologia revisioni per uno specifico flusso di lavoro facendo clic sul flusso di lavoro, quindi accedendo alla sezione a cui si è interessati.

È inoltre possibile visualizzare la Cronologia esecuzione per tutti i flussi di lavoro all’interno di un progetto passando direttamente a Esegui cronologia dalla scheda del flusso di lavoro del progetto.

Cronologia esecuzione

Il Cronologia sessioni consente di visualizzare informazioni supplementari sulle esecuzioni del flusso di lavoro avviate. Questa pagina consente di monitorare i flussi di lavoro, diagnosticare i problemi e ottenere una panoramica dei flussi di lavoro completati correttamente e di quelli non riusciti.

Durante la visualizzazione della cronologia sessioni flusso di lavoro, è possibile passare da una visualizzazione rapporto all’altra utilizzando il menu a discesa in cima alla pagina:

1. Avviato correttamente con esecuzione task: visualizza le esecuzioni flusso di lavoro avviate correttamente.
2. Avvio non riuscito dopo l’avvio: visualizzare le esecuzioni flusso di lavoro che non è stato possibile trigger.

Ogni volta che il flusso di lavoro viene attivato, verrà aggiunto come nuovo inserimento nella pagina della cronologia sessioni del flusso di lavoro. Questa pagina contiene una tabella che visualizza le seguenti informazioni sulle esecuzioni del flusso di lavoro:

• Data di avvio: la data e l’ora di inizio dell’esecuzione del flusso di lavoro.
• Nome workflow: il nome del flusso di lavoro.
  Consiglio Q: se vedi gli stati di un workflow denominato “Workflow eliminato”, è probabile che tu elimini il workflow allegato. Prestare attenzione quando si esegue questa operazione: i record sono ancora presenti, ma il workflow stesso è irrecuperabile.
  Consiglio Q: questa colonna è esclusa se si accede alla cronologia delle esecuzioni per un flusso di lavoro specifico.
• Proprietario: il nome utente dell’utente che ha creato il flusso di lavoro.
• Stato: il stato del flusso di lavoro.

È possibile visualizzare informazioni più granulari su ogni esecuzione del flusso di lavoro. Fare clic su un’esecuzione del flusso di lavoro per espanderla e visualizzare le informazioni su ogni componente del flusso di lavoro.

L evento che avvia il flusso di lavoro viene etichettato come “trigger”, mentre le diverse attività nel flusso di lavoro sono etichettate “T-ID 1” per la prima attività, “T-ID 2” per la seconda attività e così via. Per ulteriori informazioni sull’ordine delle attività e sulle etichette, consultare L’ordine delle attività in un workflow.

È quindi possibile fare clic sui diversi componenti dei flussi di lavoro per saperne di più su di esso. Le informazioni e le azioni disponibili dipenderanno dal tipo di componente del flusso di lavoro e dal suo esito positivo. Per ulteriori informazioni, consultare le seguenti sezioni:

• Visualizzazione delle esecuzioni Flusso di lavoro avviate correttamente: workflow avviati correttamente. I task possono essere riusciti o non riusciti.
• Visualizzazione di esecuzioni Flusso di lavoro non riuscite: workflow che non sono stati trigger correttamente a causa di un problema con l’trigger evento o di condizioni del flusso di lavoro errate. Le attività non sono state eseguite perché non sono state avviate.

Ricerca della cronologia di esecuzione

La cronologia di esecuzione viene fornita con filtri preconfigurati che consentono di trovare facilmente il flusso di lavoro a cui si è interessati. È anche possibile utilizzare la barra di ricerca per cercare i valori di output dei task.

1. Utilizzare l’elenco di riepilogo a discesa Proprietà e condivisione per filtrare in base ai workflow di cui si è proprietari, ai flussi di lavoro condivisi con l’utente o a tutti i workflow a cui si ha accesso.
   Consiglio Q: Questo filtro è escluso se si visualizza la cronologia di esecuzione in un progetto di sondaggio.
2. Utilizzare l’elenco a discesa Nome workflow per filtrare in base al nome del workflow.
   Qtip: questo filtro è escluso se si visualizza la cronologia delle esecuzioni per un flusso di lavoro specifico.
3. Utilizzare l’elenco a discesa Avviato per per filtrare in base all’avvio del flusso di lavoro, una pianificazione o un evento del flusso di lavoro specifico.
4. Utilizzare l’elenco a discesa Attività incluse per filtrare in base alle attività risultanti dal flusso di lavoro.
5. Utilizzare la barra di ricerca dei dati di output del task per cercare i valori di output dei task all’interno del workflow. Quando si immette una parola chiave o un valore specifico nella barra di ricerca, l’elenco delle esecuzioni del flusso di lavoro visualizzerà solo le esecuzioni che contengono tale parola chiave o valore.
   Consiglio Q: Questo filtro è disponibile solo quando si seleziona un’attività specifica dall’elenco a discesa Attività incluse.
   Attenzione: questo filtro non è attualmente disponibile per tutti i tipi di attività.
6. Utilizzare l’elenco a discesa Stato attività per filtrare in base allo stato dell’attività del workflow.
7. Utilizzare i campi Data di inizio e Data di fine del workflow per filtrare in base all’avvio del workflow. Fare clic sull’icona del calendario per visualizzare un calendario per selezionare una data.
   
8. Utilizzare l’elenco di riepilogo a discesa Avviato da (ID) per filtrare in base all’ID trigger di uno specifico workflow. Consultare la sezione Trovare un ID trigger di seguito per ulteriori informazioni sul recupero dell’ID trigger.

Consiglio Q: è possibile regolare il numero di risultati utilizzando l’opzione Record per pagina nella parte inferiore della pagina.

Visualizzazione delle esecuzioni Flusso di lavoro avviate correttamente

Il Avviato correttamente con esecuzione task La pagina visualizza i flussi di lavoro avviati correttamente. Questi flussi di lavoro possono avere task riusciti o non riusciti. Quando si visualizzano questi workflow, è possibile fare clic su uno qualsiasi dei task per aprire un panel laterale contenente ulteriori informazioni sul attività:

• Stato: l’attività stato…
• ID esecuzione workflow: ogni volta che viene eseguito un workflow, a ogni aspetto del workflow viene assegnato un ID esecuzione univoco. Puoi utilizzare questo ID per filtrare i tuoi flussi di lavoro o fornire assistenza al supporto Qualtrics se hai bisogno di aiuto per la risoluzione dei problemi relativi al fallimento di un flusso di lavoro.
• Pianificato perr: la data e l’ora in cui è stata pianificata l’esecuzione del flusso di lavoro. Questo verrà visualizzato solo per flussi di lavoro pianificati…
• Ora di inizio: la data e l’ora in cui il workflow è iniziato a essere in esecuzione.
• Ora di fine: la data e l’ora in cui il workflow è terminato.
• Durata: il tempo totale impiegato dal flusso di lavoro per l’esecuzione.
• Impostazioni: il flusso di lavoro impostazioni di ripetizione ed errore al momento dell’esecuzione.
• File: se il task ha elaborato file, è possibile scaricare i file in questa sezione. Per ulteriori informazioni, vedere Download dei file di dati.
  Consiglio Q: se il task selezionato non elabora i file, questo campo verrà nascosto.

Oltre alle informazioni di cui sopra, è possibile fare clic su Visualizza JSON per visualizzare il payload JSON dell’attività.

Il payload JSON può essere utile per la risoluzione dei workflow, in particolare di quelli ETL. Il Input visualizza le informazioni e i dati ricevuti dal attività, mentre il tab Output visualizza il risultato dell’attività.

Visualizzazione delle condizioni

È anche possibile visualizzare il modo in cui i flussi di lavoro condizioni sono stati valutati. Ciò include le condizioni dopo il trigger flusso di lavoro e le condizioni tra le singole attività. Fare clic su una condizione per visualizzare ulteriori informazioni al riguardo.

Ogni condizione sarà visibile in questa finestra. È possibile vedere cos’era la condizione, il valore utilizzato per valutare la condizione e il modo in cui la condizione è stata valutata.

Una condizione può essere valutata come una delle seguenti:

• Valutato vero: la condizione è stata soddisfatta ed è stata valutata come vera.
• Valutato come falso: la condizione non è stata soddisfatta ed è stata valutata come falsa.
• Non valutato: la condizione non è stata valutata perché la logica è già stata trasmessa da una condizione diversa nel flusso di lavoro (per condizioni separate con logica “qualsiasi”).

Visualizzazione di esecuzioni Flusso di lavoro non riuscite

Il Avvio non riuscito dopo l’avvio La pagina visualizza i flussi di lavoro che non è stato possibile trigger correttamente. Sono inclusi i flussi di lavoro il cui evento è stato attivato correttamente ma il flusso di lavoro non è riuscito perché le condizioni non sono state soddisfatte.

Condizioni Trigger non riuscite

È possibile visualizzare il modo in cui la logica condizione è stata valutata per qualsiasi flusso di lavoro. Le condizioni true e false vengono visualizzate nella pagina della cronologia sessioni.

Per i flussi di lavoro avviati correttamente ma non eseguiti a causa di condizioni non soddisfatte che seguono il trigger, è possibile fare clic sulle condizioni del flusso di lavoro per vedere esattamente quali valori sono stati utilizzati per valutare ogni condizione.

In questo modo si apre una finestra che mostra la logica delle condizione e i valori effettivi utilizzati per valutare le condizioni:

1. Le condizioni che sono state soddisfatte correttamente sono etichettate con Vero valutato…
   Esempio: Nello screenshot precedente, la risposta “Medio” non è stata selezionata, quindi la condizione era vera.
2. Le condizioni non soddisfatte sono contrassegnate con Valutato falso…
   Esempio: Nello screenshot precedente, la risposta “Bad” non è stata selezionata, quindi la condizione era falsa.

Stati del workflow

I task del workflow possono avere una serie di stati che consentono all’utente di conoscere l’avanzamento del workflow:

• In coda: l’esecuzione del task è pianificata per la prossima.
• In corso: l’attività è attualmente in esecuzione.
  Esistono due task che vengono eseguiti in modo sequenziale in un workflow. Prima dell’esecuzione, il primo task verrà impostato su “In coda”. Durante l’esecuzione, lo stato del primo task sarà “In corso”, mentre il secondo non verrà visualizzato. Al completamento della prima attività, la seconda verrà visualizzata come “In coda”.
• Operazione riuscita: il task è stato eseguito. Per un’attività e-mail, ciò significa che ha lasciato il server Qualtrics.
• Non riuscito: l’attività non è stata attivata. Ciò è generalmente causato da un errore nella configurazione del task. Ad esempio, se si inserisce un’e-mail non valida nell’attività di posta elettronica.
  Qtip: i workflow non ETL hanno un timeout di 60 secondi. Ciò significa che il workflow non riuscirà se l’esecuzione richiede più di 60 secondi.
  Consiglio Q: è possibile riprovare un flusso di lavoro se 1 o più attività in quel flusso di lavoro non sono riuscite. Per ulteriori informazioni, consultare la sezione sui workflow di nuovo tentativo.
• Nuovo tentativo automatico: una o più attività del flusso di lavoro non sono riuscite ed è in corso un nuovo tentativo. Consultare Workflow e Errori task per ulteriori informazioni.
• Avvio ritardato: il flusso di lavoro non è stato eseguito perché ha ritardato l’applicazione delle impostazioni di avvio. Esistono 1 o più istanze in cui il workflow sarebbe stato avviato, che ora vengono mantenute in una coda fino alla fine dell’intervallo di tempo.
• Non eseguito: il flusso di lavoro è stato attivato, ma non è stato eseguito perché non corrisponde al condizioni…

Cronologia revisioni

La Cronologiarevisioni consente di visualizzare le modifiche apportate a qualsiasi flusso di lavoro a cui si ha accesso. Ciò significa che è possibile visualizzare quando esattamente un workflow è stato disabilitato/abilitato, quando sono state apportate modifiche alle condizioni e chi ha modificato il workflow.

La cronologia delle revisioni è disponibile sia per flussi di lavoro specifici che per tutti i flussi di lavoro di un progetto. Di seguito, vedrai uno screenshot della cronologia delle revisioni di un singolo sondaggio, che mostra tutte le modifiche del flusso di lavoro in ordine.

La cronologia revisioni contiene le seguenti informazioni sui flussi di lavoro:

• Nome del flusso di lavoro: il nome del flusso di lavoro che è stato modificato. Viene visualizzato solo se si sta esaminando la cronologia di revisione di un intero progetto.
• Nome utente: il nome utente dell’utente che ha eseguito la modifica.
• Cosa è cambiato: una descrizione della modifica apportata al workflow.
• Ultima revisione: data e ora di modifica del flusso di lavoro.
• Visualizza dettagli: visualizza il payload JSON per il tuo workflow prima e dopo la modifica.

Ricerca dello storico revisioni

La cronologia delle esecuzioni viene fornita con filtri preconfigurati che consentono di trovare facilmente modifiche specifiche al flusso di lavoro.

• Utilizzare l’elenco a discesa Nome utente per filtrare in base all’utente che ha apportato la modifica.
• Utilizzare l’elenco a discesa Cosa è cambiato per filtrare in base al tipo di modifica apportata al flusso di lavoro.
• Utilizzare i filtri Data (intervallo) ultima revisione per scegliere un intervallo di date al momento della modifica. Fare clic sull’icona del calendario per visualizzare un calendario per selezionare una data.
  

Workflows di riesecuzione

Dalla pagina della cronologia esecuzioni, è possibile rieseguire i flussi di lavoro per completarli di nuovo. Seleziona i flussi di lavoro che desideri rieseguire, quindi fai clic su Riesegui flussi di lavoro.

Se si sceglie di rieseguire un flusso di lavoro non riuscito, verrà chiesto se si desidera iniziare dal primo task non riuscito o iniziare dall’inizio del flusso di lavoro.

I workflow non possono essere eseguiti nei seguenti scenari:

• Le impostazioni di errori del flusso di lavoro e delle attività non consentono di ritentare i flussi di lavoro o di ritentare i flussi di lavoro al di fuori di un determinato periodo di tempo.
• Il workflow selezionato per la riesecuzione è attualmente in corso, in coda o già rieseguito.
• Il workflow si trovava in un avvio ritardato quando è stato eseguito in origine.
• Il nuovo sollecito dei workflow selezionati supererà il limite massimo di workflow eseguibili.

Nuovo tentativo di workflow in corso

Se un’attività in un flusso di lavoro non riesce e desideri riprovare l’intero flusso di lavoro, fai clic su Riprova. Tenere presente che il pulsante Riprova verrà visualizzato solo se un’attività non riesce. Facendo clic sul pulsante Riprova verrà rieseguito l’intero flusso di lavoro.

Se si tenta nuovamente un workflow, l’attività verrà rieseguita con la stessa configurazione dell’esecuzione iniziale. È necessario riprovare un flusso di lavoro quando:

• Un’attività scade a causa di un errore interno di Qualtrics.
• Un’attività non riesce a causa di un problema originato con un sistema esterno.
  Esempio: desidero importare dipendenti da SuccessFactors, ma non ho configurato il mio account SuccessFactors con le autorizzazioni corrette. Quando il flusso di lavoro viene eseguito in Qualtrics, non riesce perché il mio account SuccessFactors non dispone dell’autorizzazione per visualizzare i dati dei dipendenti. Tuttavia, se aggiorno le mie autorizzazioni di SuccessFactors, posso riprovare l’attività in Qualtrics e l’attività avrà esito positivo.

Il nuovo tentativo di eseguire le attività non riuscite a causa di errori di configurazione causerà nuovamente l’errore del tentativo. È invece necessario avviare una nuova esecuzione del workflow dopo aver corretto gli errori di configurazione.

Ricerca di un ID trigger

Ogni volta che viene eseguito un workflow, a ogni componente di tale workflow viene assegnato un ID trigger univoco. Puoi utilizzare questo ID per cercare un’esecuzione specifica del flusso di lavoro o fornire al supporto Qualtrics se hai bisogno di assistenza per risolvere i problemi relativi al motivo per cui il flusso di lavoro non è riuscito.

1. Passare alla sezione Cronologia esecuzione del flusso di lavoro a cui si è interessati.
2. Fare clic sul task specifico ed eseguire per trovare l’ID trigger.
3. Fare clic su Visualizza JSON.
4. Eseguire una ricerca di testo per “uniqueId”. Su Mac si tratta di CMD + F e su PC questo è CTRL + F. Nel browser Web deve essere visualizzata una casella che consente la ricerca.
   
5. Copiare il valore per uniqueId (noto anche come ID trigger).

L’ID trigger può essere utilizzato per cercare determinate esecuzioni del workflow nel reporting.

Download dei file di dati

Determinati workflow task consentono di scaricare un file dei dati da essi elaborati. Ciò è utile per la risoluzione dei problemi e per capire quali dati stai trasferendo tra Qualtrics e altri sistemi di terze parti.

Per scaricare il file di dati, fare clic sul pulsante di download nella sezione File durante la visualizzazione di un task specifico. In questo modo i dati verranno scaricati come file CSV sul computer, che è possibile aprire utilizzando qualsiasi software per la modifica di fogli di calcolo.

È possibile scaricare i file di dati per alcuni task ETL, quali:

• Attività Estrai dati da file SFTP
• Carica dati in attività SFTP
• Estrai dati dall’attività di Google Drive
• Estrai risposte da un’attività di sondaggio
• Aggiungere contatti e transazioni al task XMD

FAQ