Xray e Zephyr
Com a integração do Xray Cloud ou do Zephyr (Zephyr Scale, no Jira Cloud), o Proton publica sozinho o resultado das execuções na gestão de testes, cria os Tests dos datasets, transforma um Test Plan num grupo de automação e aceita disparos feitos pelo Jira.
As telas usam os nomes do Xray (Test, Test Execution, Test Plan). Quando a organização usa só o Zephyr, os textos mudam para os nomes dele (Test Case, Test Cycle e Test Plan).
Configurar
Em Configurações > Integrações, cadastre a integração (ver Integrações):
| Xray | Zephyr | |
|---|---|---|
| URL Base | O Jira Cloud onde o Xray está. | O Jira Cloud onde o Zephyr está. |
| Credenciais | Client ID e Client Secret de uma chave de API das configurações globais do Xray. | O Token da API do Zephyr (em "Zephyr API Access Tokens", no perfil do Jira) e a Região da API do Zephyr. |
| Projetos | As chaves dos projetos do Jira (até 50) e o projeto padrão. | Igual. |
Publicar os resultados de um grupo
A publicação é configurada por grupo de automação. No grupo, o botão Xray, no cabeçalho, abre a gaveta Publicação no Xray. Na aba Publicação:
| Campo | O que é |
|---|---|
| Integração do Xray | Só aparece com mais de uma integração. |
| Projeto | O projeto do Jira. |
| Test Plan | O plano onde os resultados entram. Vazio, o Proton cria um plano para o grupo. |
| Pasta dos Tests no Xray | Onde ficam os Tests criados pelo Proton. |
| Criar o Test do dataset que ainda não tem | O Proton cria o Test na primeira publicação do dataset. |
| Enviar a evidência ao terminar | Manda o relatório PDF e os prints dos passos. |
| Publicar os lotes do grupo | Liga e desliga a publicação. |
Depois de salvar, o botão mostra o plano em uso (ou que a publicação está pausada). Parar de publicar desliga.
Como a publicação acontece
A publicação é automática: cada lote de execuções do grupo vira uma Test Execution, com o nome "Proton · grupo · ciclo · lote", ligada ao Test Plan. Para cada execução vão o status, os passos, os bugs ligados, um comentário com o link da execução e, se pedido, a evidência (até 10 MB por arquivo e 15 MB de prints por execução).
- O Proton junta as execuções que terminam em sequência e publica em poucos segundos.
- Se o Xray ou o Zephyr recusar, o Proton tenta de novo, com intervalos cada vez maiores, até 8 vezes.
- Um dataset sem Test (com a criação automática desligada) fica de fora, e a tela avisa quantos ficaram.
A aba Lotes mostra cada lote: Na fila, a chave da Test Execution (que abre no Jira), Nada a publicar ou o erro com o motivo. Publicar de novo manda o lote outra vez.
No detalhe da execução, os selos da Test Execution, do Test e do Test Plan abrem cada um no Jira.
O Test de cada dataset
Cada dataset se liga a um Test. Além da criação automática na publicação:
- no cartão do dataset, Sem Test oferece Criar no Xray ou Ligar a um Test que já existe;
- na lista de datasets, marque vários e use Enviar para o Xray para criar os Tests de uma vez.
O Test criado pelo Proton leva os passos dos componentes. Num Test que já existia, o Proton não muda os passos. As issues que o Test cobre no Xray viram requisitos do dataset no Proton. Ver Jira.
Importar um Test Plan
No Centro de Automação, Importar do Xray cria um grupo de automação a partir de um Test Plan:
- Escolher o plano: o projeto e a busca do plano.
- Revisar os Tests: dê o Nome do grupo e escolha a Automação dos datasets novos. Para cada Test do plano, a tela mostra o que fazer: Já ligado, Ligar a um dataset sugerido, Escolher dataset, Criar dataset ou Não importar. Os filtros Ligados, Sugeridos e Sem dataset ajudam a revisar.
- Confirme. O grupo nasce com um ciclo e, com o módulo de Qualidade, com a finalidade de teste.
O grupo importado mostra de que plano veio, e Sincronizar com o plano traz os Tests que entraram no plano depois. A importação é feita no computador.
Disparar pelo Jira
O grupo pode aceitar disparos feitos no Jira, por uma regra do Jira Automation: por exemplo, rodar o plano quando uma versão vai para homologação. A configuração fica na aba Disparo pelo Jira da gaveta, depois da publicação:
- Marque Aceitar disparo pelo Jira.
- Escolha onde roda (runner ou cluster), o Ambiente, se grava vídeo e se avisa por e-mail quando o lote terminar.
- Use Salvar o disparo.
A aba mostra então A regra no Jira Automation: o método, o endereço, os cabeçalhos e o corpo da chamada, cada um com o botão de copiar. Monte a regra no Jira com esses dados e com o token de API de uma conta robô que possa executar no Centro de Automação (o perfil Executor pode).
A regra chama o Proton com a chave de um Test Plan ou de uma Test Execution, e o Proton roda os datasets ligados aos Tests dela. Últimos disparos mostra cada pedido, Disparado ou Recusado com o motivo (chave inválida, nenhum grupo aceita, ciclo fechado, sem runner, pedido repetido em menos de um minuto e outros). O disparo conta como uma execução imediata.
No Zephyr, o Test Cycle e o Test Plan não são issues do Jira: a regra pergunta a chave ou roda a partir de uma issue ligada a um único Test Cycle.
Permissões e celular
| Ação | Permissão no perfil |
|---|---|
| Ver e configurar a publicação e o disparo | Grupo de Automação: read e update |
| Importar e sincronizar um Test Plan | Grupo de Automação: create (e Dataset: create, para criar datasets) |
| Criar e ligar o Test do dataset | Dataset: read e update |
| O robô do disparo pelo Jira | Centro de Automação: run |
A gaveta da publicação e os selos do detalhe da execução funcionam no celular; a importação do Test Plan, não.