Primeiros passos na integração do Jira

Configurar a integração do Jira é rápido e fácil. Este documento fornece orientações sobre a configuração necessária para que toda a organização possa tirar partido desta poderosa integração.

Ligação ao Jira Cloud

Para começar, um administrador do Portal de Contas axe deve estabelecer uma conexão autenticada à instância do Jira. Esta ligação será utilizada em toda a sua organização, por isso é importante que o utilizador que estabelece a ligação tenha acesso a todos os projetos para os quais você pretende enviar questões.

1. Aceda à página "CONFIGURAÇÃO"(https://axe.deque.com/configuration) no Portal da Conta da axe
2. Clique na ligação "Integrações" na navegação "Configuração"
3. Clique no botão "Adicionar nova conexão ao Jira Cloud" Captura de tela do botão "Adicionar nova conexão ao Jira Cloud"(images/integrations-add-new-connection.png)
4. Será aberta uma nova janela pop-up de consentimento OAuth, onde lhe será pedido para iniciar sessão (se já tiver uma sessão ativa do Jira, este passo será ignorado).
5. Uma vez autenticado no Jira, ser-lhe-á pedido que escolha uma instância do Jira à qual se ligar na lista de seleção "Usar aplicação em"
6. Clique em "Aceitar" depois de selecionar uma instância do Jira.
7. A janela pop-up será fechada e uma caixa de diálogo de confirmação será apresentada.
8. Confirme a instância do Jira à qual pretende conectar-se no menu suspenso.
9. Clique em "Concluir"
10. Uma mensagem «Ligação ao Jira realizada com sucesso» será apresentada quando a ligação for estabelecida.

Ligar ao Jira Data Center

1. Aceda à página "CONFIGURAÇÃO"(https://axe.deque.com/configuration) no Portal da Conta da axe
2. Clique na ligação "Integrações" na navegação "Configuração"
3. Clique no botão "Adicionar nova conexão ao Jira Data Center"
4. Clique no botão "Configurar definições" (abaixo do texto "Ligação não configurada").
5. Insira o URL do seu Jira Data Center (exemplo: https://jira.mycompany.com) Captura de ecrã da página de definições do Jira Data Center(images/jira-on-prem-settings.png)
6. Você deve introduzir o Consumer Key (deve corresponder ao valor introduzido no Jira).
7. No Jira Data Center…
   • Clique no botão "Definições" (ícone de engrenagem no canto superior direito da página).
   • Clique no link "Aplicações".
   • Clique no link "Ligações de aplicação".
   • Introduza https://www.deque.com como URL no campo de texto.
   • Clique no botão "Criar novo link".
   • Clique no botão "Continuar".
     • Se vir um aviso semelhante a "Não foi recebida qualquer resposta do URL que introduziu" ou relativo a redirecionamentos, pode ignorá-lo em segurança. O URL por si só não serve para validação; trata-se apenas de um campo obrigatório para que a ligação seja configurada corretamente.
   • Indique um Nome da aplicação (por exemplo, "Deque Jira Integration"; terá de introduzir este mesmo valor na página de Definições do Jira Data Center)
   • Marque a caixa de seleção "Criar link de entrada".
   • Clique no botão "Continuar".
   • Insira um valor no campo Chave do consumidor (por exemplo, "DequeOAuthKey").
   • Insira um valor no campo Nome do consumidor (por exemplo, "Deque Jira Integração").
   • Insira a chave pública apresentada na página "Jira Data Center Settings" no campo Public Key
8. De volta à página de Configurações do Jira Data Center no axe Account Portal...
   • Insira a mesma Chave do Consumidor que foi inserida no Jira Data Center.
   • Clique no botão "Guardar".
   • Clique no botão "Conectar à integração".
   • Na janela pop-up, inicie sessão no Data Center, caso ainda não o tenha feito.
   • Clique em "Permitir".
   • Feche a janela.

Pré-requisito para ligação ao Jira Cloud a partir da instância Deque on-premises

Registe a aplicação cliente do Jira

1. Aceda a https://developer.atlassian.com/console/myapps/
2. Clique no botão "Criar" e selecione a integração "OAuth 2.0".
3. Forneça um nome (por exemplo, _"Acme Corp - axe on-prem - Jira Cloud Integration")
4. Selecione a caixa de seleção Concordo com os termos de desenvolvedor da Atlassian e clique em "Criar"
5. No separador "Distribuição", clique em "Editar" e selecione "Partilha" para o "Estado de Distribuição".
   • Defina "Nome do fornecedor" como "Deque"
   Defina "Política de Privacidade" como "https://www.deque.com/privacy-policy/".
   • Defina "A sua aplicação armazena dados pessoais?" como "Não"
   • Salvar alterações
6. No separador "Permissões", clique no botão "Adicionar" (junto a "Jira API")
7. Assim que estiver pronto para configuração (aguarde alguns instantes), o botão "Adicionar" será substituído por um novo botão "Configurar".
   • Se o botão "Configurar" não aparecer, tente recarregar a página.
8. Clique em "Configurar".
9. Você clique em "Editar Escopos"
   • Deve marcar as seguintes caixas de seleção: "read:jira-work", "read:jira-user", "write:jira-work" e "manage:jira-webhook"
10. Na aba "Autorização", clique no botão "Adicionar"
11. Defina "Callback URL" como "https://axe.deque.com/jira-direct/connected"
12. Clique no botão "Salvar alterações".
13. Descarregue esta imagem (botão direito do rato > guardar imagem como):
14. No separador "Definições", clique em "Alterar avatar" e selecione o logotipo da axe que acabou de guardar.
15. Na secção "Detalhes de autenticação", guarde o "ID do cliente" e o "Segredo", pois são utilizados como parte da sua instalação local.
16. Assim que a instalação local do Deque estiver concluída, siga as etapas acima para estabelecer a ligação ao Jira Cloud(#connecting-to-jira-cloud)

Desconexão de uma conexão ativa

Ao clicar em "Desconectar do Jira", a sessão de autenticação ativa estabelecida anteriormente com o Jira será invalidada. Além disso, os utilizadores já não poderão enviar issues para a instância do Jira que foi desconectada.

Para restabelecer uma ligação desconectada, clique no botão "Conectar ao Jira", que o orientará pelas etapas de conexão (#establishing-a-new-connection) novamente.

Eliminar uma conexão

Após a conexão ter sido desconectada(#disconnecting-an-active-connection), pode excluí-la clicando em "Excluir conexão do Jira".

Modelos

Depois de estabelecer uma conexão(#connecting-to-jira-cloud), podem ser criados modelos para padronizar o mapeamento dos problemas do axe para os campos do Jira. Os modelos ajudam a garantir a criação de problemas de forma consistente em toda a organização.

Para obter informações detalhadas sobre como criar, gerir e usar modelos, consulte a nossa documentação de modelos.

Envio de questões para o Jira

Depois de estabelecer a ligação ao Jira e criar modelos, pode começar a enviar problemas de acessibilidade do axe para o Jira. O processo permite o envio de questões individuais ou de grupos de questões para criar tickets no Jira.

• Enviar problemas da extensão axe DevTools para o Jira
• Enviar problemas do axe Monitor para o Jira.(jira-send-from-axe-monitor)