Tarefa do código

Suite
Customer Experience Employee Experience Strategy & Research
Produto
Qualtrics
O que há nesta página

Sobre as tarefas de código

Atenção: O acesso e o uso contínuo desse característica podem exigir uma atualização de sua licença. Contato seu executivo Conta Qualtrics para obter mais informações.

A tarefa código permite que você use JavaScript personalizado para executar operações de manipulação de dados, formatação e cálculo antes ou depois de outras tarefas em um fluxo de trabalho. Por exemplo, você pode usar a tarefa código para transformar a saída de retorno de uma chamada de API em um resultado mais fácil de usar (digamos que você precise comunicar o resultado ao seu gerente não técnico). Em seguida, você pode canalizar esse resultado transformado para uma tarefa de e-mail que envia um e-mail ao seu gerente.

Atenção: os recursos de programação personalizados são fornecidos no estado em que se encontram e requerem conhecimento de programação para serem implementados. O suporte da Qualtrics não oferece assistência nem consultoria em codificação customizada. Em vez disso, você pode perguntar para nossa comunidade de usuários dedicados. Se você quiser saber mais sobre nossos serviços de codificação personalizada, entre em contato com o seu Executivo de Contas da Qualtrics.

Configuração de tarefas de código

Acesse a página independente Fluxos de trabalho ou a guia Fluxos de trabalho de uma pesquisa.
In the workflows tab, clicking "create a workflows" and then "started when an event is received"
In the workflows tab, clicking "create a workflows" and then "started when an event is received"
Clique em Criar um fluxo de trabalho.
Selecione Iniciado quando um evento for recebido.
Selecione o evento que inicia o fluxo de trabalho. Normalmente, esse é um evento de resposta à pesquisa.
selecting an event to start the task
selecting an event to start the task
Se desejar, clique no sinal de mais ( + ) e selecione Adicionar uma condição para adicionar condições ao seu fluxo de trabalho. As condições ajudam a determinar quando um fluxo de trabalho é acionado. Consulte a página vinculada para obter mais informações sobre as condições do edifício.
selecting an event to start the task
selecting an event to start the task
Clique no sinal de mais ( +) e selecione Add a tarefa (Adicionar uma tarefa ).
clicking the plus sign and then task
clicking the plus sign and then task
Selecione a tarefa Código .
the code task
the code task
Digite sua expressão JavaScript na caixa. Consulte a seção sobre práticas recomendadas para obter informações úteis ao escrever seu código.
adding code and a summary to the code task
adding code and a summary to the code task
Qdica: o editor de código mantém um histórico de edições para que você possa desfazer as alterações no código pressionando CTRL + Z (PC) ou CMD + Z (Mac). Use SHIFT + CTRL + Y (PC) ou SHIFT + CMD + Y (Mac) para refazer uma alteração.
Qdica: ao escrever seu código, você poderá ver erros na janela. Esses erros estão verificando erros de sintaxe, não erros de execução. Os erros de sintaxe sempre aparecerão em inglês, independentemente da configuração de idioma da sua conta. A execução não ocorre até que a tarefa seja salva e o fluxo de trabalho seja acionado.
a syntax error appears in yellow in the javascript editor
a syntax error appears in yellow in the javascript editor
Se desejar, insira um resumo tarefa que explique o que o código JavaScript deve realizar.
Clique em Testar código para executar o código em seu navegador local.
Qdica: como eles ocorrem em ambientes diferentes, testar o código pode não dar exatamente o mesmo resultado que executá-lo no fluxo de trabalho.
Use o menu {a} Adicionar texto transportado para adicionar texto transportado à sua expressão JavaScript. Texto transportado é útil para extrair valores do seu evento, como, por exemplo, extrair as respostas do pesquisa do seu entrevistado. Texto transportado é avaliado antes da execução de sua expressão JavaScript.
Se você precisar apagar seu código e começar de novo, clique em Redefinir para o padrão.
Quando terminar, clique em Salvar.
A tarefa código geralmente é emparelhada com outra tarefa para usar a saída da tarefa código. Clique no sinal de mais ( + ), selecione Adicionar uma tarefa e escolha sua avançar tarefa. Consulte esta página para obter uma visão geral das tarefas.
clicking the plus sign and then task
clicking the plus sign and then task
Qdica: ao configurar suas tarefas subsequentes, a saída da tarefa código estará disponível no menu texto transportado da tarefa.
choosing the code task result in the piped text menu of an email task
choosing the code task result in the piped text menu of an email task

Limites de execução de JavaScript

