Tarefa Jira

Sobre a tarefa do Jira

A Qualtrics permite que você crie ou atualize problemas no Jira com base em eventos que acontecem na Qualtrics. Por exemplo, sempre que um cliente envia uma classificação de produto negativa para sua pesquisa de feedback, você pode criar um problema Jira com base nele.

Para obter informações sobre como trabalhar com problemas do Jira depois que eles são criados ou atualizados, consulte a documentação do Atlassian.

Conectando credenciais Jira ao Qualtrics

Antes de permitir que os usuários da marca utilizem a tarefa Jira, você pode especificar uma conta do Jira que pode ser utilizada em toda a marca. Vá para a guia Extensões da página Admin e selecione Jira para começar.

Depois que as credenciais são adicionadas aqui, qualquer pessoa na marca que tenha acesso à tarefa Jira pode usar essas credenciais para criar ou atualizar problemas nessa conta do Jira.

Se você não adicionar credenciais de toda a marca, os usuários que criam tarefas do Jira ainda terão a oportunidade de adicionar a própria conta do Jira, que só estará disponível para eles.

Ao iniciar a sessão com suas credenciais Jira, você tem a opção de usar um token de API Jira como um método de autenticação. Consulte a documentação do Atlassian para obter instruções.

Configuração de uma tarefa do Jira

1. Navegue até a guia Fluxos de trabalho de uma pesquisa ou a página Fluxos de trabalho independentes.
   
2. Clique em Criar um fluxo de trabalho.
3. Escolha se deseja que seu fluxo de trabalho seja Programado ou Baseado em eventos. Consulte Fluxos de trabalho programados vs. Workflows baseados em eventos  para mais informações sobre cada opção.
4. Configure o evento para seu workflow (se baseado em eventos) ou determine a programação (se programada).
   
5. Clique no sinal de mais ( + ) e, em seguida, em Condições para adicionar condições ao seu workflow. As condições determinam em que circunstâncias o workflow é executado. Consulte Criando condições para obter maiores informações.
6. Clique no sinal de mais ( + ) e, em seguida, em Tarefa.
7. Selecione Jira.
   
8. Determine se você deseja Atualizar problema ou Criar problema.
   
9. Clique em Seguinte.
10. Selecione a conta à qual deseja se conectar.
    
11. Clique em Adicionar uma conta de usuário se você tiver uma conta do Jira que deseja vincular que não está na lista. Observe que todas as contas que você adicionar aqui só estarão acessíveis para você; por outro lado, as contas adicionadas por administradores de marca na página Extensões podem ser usadas por toda a marca.
12. Clique em Seguinte.
13. Selecione a instância na qual você deseja criar um problema.

CRIAR PROBLEMA

1. Selecione o projeto Jira para o qual você deseja criar um problema.
   
2. Selecione o tipo de problema que você deseja criar.
3. Mapeie seus campos e valores. Consulte Mapeamento de campos de problema e valores para mais informações.
4. Quando terminar, clique em Salvar.

ADICIONAR COMENTÁRIO

1. Forneça a chave do problema ao qual você gostaria de adicionar um comentário. Um exemplo de uma chave de problema é QLTRCS-123.
   
   Qdica: Se a chave do problema estiver sendo salva na resposta como dados da pesquisa, você também poderá usar o texto transportado ( {a} ) para recuperar a chave.
2. Insira o comentário que será anexado a este problema. Você pode usar o texto transportado ( {a} ) para incluir dados da pesquisa em seu comentário.

ATUALIZAR PROBLEMA

1. Selecione o projeto Jira do problema que você está atualizando.
   
2. Selecione o tipo de problema que você está atualizando.
3. Forneça a chave do problema que você deseja atualizar. Um exemplo de uma chave de problema é QLTRCS-123.
   Qdica: Se a chave do problema estiver sendo salva na resposta como dados da pesquisa, você também poderá usar o texto transportado ( {a} ) para recuperar a chave.
4. Mapeie os campos e valores que você deseja atualizar. Consulte Mapeamento de campos de problema e valores para mais informações.

Mapeamento de campos de problema e valores

Os campos obrigatórios estão marcados com um asterisco vermelho ( * ). Se você não preencher um campo obrigatório, não poderá criar a tarefa Jira.

• Campos obrigatórios ao criar problemas: todos os tipos de problema requerem um Resumo, que é o nome do problema, ou um título breve que explica o que você realizará. As subtarefas também requerem que você adicione uma raiz. Este é o código do problema (não a chave do problema) da tarefa à qual você deseja adicionar suas subtarefas.
• Campos obrigatórios ao atualizar problemas: você deve adicionar pelo menos um campo com um valor de sua escolha para poder atualizar um problema.

Depois de os campos obrigatórios estarem preenchidos, você pode adicionar quaisquer campos que desejar ao problema. Os campos adicionais que você pode mapear variam por instância e projeto. Exemplos de campos comuns fornecidos por Jira incluem:

• Epic Link: O link épico que você quer adicionar a um problema.
• Cessionário: o usuário Jira ao qual você deseja atribuir o problema. Você pode pesquisar um usuário pelo nome e selecioná-lo no menu suspenso. Como alternativa, você pode colar o código da conta do do usuário (accountId), um identificador exclusivo de 24 dígitos.
• Descrição: Escreva uma descrição geral do problema, como o trabalho envolvido e as ações que serão tomadas para resolvê-lo.
• Problemas vinculados: Vincule o problema a outro problema em Jira para acompanhar o trabalho relacionado. Selecione o tipo de link ao qual você deseja relacionar os problemas e, em seguida, selecione a qual problema deve ser vinculado.
  Qdica: Ao usar texto transportado para referenciar IDs do Jira criadas no fluxo de trabalho, o texto transportado da Chave de problema deve ser usado.

Adicionar campos

1. Use o botão de texto transportado ( {a} ) para definir o valor de um campo com base nas informações coletadas na pesquisa.
   Qdica: Se o evento do fluxo de trabalho não for baseado nas respostas da pesquisa, os campos de texto canalizados serão baseados na fonte do seu evento, por exemplo, campos de dados do ticket para eventos de atualização de tíquete.
2. Para especificar o valor de mais campos no problema que você está criando, clique em Adicionar campo.
3. Para remover um campo, clique no sinal negativo ( – ). Você não pode remover campos padrão.

Clique em Salvar para concluir a configuração da tarefa do Jira.

Perguntas frequentes