Loops de workflow

Sobre loops de fluxo de trabalho

Você pode utilizar loops de workflow para executar um conjunto de tarefas automáticas para várias entradas em uma lista. Por exemplo, você pode enviar um resumo do NPS para cada gerente da loja contendo o NPS médio para sua loja ou enviar uma pontuação mensal de satisfação do funcionário para cada gerente de pessoas da organização.

O Qualtrics alcança loops de fluxo de trabalho por meio de tarefas programadas de extração de dados. Você pode ser específico sobre o que é executado para cada entrada de dados extraída, também conhecida como “lista”. Em outras palavras, esta é a lista de todas as pessoas em uma função específica (por exemplo, gerentes de conta, gerentes de pessoas etc.), ou todas as cidades (por exemplo, Seattle, Nova York, etc.) ou, mais geralmente, todos os itens em uma tabela.

Tarefas de extração de dados

Ao criar fluxos de trabalho desse loop, a primeira tarefa que você deve adicionar é uma tarefa de extração de dados. Esses tipos de tarefas extraem dados de outra fonte que você pode usar ou salvar em outro lugar. As fontes das quais você pode extrair dados incluem:

• Arquivos SFTP
• Salesforce
• SuccessFactors
• Amazon S3

Uma dessas tarefas deve ser adicionada ao fluxo de trabalho antes que você possa especificar o que acontece em cada loop. Depois de começar a criar as tarefas que aparecem em cada loop, você pode adicionar quaisquer tarefas adicionais que desejar.

Requisitos para loops de workflow

Antes de você criar um loop de workflow, considere aqui alguns aspectos importantes:

• Os loops de fluxo de trabalho são compatíveis apenas com fluxos de trabalho programados.
• Você só pode adicionar 1 lista de loop a um workflow de cada vez. Isso significa que, se você tiver adicionado várias tarefas de extração de dados ao seu fluxo de trabalho, só poderá basear um loop de 1 delas.
• Os loops só podem processar arquivos de um determinado tamanho. Isso significa que o arquivo que você extrai deve cumprir os seguintes requisitos:
  • O arquivo não pode ter mais de 10.000 linhas.
    Exemplo: em outras palavras, se você estiver processando usuários, haverá um limite de 10.000 usuários. Se você estiver processando contatos, existe um limite de 10.000 contatos.
    Qdica: Se você exceder 10.000 linhas, o fluxo de trabalho não será executado.
  • O arquivo não pode ter mais de 1GB.
  • Cada linha não pode exceder 1 MB.
• Não é possível adicionar loops dentro de outros loops.
• Você só pode adicionar até 5 tarefas em uma lista de loop.

Configuração de loops de workflow

Esta seção aborda como configurar um loop de fluxo de trabalho usando o exemplo de envio de um e-mail NPS semanal aos usuários que pertencem à função de gerente. No entanto, esta não é a única utilização de loops de workflow.

1. Vá para a página Fluxos de trabalho ou para a guia de uma pesquisa.
   
2. Clique no menu suspenso ao lado de Criar um fluxo de trabalho.
3. Selecione Iniciado em um momento específico.
4. Configure sua programação.
   
   Exemplo: queremos enviar um e-mail de NPS para cada gerente no início de cada semana. Assim, optamos por fazer nosso fluxo de trabalho acontecer semanalmente na segunda-feira, às 9h.
5. Clique no sinal de mais ( + ) para adicionar uma tarefa.
6. Selecione uma tarefa de extração de dados.
   
   Exemplo: escolhemos Extrair dados do colaborador do SuccessFactors porque queremos repetir certos fluxos de trabalho para cada gerente que salvamos no SuccessFactors.
7. Selecione Adicionar um loop para cada.
   
8. Em Para cada item em uma lista, selecione a tarefa que você configurou na etapa 6.
   
9. Clique no sinal de mais ( + ) e selecione as tarefas conforme desejado.
   Aviso: Você deve não use outras tarefas de extração, transformação ou carregamento de dados dentro do seu loop. Consulte esta página para obter uma lista dessas tarefas. Se você quiser usar uma tarefa de carregador de dados, considere criar um fluxo de trabalho ETL padrão em vez de usar loops.
   Exemplo: adicionamos uma tarefa de serviço da Web para que possamos usar a API para obter o nome e o endereço de e-mail de cada usuário.
   
   Exemplo: em seguida, adicionamos uma tarefa de cálculo métrico para encontrar sua pontuação NPS. Configuramos um filtro nesta tarefa para que o campo Dados integrados do gerente seja igual ao ID do usuário. Observe que isso é representado como texto transportado para o campo de ID de usuário extraído durante a chamada à API do serviço Web. Sem esse filtro, a pontuação do NPS incorreta pode ser calculada.
   
10. Clique no sinal de mais ( + ) e selecione as condições conforme desejado.
    
    Exemplo: só queremos enviar um e-mail para pontuações NPS que contam como detratores, por isso definimos uma condição para enviar somente se o NPS da tarefa de cálculo métrico for menor ou igual a 6.
    
11. Clique no sinal de mais ( + ) e adicione mais tarefas conforme desejado.
    Exemplo: adicionamos uma tarefa de e-mail, que nos permite configurar o e-mail NPS que estamos planejando há todo o tempo. Podemos usar texto transportado para obter um endereço de e-mail da tarefa do serviço Web e a pontuação de NPS da tarefa de cálculo de métrica.
    
12. Ao concluir a configuração, verifique se o fluxo de trabalho está ativado.
    

Histórico de execução

Quando você observa o histórico de execução para um workflow com loops, pode ver o histórico de execução para cada um dos loops acionados. Isso permite que você restrinja problemas de performance relacionados a loops de workflow específicos.

Quando você estiver na guia Histórico de execução, clique no nome do fluxo de trabalho para ver mais detalhes. Além do evento e das tarefas do fluxo de trabalho, você também verá Para cada loop. Clique aqui para ver um detalhamento de como cada evento e tarefa foi executado em cada loop.

1. O número de loops em que as tarefas falharam ou foram bem-sucedidas. Esses números são afetados por filtros.
2. Filtre para ver loops em que as tarefas falharam ou tiveram êxito.
   Qdica: veja mais sobre status de fluxo de trabalho.
3. Cada loop é numerado na ordem em que foi executado.
4. A hora em que cada loop foi iniciado (no fuso horário da sua conta).
5. Clique em um loop para ver mais detalhes sobre as tarefas executadas durante esse loop e se elas tiveram êxito. Você também verá o ID para cada tarefa (T-ID #).
6. Clique em uma tarefa para exibir o respectivo arquivo JSON.