Integrações
Em Configurações > Integrações a organização liga o Proton às ferramentas que já usa: o git com o código das automações, o Jira, o Xray e o Zephyr, o BrowserStack e o Firebase. Cada integração guarda o endereço e as credenciais da ferramenta, e libera no portal as peças que dependem dela.
Do Proton para a sua empresa
No topo da tela, Do Proton para a sua empresa leva para o caminho inverso: os dados do Proton nas ferramentas da empresa.
- API de consulta (em Configurações > API de consulta): execuções, logs, indicadores e ocorrências no Data Warehouse, no Power BI e nos painéis, com um token só de leitura. Ver Monitoramento e Data Warehouse.
- Webhooks (na aba Webhooks de Configurações > Alertas e webhooks): os eventos na hora, assinados, para o monitoramento e os chamados. Ver Webhooks.
As duas fazem parte do plano Enterprise.
O que cada integração liga
| Integração | Categoria | Campos | O que liga no Proton |
|---|---|---|---|
| GitHub | Versionamento | Organização (opcional, só para o teste) e Token | Repositórios no GitHub.com. |
| GitLab | Versionamento | URL Base (vazia para o gitlab.com) e Token | Repositórios no gitlab.com ou num GitLab da empresa. |
| Bitbucket | Versionamento | Workspace, Usuário e Chave de Acesso | Repositórios no Bitbucket Cloud. |
| Jira | Gerenciamento de Projetos | URL Base, E-mail e Token da API | Requisitos, bugs e as colunas do Jira na rastreabilidade. Ver Jira. |
| Xray | Gestão de Testes | URL Base, Client ID e Client Secret, e os projetos | Publicação dos resultados, Tests, importação de Test Plan e disparo pelo Jira. Ver Xray e Zephyr. |
| Zephyr | Gestão de Testes | URL Base, região da API, Token da API e os projetos | O mesmo que o Xray, com os nomes do Zephyr. |
| BrowserStack | Infra de Testes | Usuário e Chave de Acesso | Aparelhos na nuvem no disparo e o envio dos apps. Ver Apps Mobile. |
| Firebase | Distribuição de Apps | ID do Projeto e a Chave da Conta de Serviço (JSON) | A importação das releases do App Distribution em Apps Mobile. |
A tela também oferece Azure DevOps, SauceLabs, Synthesized, Slack e Teams. Elas podem ser cadastradas, mas nenhuma tela do Proton usa essas integrações por enquanto.
O Jira, o Xray e o Zephyr precisam ser da nuvem (Jira Cloud, em https://suaempresa.atlassian.net). As versões Data
Center e Server não são atendidas.
Cadastrar
Adicionar abre Criar Integração:
- Selecione a plataforma entre os cartões.
- Em Geral, dê o Nome e preencha o endereço ou o campo de contexto da plataforma.
- Em Autenticação, preencha as credenciais. Os campos de segredo ficam mascarados, com o olho para conferir.
- No Xray e no Zephyr, informe os Projetos do Jira (as chaves, como QA) e o Projeto padrão, que as telas mostram já escolhido. No Zephyr, escolha também a Região da API do Zephyr, a mesma do seu Jira Cloud (na dúvida, Estados Unidos).
- Testar Conexão confere as credenciais antes de salvar. Salve.
As credenciais ficam cifradas no Proton e nunca voltam para a tela. Na edição, o tipo não muda, e as credenciais só são trocadas por Atualizar Credenciais (ou mantidas com Manter credenciais atuais).
:::tip Use uma conta de serviço Para as credenciais, prefira um usuário técnico da ferramenta em vez da conta de uma pessoa: a integração não para quando alguém sai da empresa. :::
A lista
Os cartões mostram o nome, o tipo, a categoria, o endereço, a data da última validação e o status (Ativo ou Erro). A busca e os filtros (Ativas, Com erro) ajudam a achar uma integração.
Testar Conexão, no cartão, testa as credenciais salvas e atualiza o status. O teste confere de fato as credenciais do GitHub, do GitLab, do Jira, do Xray, do Zephyr, do BrowserStack e do Firebase.
Depois de cadastrar o Jira, o Xray ou o Zephyr, as peças deles podem levar até um minuto para aparecer no portal.
Apagar
Antes de apagar, veja o que depende da integração:
- uma integração git usada por um repositório não pode ser apagada: troque a integração do repositório antes;
- apagar o Jira, o Xray ou o Zephyr apaga no Proton os requisitos e os bugs ligados, a publicação dos grupos, os vínculos dos datasets com os Tests e o histórico de publicação. Nada muda no Jira.
Integrações git
O caminho completo do código, da integração ao runner, está em Sistemas e repositórios. Em resumo: cadastre a integração com o token, cadastre o repositório usando essa integração, ligue o sistema ao repositório e escolha a branch no disparo.
O token precisa ler os repositórios das automações e listar as branches. Nos repositórios marcados com BDD no GitHub, o
Proton também cria a branch proton-bdd, e o token precisa poder escrever.
Permissões e celular
Ver, criar, editar e apagar as integrações são permissões da entidade Integration, na aba Configuração do perfil. Testar a conexão de uma integração salva exige editar.
A tela é feita para o computador. As peças do Jira, do Xray e do Zephyr no detalhe da execução e na rastreabilidade funcionam no celular.