Ao escrever seu código JavaScript para incluir na tarefa código, esteja ciente dos seguintes limites de execução:

  • Tempo máximo de execução: 10 segundos
  • Comprimento máximo do JavaScript: 200 KB
  • Nenhuma solicitação API de saída: Por motivos de segurança, a tarefa código não pode fazer solicitações de saída para outras APIs ou serviços, nem pode recuperar outras bibliotecas JavaScript em tempo de execução usando solicitações HTTP.

Se seu código JavaScript exceder esses limites, a tarefa código falhará. Se o seu fluxo de trabalho fluxo de trabalho falhar, vá para Relatórios de fluxos de trabalho para obter mais informações sobre o motivo da falha.

Auxiliares de codificação e decodificação

Se você quiser codificar strings em base64 ou decodificá-las para utf-8 dentro da sua tarefa de código, pode usar os seguintes auxiliares:

  • função base64ToUtf8(base64String: string): string
  • função utf8ToBase64(utf8String: string): string

Essas funções são compatíveis com UNICODE, portanto aceitam caracteres como emojis, tremas, acentos e muito mais.

Práticas Recomendadas

Ao escrever seu JavaScript, siga as práticas recomendadas abaixo:

  • Seu código deve estar em conformidade com a sintaxe ES6.
  • Seu código será executado em usando JavaScript puro.

  • Seu código deve retornar o resultado como um objeto JavaScript. Quando o resultado de retorno é formatado dessa forma, o sistema pode inferir automaticamente quais campos seu código personalizado retornará e fornecer texto transportado apropriado para as tarefas subsequentes.

    Exemplo: Neste exemplo, retornamos vários resultados:

    função codeTask() {
    retornar {
    hello: "world",
    foo: "bar",
    status: 200
    };
    }

    Exemplo: Neste exemplo, retornamos um único resultado:

    função codeTask() {
    retorne {
    resultado: "hello world",
    };
    }

  • Dependendo do tipo de informação que você está esperando, talvez seja necessário encapsular a sintaxe do localizador entre aspas. Você precisará adicionar aspas se quiser que o localizador seja resolvido como uma cadeia de caracteres. Não é necessário adicionar aspas se ele resolver para um objeto
  • Ao usar texto transportado para campos que possam conter aspas, você deve usar literais de modelo(`) em vez de aspas ao redor do texto transportado.

Exemplo: Por exemplo, um código como o que aparece abaixo precisaria de aspas:

função codeTask() {
let ticketId = "~{ch://OCAC_31HNMUuEpm3Jg/exports.data.key}";
...
}

Exemplo: Uso de uma Tarefa de código com uma Tarefa de serviço da Web

Este exemplo mostra como utilizar uma tarefa de código em conjunto com uma tarefa de serviço web. É possível usar uma tarefa de código com uma tarefa de serviço da Web para transformar a resposta do pesquisa de um respondente em um código compatível com a API e, em seguida, usar os valores retornados para executar uma chamada de API. Em seguida, você pode obter os resultados da chamada à API e usar outra tarefa de código para transformar os valores retornados em uma resposta amigável.

Neste exemplo, estamos criando um localizador de restaurantes no Qualtrics. Vamos nos aprofundar nos detalhes um pouco mais tarde, mas abaixo está uma visão geral de como faremos isso.

Em nossa pesquisa, perguntaremos aos entrevistados onde eles querem comer e como querem retornar resultados.
Para realizar nossa pesquisa de restaurantes, usaremos um aplicativo localizador de restaurantes de terceiros. Usamos uma tarefa de código para transformar as respostas do respondente pesquisa em um formulário que a API do localizador de restaurantes de terceiros pode usar.
Em seguida, usamos uma tarefa de serviço da Web para executar uma chamada de API para o localizador de restaurantes de terceiros, que retorna nossos resultados como JSON.
Usamos outra tarefa de código para transformar o JSON resultante em um formato que os humanos possam ler.
Podemos usar uma última tarefa para enviar essas informações para os entrevistados ou para nós mesmos. Por exemplo, use uma tarefa de e-mail para enviar um e-mail ao respondente com os resultados retornados.

Criação de um localizador de restaurantes com tarefas de código

Em sua pesquisa, crie as perguntas que alimentarão a tarefa código. No nosso caso, é uma pergunta entrada de texto que pergunta onde procurar restaurantes e uma pergunta múltipla escolha que pergunta como classificar resultados.
creating the survey and navigating to workflows
creating the survey and navigating to workflows
Navegue até Fluxos de trabalho.
Crie um novo fluxo de trabalho.
Para o evento fluxo de trabalho, selecione oevento “Resposta Pesquisa ” e configure-o para ser acionado quando uma nova resposta for criada. Consulte a página vinculada para obter mais informações.
adding a survey response event and then adding a task
adding a survey response event and then adding a task
Clique no sinal de mais ( + ) e selecione Adicionar uma tarefa.
Selecione a tarefa Código .
selecting the code task
selecting the code task
Para o código, estamos transformando as respostas do entrevistado nos valores necessários para a API do localizador de restaurantes.
inserting piped text into the code task
inserting piped text into the code task
Utilizamos texto transportado para inserir a pergunta da qual se originam as respostas dos entrevistados.
Clique em Save (Salvar ) para salvar a tarefa.
Clique no sinal de mais ( + ) e selecione Adicionar uma tarefa.
clicking the plus sign and then task
clicking the plus sign and then task
Selecione a tarefa Web Service e escolha sua autenticação. Consulte esta página para obter mais informações.
selecting the webservice task
selecting the webservice task
Digite o URL que está tentando acessar.
the URL is in the URL field and the piped text icon is highligted
the URL is in the URL field and the piped text icon is highligted
Acrescente seus parâmetros usando strings de consulta. Use o menu texto transportado, {a}, para usar os valores da sua pesquisa e da tarefa código anterior.

Exemplo: Nossa URL completa é

api://OCAC_Zt2TNQYggAb6u89/sort_by}&location=${q://QID1/ChoiceTextEntryValue}

Isso contém dois parâmetros: sort_by e location. Para sort_by, o valor é o resultado de nossa primeira tarefa de código. Para localização, o valor é a resposta do entrevistado à pergunta entrada de texto.

Conclua a configuração da tarefa conforme necessário. Consulte as tarefas do Web Service se precisar de ajuda.
Qdica: na tarefa de serviço da Web, você pode testar os valores retornados esperados para garantir que a chamada à API funcione.
two variables in the test box for testing the web service
two variables in the test box for testing the web service
Se necessário, crie caminhos JSON personalizados que possam ser usados em outras tarefas. Em nosso exemplo, criamos um caminho "businesses" que retorna uma matriz de empresas dos resultados da pesquisa.
a path for businesses in the piped text section to use in the future code task
a path for businesses in the piped text section to use in the future code task
Qdica: Se você testou sua tarefa de serviço da Web, o Qualtrics identificará automaticamente os caminhos JSON e os adicionará aqui. Sinta-se à vontade para excluir os desnecessários clicando no ícone lixeira lixeira.
Clique em Salve (Salvar).
Clique no sinal de mais ( + ) e selecione Adicionar uma tarefa.
clicking the plus sign and then task
clicking the plus sign and then task
Selecione a tarefa Código .
selecting the code task
selecting the code task
Agora, precisamos transformar o JSON resultante da tarefa de serviço da Web em um formato legível. No nosso caso, estamos transformando-o em HTML para uso em um e-mail.
a code task, transforming the json from the webservice into html
a code task, transforming the json from the webservice into html
Para recuperar o JSON resultante da tarefa de serviço da Web, use o menu texto transportado, {a}.
Clique em Salve (Salvar).
Qdica: se estiver usando texto transportado, você poderá receber um aviso, pois o designador de texto transportado não é um JavaScript válido. No entanto, isso será resolvido antes da execução, pois o designador de texto transportado será substituído pelo valor do campo antes que o código seja executado.
Clique no sinal de mais ( + ) e selecione Adicionar uma tarefa.
Selecione Email.
choosing the email task
choosing the email task
Configure sua tarefa de e-mail. Consulte a página vinculada para obter mais informações.
Insira o resultado de sua segunda tarefa código no corpo do e-mail. Isso é o que retorna os resultados da pesquisa de restaurantes.
adding the piped text for the final code task into the email task
adding the piped text for the final code task into the email task
Exemplo: Veja abaixo a aparência do editor de e-mail com as respostas do respondente inseridas, juntamente com o resultado da segunda tarefa de código.
the email editor with the piped text for displaying the results of the action
the email editor with the piped text for displaying the results of the action
O e-mail resultante retorna os resultados de pesquisa selecionados por seu respondente!
the resulting email, with restaurant names, rating, and review
the resulting email, with restaurant names, rating, and review

Perguntas frequentes

Tenho acesso a todas as extensões disponíveis nos modelos do Workflows?

Existe um link para todos os eventos e tarefas do Workflows?

O que são modelos de fluxos de trabalho?

O que são fluxos de trabalho? / Onde estão as ações?
Muitas das páginas neste site foram traduzidas do inglês original usando tradução automática. Embora na Qualtrics tenhamos feito nossa diligência prévia para obter as melhores traduções automáticas possíveis, a tradução automática nunca é perfeita. O texto original em inglês é considerado a versão oficial, e quaisquer discrepâncias entre o inglês original e as traduções automáticas não são juridicamente vinculativas.

Isto foi útil?

O feedback que você envia aqui é usado apenas para ajudar a melhorar essa página.

Isso é ótimo! Obrigado pelo seu feedback!

Obrigado pelo seu feedback!