Execução de fluxos de trabalho e históricos de revisão
Execução de fluxos de trabalho & históricos de revisão
Depois de configurar seus workflows, você provavelmente vai querer verificar o respectivo status e avaliar as modificações que foram efetuadas nos mesmos. As seções Histórico de execuções e Histórico de revisões em Fluxos de trabalho permitem que você veja as execuções anteriores de seus fluxos de trabalho, os detalhes sobre essas execuções e as alterações feitas em qualquer fluxo de trabalho. Esta seção é especialmente útil para avaliar o motivo pelo qual um workflow pode ter falhado. Os relatórios irão conter informações sobre o motivo pelo qual o workflow falhou ou se foi efetuada uma modificação, ajudando a identificar e corrigir o problema.
Você pode visualizar o Histórico de execuções e o Histórico de revisões de um fluxo de trabalho específico clicando no fluxo de trabalho e indo para a seção em que está interessado.
Você também pode visualizar o Histórico de execução para todos os fluxos de trabalho em um projeto indo diretamente para Histórico de execução a partir da guia do fluxo de trabalho do projeto.
Histórico de execução
O Histórico de execução A página permite que você visualize informações adicionais sobre as execuções de fluxo de trabalho que você acionou. Esta página pode ajudar você a monitorar seus workflows, diagnosticar problemas e obter uma síntese dos workflows que foram concluídos com êxito e que falharam.
Ao visualizar o histórico de execução do fluxo de trabalho , você pode alternar entre duas visualizações de relatórios diferentes usando o menu suspenso na parte superior da página:
- Tarefas executadas com sucesso : Visualize execuções de fluxo de trabalho que foram acionadas com sucesso.
- Falha ao iniciar após acionado : Exibir execuções de fluxo de trabalho que falharam ao acionador.
Cada vez que seu fluxo de trabalho for acionado, ele será adicionado como uma nova entrada na página de histórico de execução do fluxo de trabalho . Esta página contém uma tabela que exibe as seguintes informações sobre suas execuções de fluxo de trabalho:
- Início em: data e hora em que o fluxo de trabalho começou a ser executado.
- Nome do fluxo de trabalho: o nome do fluxo de trabalho.
Qdica: Se você vir status de um fluxo de trabalho chamado “Fluxo de trabalho excluído”, é provável que você tenha excluído o fluxo de trabalho anexado. Tenha cuidado ao fazer isso – os registros ainda estão lá, mas o próprio workflow é irrecuperável.Qdica: Esta coluna será excluída se você acessar o histórico de execuções de um fluxo de trabalho específico.
- Proprietário: o nome de usuário do usuário que criou o fluxo de trabalho.
- Status : O status do fluxo de trabalho.
Você pode visualizar informações mais granulares sobre cada execução de workflow. Clique em uma execução de fluxo de trabalho para expandi-la e ver informações sobre cada componente do fluxo de trabalho.
O evento que inicia o fluxo de trabalho é rotulado como “acionador”, enquanto as diferentes tarefas no fluxo de trabalho são rotuladas como “T-ID 1” para a primeira tarefa, “T-ID 2” para a segunda tarefa e assim por diante. Para obter maiores informações sobre a ordem das tarefas e os rótulos, consulte A ordem das tarefas em um fluxo de trabalho.
Você pode então clicar nos diferentes componentes dos seus fluxos de trabalho para saber mais sobre eles. As informações e ações disponíveis para você dependerão do tipo de componente do fluxo de trabalho e se o fluxo de trabalho foi bem-sucedido ou não. Veja as seções a seguir para mais informações:
- Exibindo execuções de Fluxo de trabalho acionadas com sucesso : Fluxos de trabalho que foram acionados com sucesso. As tarefas podem ser bem-sucedidas ou falhar.
- Exibindo execuções de Fluxo de trabalho com falha : Fluxos de trabalho que não foram acionador com sucesso devido a um problema com o acionador do evento ou condições falsas do fluxo de trabalho . As tarefas não foram executadas porque não foram acionadas.
Pesquisando histórico de execução
O histórico de execução vem com filtros pré-configurados que permitem encontrar facilmente o fluxo de trabalho em que está interessado. Você também pode usar a barra de pesquisa para procurar valores de saída de tarefa.
- Use o menu suspenso Propriedade e compartilhamento para filtrar por fluxos de trabalho que você possui, fluxos de trabalho que foram compartilhados com você ou todos os fluxos de trabalho aos quais você tem acesso.
Qdica: Este filtro é excluído durante a visualização do histórico de execução em um projeto de pesquisa.
- Use o menu suspenso Nome do fluxo de trabalho para filtrar por nome do fluxo de trabalho.
Qdica: Este filtro é excluído se você visualiza o histórico de execuções de um fluxo de trabalho específico.
- Utilize o drop-down Iniciado por para filtrar pelo que inicia o workflow, uma programação ou um evento workflow específico.
- Utilize o drop-down Tarefas incluídas para filtrar pelas tarefas que resultam do workflow.
- Use a barra de pesquisa de dados Saída de tarefa para procurar valores de saída de tarefa dentro do fluxo de trabalho. Quando você insere uma palavra-chave ou valor específico na barra de pesquisa, a lista de execuções de workflow só exibe execuções que contêm essa palavra-chave ou valor.
Qdica: este filtro só está disponível quando você seleciona uma tarefa específica no menu suspenso Tarefas incluídas.Atenção: este filtro não está disponível atualmente para todos os tipos de tarefa.
- Utilize o drop-down de status Tarefas para filtrar pelo status da tarefa de workflow.
- Use os campos Datas de início e Fim do workflow para filtrar por quando o workflow foi acionado. Clique no ícone de calendário para visualizar um calendário para escolher uma data.
- Use o drop-down Iniciado por (ID) para filtrar pelo ID de acionador de um workflow específico. Consulte a seção Procurar um ID de acionador abaixo para mais informações sobre a recuperação do ID do acionador.
Exibindo execuções de Fluxo de trabalho acionadas com sucesso
O Tarefas executadas com sucesso a página exibe fluxos de trabalho que foram acionados com sucesso. Esses fluxos de trabalho podem ter tarefas que foram bem-sucedidas ou que falharam. Ao visualizar esses fluxos de trabalho, você pode clicar em qualquer uma das tarefas para abrir um painel lateral contendo mais informações sobre a tarefa:
- Status : A tarefa status .
- ID de execução de workflow: cada vez que um workflow é executado, cada aspecto do workflow é atribuído a um ID de execução único. Você pode usar essa ID para filtrar seus fluxos de trabalho ou fornecer ao Suporte da Qualtrics se precisar de ajuda para resolver o motivo da falha de um fluxo de trabalho.
- Programado para r: A data e a hora em que o fluxo de trabalho foi agendado para ser executado. Isso só aparecerá para fluxos de trabalho agendados .
- Hora de início: a data e hora em que o workflow começou a ser executado.
- Hora de fim: a data e hora em que o workflow foi executado.
- Duração: o tempo total que o fluxo de trabalho levou para ser executado.
- Configurações : O fluxo de trabalho configurações de repetição e falha no momento da execução.
- Arquivos: se a tarefa processou algum arquivo, você pode baixar os arquivos nesta seção. Consulte Baixando arquivos de dados para obter mais informações.
Qdica: se a tarefa selecionada não processar arquivos, este campo ficará oculto.
Além das informações acima, você pode clicar em Exibir JSON para visualizar o payload JSON da tarefa.
O payload JSON pode ser útil para solucionar problemas de seus fluxos de trabalho, especialmente fluxos de trabalho ETL. O Entrada a aba mostra as informações e dados recebidos pela tarefa, enquanto a Saída A guia mostra o resultado da tarefa.
Condições de visualização
Você também pode visualizar como seus fluxos de trabalho condições foram avaliados. Isso inclui condições após o acionador do fluxo de trabalho e condições entre tarefas individuais. Clique em uma condição para ver mais informações sobre ela.
Cada condição estará visível nesta janela. Você pode ver qual era a condição , o valor usado para avaliá condição e como a condição foi avaliada.
Uma condição pode ser avaliada como uma das seguintes:
- Avaliado como verdadeiro :A condição foi atendida e foi avaliada como verdadeira.
- Avaliado como falso : A condição não foi atendida e foi avaliada como falsa.
- Não avaliado : A condição não foi avaliada porque a lógica já foi passada por uma condição diferente no fluxo de trabalho (para condições separadas com lógica “qualquer”).
Exibindo execuções de Fluxo de trabalho com falha
O Falha ao iniciar após acionado a página exibe fluxos de trabalho que não foram acionador com sucesso. Isso inclui fluxos de trabalho cujo evento foi disparado com sucesso, mas o fluxo de trabalho falhou porque as condições não foram atendidas.
Condições de Acionador com falha
Você pode visualizar como a lógica da condição foi avaliada para qualquer fluxo de trabalho. Condições verdadeiras e falsas aparecem na página do histórico de execução .
Para fluxos de trabalho que foram acionados com sucesso, mas não foram executados devido a condições não atendidas que seguem o acionador, você pode clicar nas condições do fluxo de trabalho para ver exatamente quais valores foram usados para avaliar cada condição.
Isso abre uma janela mostrando sua lógica de condição e os valores reais usados para avaliar as condições:
- As condições que foram atendidas com sucesso são rotuladas com Avaliado como verdadeiro .
Exemplo: Na captura de tela acima, a resposta “Médio” não foi selecionada, então a condição era verdadeira.
- As condições que não foram atendidas são marcadas com Avaliado como falso .
Exemplo: Na captura de tela acima, a resposta “Ruim” não foi selecionada, então a condição era falsa.
Status de workflow
As tarefas de workflow podem ter vários status para permitir o progresso do workflow:
- Em fila: a tarefa está programada para ser executada em seguida.
- Em andamento: a tarefa está sendo executada atualmente.
Exemplo: você tem duas tarefas que são executadas sequencialmente em um workflow. Antes da execução, a primeira tarefa será definida como “Em fila”. Enquanto estiver sendo executada, o status da primeira tarefa será “Em andamento”, enquanto a segunda tarefa não será exibida. Após a conclusão da primeira tarefa, a segunda tarefa aparecerá como “Em fila”.
- Com êxito: a tarefa foi executada. Para uma tarefa de e-mail, isso significa que ela saiu do servidor Qualtrics.
- Falha: a tarefa não foi acionada. Isto é geralmente causado por um erro na configuração da tarefa. Por exemplo, se você inserir um e-mail inválido na tarefa de e-mail.
Qdica: Os fluxos de trabalho não ETL têm um timeout de 60 segundos. Isso significa que o workflow falhará se demorar mais de 60 segundos para ser executado.Qdica: você pode tentar novamente um fluxo de trabalho se 1 ou mais tarefas nesse fluxo de trabalho tiverem falhado. Consulte a seção de nova tentativa de fluxos de trabalho para obter mais informações.
- Nova tentativa automática: uma ou mais tarefas no fluxo de trabalho falharam e estão sendo tentadas novamente. Consulte Fluxo de trabalho e Falhas de tarefa para obter mais informações.
- Início atrasado: o workflow não foi executado porque tem configurações de início atrasadas aplicadas. Existem 1 ou mais instâncias em que o workflow teria sido acionado, que agora estão sendo mantidas em uma fila até que o intervalo de tempo termine.
- Não executado : O fluxo de trabalho foi acionado, mas não foi executado porque não atendeu às especificações do fluxo de trabalho. condições .
Histórico de revisão
O Históricode revisão permite que você visualize as alterações feitas em qualquer fluxo de trabalho ao qual você tem acesso. Isso significa que você pode visualizar quando exatamente um workflow foi desativado/ativado, quando foram efetuadas modificações de condições e quem editou seu workflow.
O histórico de revisão está disponível para workflows específicos e para todos os workflows em um projeto. Abaixo, você verá uma captura de tela do histórico de revisão de uma única pesquisa, mostrando todas as edições de fluxo de trabalho em ordem.
O Histórico de revisão contém as seguintes informações sobre seus fluxos de trabalho:
- Nome do fluxo de trabalho: o nome do fluxo de trabalho que foi editado. Só é exibido se você estiver observando o histórico de revisão para um projeto inteiro.
- Nome do usuário: o nome do usuário que fez a edição.
- O que foi modificado: uma descrição da edição efetuada no workflow.
- Última revisão em: a data e hora em que o fluxo de trabalho foi editado.
- Visualizar detalhes: visualizar o payload JSON para o seu workflow antes e depois da modificação.
Pesquisando histórico de revisão
O histórico de execuções vem com filtros pré-configurados que permitem que você encontre facilmente alterações específicas no fluxo de trabalho.
- Utilize o drop-down Nome do usuário para filtrar pelo usuário que efetuou a modificação.
- Utilize o drop-down O que modificou para filtrar pelo tipo de edição que foi efetuado para o workflow.
- Use os filtros Última data revisada (intervalo) para escolher um intervalo de datas em que a edição foi feita. Clique no ícone de calendário para visualizar um calendário para escolher uma data.
Workflows de nova advertência
Na página do histórico de execução, você pode executar novamente os fluxos de trabalho para concluí-los novamente. Selecione os fluxos de trabalho que você deseja executar novamente e clique em Executar novamente fluxos de trabalho.
Se você optar por executar novamente um workflow falhado, será perguntado se pretende iniciar a partir da primeira tarefa falhada ou iniciar a partir do início do workflow.
Os fluxos de trabalho não podem ser executados nos seguintes cenários:
- As configurações de fluxo de trabalho e falhas de tarefa não permitem que os fluxos de trabalho sejam tentados novamente ou não permitem que os fluxos de trabalho sejam tentados novamente fora de um determinado período de tempo.
- O workflow selecionado para nova execução está atualmente em andamento, em fila ou já está sendo executado novamente.
- O workflow estava em um início atrasado quando foi executado originalmente.
- A nova execução do(s) workflow(s) selecionado(s) excederá o limite máximo de workflows que podem ser executados.
Repetir workflows
Se uma tarefa em um fluxo de trabalho falhar e você quiser tentar novamente todo o fluxo de trabalho, clique em Tentar novamente. Observe que o botão Repetir só será exibido se uma tarefa falhar. Clique no botão Repetir para executar novamente todo o fluxo de trabalho.
Repetir um workflow irá executar novamente a tarefa com exatamente a mesma configuração que a sua execução inicial. Você deve tentar novamente um workflow quando:
- O tempo de uma tarefa esgotou devido a um erro interno do Qualtrics.
- Uma tarefa falha devido a um problema na origem com um sistema de terceiros.
Exemplo: quero importar colaboradores da SuccessFactors, mas não configurei minha conta do SuccessFactors com as permissões corretas. Quando o fluxo de trabalho é executado no Qualtrics, ele falha porque minha conta do SuccessFactors não tem permissão para visualizar dados do colaborador. No entanto, se eu atualizar minhas permissões do SuccessFactors, posso tentar a tarefa novamente no Qualtrics e a tarefa será bem-sucedida.
Repetir tarefas que falharam devido a erros de configuração fará com que a nova tentativa falhe novamente. Em vez disso, você deve iniciar uma nova execução de workflow após corrigir os erros de configuração.
Procurar um ID de acionador
Cada vez que um fluxo de trabalho é executado, a cada componente de tarefa desse fluxo de trabalho é atribuído um ID de acionador exclusivo. Você pode usar esse ID para procurar uma execução específica do fluxo de trabalho ou fornecer ao Suporte da Qualtrics se precisar de ajuda para solucionar problemas por que o fluxo de trabalho falhou.
- Navegue para a seção Histórico de execução do workflow no qual você está interessado.
- Clique na tarefa específica e execute para a qual você deseja encontrar o ID do acionador.
- Clique em Exibir JSON.
- Execute uma pesquisa de texto para “uniqueId”. No Mac, este é CMD + F e no PC é CTRL + F. Uma caixa deve aparecer no navegador da web, permitindo que você pesquise.
- Copie o valor para seu uniqueId (também conhecido como ID do acionador).
O ID do acionador pode ser usado para procurar execuções de fluxo de trabalho específicas em seu relatório.
Baixando arquivos de dados
Determinadas tarefas de workflow permitem que você baixe um arquivo dos dados que foram processados por elas. Isso é útil para solucionar problemas e entender quais dados você está transferindo entre a Qualtrics e outros sistemas de terceiros.
Para fazer o download de seu arquivo de dados, clique no botão de download na seção Arquivos ao exibir uma tarefa específica. Isso baixará seus dados como um arquivo CSV em seu computador, que você pode abrir usando qualquer software de edição de planilha.
Você pode baixar arquivos de dados para algumas tarefas ETL, como:
- Extrair dados da tarefa de arquivos SFTP
- Carregar dados na tarefa SFTP
- Extrair dados da tarefa do Google Drive
- Extrair Respostas de uma tarefa de Pesquisa
- Adicionar contatos e transações à tarefa XMD