Templates de Integração do Jira

Os modelos são mapeamentos predefinidos dos campos de problema do axe para os campos do Jira que facilitam a criação de formatos padronizados para tickets do Jira. Os modelos podem ser criados para qualquer combinação de projeto e tipo de problema e podem ser utilizados por qualquer membro da sua organização ao enviar questões para o Jira.

Gestão de acesso a modelos

Quem pode criar modelos

Qualquer pessoa com acesso à integração do Jira pode criar modelos.

Quem Pode Editar ou Excluir Modelos

• Autores de modelos: Os utilizadores que criaram o modelo podem editar ou eliminar os seus próprios modelos.
• Administradores do Portal de Contas axe: Podem editar ou eliminar qualquer modelo da organização.

Permissões de modelos

Os modelos são recursos de toda a organização.

• Todos os utilizadores com acesso à integração do Jira podem usar qualquer modelo.
• Só os autores dos modelos e os administradores podem alterar modelos.
• Os modelos não podem ser limitados a utilizadores ou grupos específicos.

Criar um modelo

1. Aceda à página "CONFIGURAÇÃO" no Portal da Conta axe (ou aceda diretamente a https://axe.deque.com/configuration/integrations e salte o passo 2)
2. Clique na ligação "Integrações" na navegação "Configuração"
3. Clique em "Configurar modelos do Jira"
4. Clique no botão "Adicionar modelo"
5. Preencha os campos nas etapas "Informações do modelo", "Mapeamento de campo" e "Mapeamento de impacto". Pode consultar mais detalhes sobre cada etapa nas secções seguintes.
6. Revise as informações preenchidas nas etapas 1 a 3
7. Clique em « Guardar »

Para utilizar um modelo, consulte a secção Envio de problemas para o Jira.

Adicionar informações ao modelo

O primeiro passo na criação de um modelo é configurar as informações básicas que determinam onde e como os problemas serão criados no Jira.

1. Nome do modelo: Introduza um nome descritivo para o seu modelo. Este nome será apresentado na lista de modelos ao enviar incidências para o Jira. Exemplo: "Bug A11Y", "Acessibilidade Móvel", "Violações da WCAG 2.1"
2. Projeto: Selecione o projeto Jira onde as tarefas serão criadas ao usar este modelo. O menu suspenso exibe todos os projetos nos quais você tem permissão para criar problemas.
3. Tipo de item: Escolha o tipo de item que será criado no Jira. As opções disponíveis variam conforme a configuração do projeto selecionado. Tipos comuns: Bug, Tarefa, História, Subtarefa
4. Ativar capturas de ecrã do Axe Issue como anexos: Quando esta opção estiver selecionada, as capturas de ecrã geradas pelas ferramentas axe serão automaticamente anexadas ao ticket do Jira. Isto fornece um contexto visual para os programadores ao corrigirem os problemas.

Configurar o mapeamento de campos

Na página de mapeamento de campos, pode mapear campos do axe para campos do Jira para transferir automaticamente os dados dos problemas de acessibilidade ao criar tickets:

1. Na lista suspensa do campo Jira, selecione o campo Jira que pretende mapear.
2. Na lista suspensa do campo Axe, selecione o campo de dados Axe correspondente.
3. Clique em + Adicionar campo axe para mapear campos adicionais
4. Clique no botão de menos (−) para remover um mapeamento
5. Clique no botão Avançar para guardar

Importante: Todos os campos obrigatórios do Jira (p. ex., Resumo) são exibidos automaticamente nesta página. Se estes campos não forem mapeados para os campos axe, os utilizadores serão solicitados a preenchê-los manualmente ao enviar os problemas.

Campos comuns do axe disponíveis para mapeamento incluem:

1. Regra: o ID da regra de acessibilidade que foi violado
2. Descrição: descrição detalhada do problema de acessibilidade
3. Como corrigir: instruções para resolver o problema
4. URL de ajuda: link para a documentação da regra
5. Resumo do problema: breve resumo do problema.
6. Seletor: Seletor CSS do elemento
7. Fonte do Elemento: código fonte HTML do elemento
8. URL da captura de ecrã: a URL da captura de ecrã associada à questão
9. Etiquetas: lista de etiquetas de texto de metadados para o problema (categorias, identificadores de pontos de verificação WCAG, etc.)
10. Nome do teste: nome do teste guardado em que o problema foi encontrado
11. URL de partilha do problema: Ligação direta para o problema partilhado no produto Axe
12. Criado em: data em que o problema foi identificado
13. URL de teste do problema: URL da página testada
14. Detetado por: utilizador que realizou o teste em que o problema foi detetado
15. Título da página testada: título do documento da página testada
16. Versão Axe: a versão do axe-core utilizada para o teste

Campo de descrição do Jira

O campo de descrição do Jira segue uma estrutura padronizada que não pode ser personalizada ou mapeada. Quando os problemas são enviados para o Jira, incluem automaticamente uma descrição estruturada com as seguintes secções:

• Descrição do problema: descrição do problema.
• Como corrigir: instruções passo a passo para remediação.
• Localização do problema:
  • Seletor: seletor CSS do elemento com o problema.
  • Fonte do elemento: código-fonte HTML do elemento com problema.
• URL da página testada: URL da página testada.
• Detalhes adicionais:
  • Impacto: nível de gravidade do problema.
  • Ligação para o relatório do problema no Portal da Conta do Axe: ligação para o relatório do problema no Portal da Conta do Axe (se disponível).
  • Ajuda sobre a regra: ligação para a documentação da regra.

Configurar mapeamento de impacto

Os problemas de acessibilidade no axe são classificados de acordo com o nível de impacto, que indica o grau de gravidade com que afetam os utilizadores. Na página de Mapeamento de Impacto, pode mapear estes níveis de impacto para os valores de prioridade do Jira, garantindo a devida priorização dos tickets.

Tratamento de erros

Validação de campo obrigatório

Caso um campo obrigatório fique em branco no modelo

No momento de envio do problema, o sistema irá mostrar uma mensagem de erro e deve preencher o campo obrigatório antes de enviar o problema para o Jira. Uma issue do axe não pode ser enviada para o Jira até que todos os campos obrigatórios estejam preenchidos.

Se um modelo mapear um valor para um campo obrigatório do Jira, mas esse valor não existir em todos os produtos axe

• Ao criar o modelo, o sistema exibirá uma mensagem de aviso indicando que o campo mapeado não está disponível em todos os produtos Axe, mas os utilizadores podem avançar com a criação do modelo apesar do aviso.
• Durante o envio de questões para o Jira, se um modelo contiver mapeamentos para campos que estejam em falta num produto Deque, será apresentada uma mensagem de aviso. O sistema irá realçar os campos que necessitam de preenchimento manual e os utilizadores devem inserir manualmente os valores para todos os campos obrigatórios em falta antes de o problema poder ser enviado. Os problemas só serão enviados ao Jira quando todos os campos obrigatórios forem preenchidos, seja por meio de mapeamentos existentes ou entrada manual.

Editar e eliminar modelos

Para editar ou excluir um modelo, aceda ao menu "Opções" do respetivo modelo e serão apresentadas duas opções:

• Editar modelo.
• Excluir modelo.