Categories
Módulos API

Jira

Integração com Jira — rastreando os status da tarefa no Usesk, bem como as alterações recentes e comentários sobre elas.

1. Crie um campo personalizado com o tipo de texto. Abra "Configurações" - "Campos personalizados", clique em "Criar".

2. Crie um bloco dinâmico. Abra a seção "Configurações" - "Blocos", clique em "Adicionar um bloco dinâmico":

3. Adicionar parâmetros (POST):

  • jira_domain - domínio Jira. Escreva de https: // (parâmetro obrigatório);
  • jira_username - nome de usuário em Jira. É necessário criar um bloco dinâmico com dados de administrador no Jira (parâmetro obrigatório);
  • jira_secret - senha da conta, cujo nome de usuário você especificou no campo jira_username (parâmetro obrigatório);
  • usedesk_field_id - ID do campo personalizado da página 1 (parâmetro obrigatório). Este campo é necessário para vincular a tarefa de graxa ao ticket;
  • usedesk_token - token de API de qualquer canal de API (parâmetro obrigatório). Crie um canal API no Usesk ou use o existente, copie o valor do campo "Chave secreta";
  • new_comments_amount - número de últimos comentários na tarefa de Jira, que está vinculado ao ticket;
  • last_changes_amount - número das últimas alterações na tarefa de Jira, que está vinculado ao ticket;
  • block_height - a altura do bloco.

Depois de fazer todas as alterações, clique em "Salvar".

Insira qualquer ticket e especifique o número da tarefa do Jira no campo personalizado do item 1.

Por exemplo: USEDESK-3358

O sistema pesquisará no Jira o número da tarefa especificado no campo personalizado (item 1).

No ticket, um bloco adicional está localizado no lado direito da página sob a ficha do cliente e outros blocos adicionais (se houver), cuja altura você pode ajustar usando o parâmetro adicional block_height. Um link do bloco será aberto em uma nova janela para mover do Usedesk para o Jira.

Controle de status da tarefa, alterações recentes e comentários sobre ela.


Anexar uma tarefa à ficha de solicitação

Você pode vincular uma ou mais questões do Jira a uma ficha de solicitação. O link estará no campo adicional do item 1. Vincular - veja informações sobre a (s) tarefa (s) específica (s) na ficha de solicitação. Para fazer isso, clique em "Link" e preencha o campo "Número" com a chave do problema Jira. Por exemplo: USEDESK-3358.


Informações no bloco adicional da ficha de solicitação

As informações no bloco adicional da ficha de solicitação incluem as seguintes informações e funções:

1. Botão "Link", "Desvincular" - botões para anexar / excluir uma tarefa na ficha de solicitação.

  • Se você vinculou uma tarefa à ficha de solicitação, haverá uma tarefa vinculada no bloco. Para desvincular uma tarefa - clique no botão Desvincula

  • Se você vinculou várias tarefas à ficha de solicitação, o bloco conterá uma lista Chinesa. A chave de tarefa na lista geral é um link para alternar do Usedesk para o Jira (no exemplo, USEDESK-7726). Para ir a ficha de uma tarefa específica, clique no nome. Para desvincular uma tarefa - use o cartão de tarefas e clique no botão "Desvincular"

A lógica correspondente é gravada no log da ficha de solicitação.

2. Botão " Voltar à lista de tickets " - para retornar à lista geral de tarefas do Jira vinculadas a ficha de solicitação (exibido se houver mais de 1 tarefa vinculada);

3. Número e nome da tarefa - um link para alternar do UseDesk para o Jira, abre em uma nova janela;

4. Campos adicionais - informações adicionais no Jira, que você pode configurar para serem exibidas na ficha de tarefas. Para fazer isso, clique na engrenagem e selecione os campos criados na ficha de tarefas. A ordem dos campos depende da numeração do outro campo selecionado;Atenção! Alguns campos podem não ser exibidos corretamente para exibição. Estamos trabalhando nisso.

5. Últimas alterações - últimas alterações na tarefa. Você pode configurar a quantidade usando o parâmetro last_changes_amount no bloco dinâmico (ver Configurações de integração, p. 3);

6. Últimos comentários - os últimos comentários do problema. Você pode ajustar a quantidade usando o parâmetro "new_comments_amount" no bloco dinâmico (veja Configurações de integração, p. 3);

7. O botão " Escrever um comentário " é uma função com a qual você pode deixar um comentário sobre um problema sem ir ao Jira. O log correspondente será gravado no log da ficha de solicitação.