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
La pagina Cronologia esecuzioni consente di visualizzare ulteriori informazioni sui flussi di lavoro attivati. 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.
Quando il flusso di lavoro viene eseguito, viene aggiunto un nuovo inserimento alla pagina della cronologia delle esecuzioni. 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: lo stato del flusso di lavoro. Per ulteriori informazioni, vedere gli stati del workflow.
È 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.
Fare clic su un task per aprire un pannello laterale con ulteriori informazioni su di esso:
- Stato: lo stato dell’attività. Per ulteriori informazioni, vedere gli stati del workflow.
- 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 per: data e ora pianificate per l’esecuzione del flusso di lavoro. Questa opzione verrà visualizzata solo per i 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.
- 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. La scheda Input mostra le informazioni e i dati ricevuti dal task, mentre la scheda Output visualizza il risultato del task.
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.
- 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.
- 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.
- 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.
- Utilizzare l’elenco a discesa Attività incluse per filtrare in base alle attività risultanti dal flusso di lavoro.
- 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à.
- Utilizzare l’elenco a discesa Stato attività per filtrare in base allo stato dell’attività del workflow.
- 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.
- 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.
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.
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.
- Passare alla sezione Cronologia esecuzione del flusso di lavoro a cui si è interessati.
- Fare clic sul task specifico ed eseguire per trovare l’ID trigger.
- Fare clic su Visualizza JSON.
- 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.
- 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