Integração GitHub / GitLab

Com a integração com rastreadores de issues, você pode vincular issues do GitHub e do GitLab a um ticket e acompanhar o estado delas enquanto trabalha nele. O Zammad armazena apenas as URLs das issues no ticket. Título, estado, tipo, milestone, responsáveis e etiquetas são lidos do GitHub ou do GitLab cada vez que você abre o painel. Nada é gravado de volta no rastreador. Apenas issues: pull requests e merge requests não podem ser vinculados.

Os painéis são opcionais. Se você não os vê na barra lateral do ticket, seu administrador ainda não ativou a integração. Os clientes também não veem os vínculos. Administradores podem saber mais nas páginas de integração com o GitHub e o GitLab.

Ver issues vinculadas

Abra a aba GitHub ou GitLab na barra lateral de um ticket que já tenha issues vinculadas. Cada entrada começa com um ícone do estado da issue, seguido do número e do título. Clique no título para abrir a issue no GitHub ou no GitLab. Cada entrada também mostra Milestone, Assignees e Labels da issue. As issues do GitHub mostram também um Type. Um campo só aparece quando a issue o tem. O selo na aba conta todas as issues vinculadas, não apenas as abertas. O Zammad lê o estado quando o painel carrega e não monitora as issues, então nenhuma notificação é enviada quando uma issue muda. Se o painel mostrar Loading failed. em vez das issues, peça ao seu administrador que verifique o token.

Vincular uma issue

Selecione Link issue no menu ao lado do título do painel, informe a URL de uma única issue e confirme. O Zammad aceita links como https://github.com/organization/repository/issues/42 ou https://git.example.com/group1/project1/-/issues/1. Ao criar um ticket, você também pode vincular issues. Elas são salvas com o novo ticket.

O Zammad ignora uma URL que já está vinculada ao ticket. Ele também rejeita uma URL que não consegue resolver, geralmente porque a issue não existe ou porque o token de API não consegue ler o repositório ou projeto dela. Nesse caso, peça ao seu administrador que verifique o token.

Desvincular uma issue

Clique no botão X ao lado do título de uma issue. Desvincular remove a referência do ticket e deixa a issue intacta no GitHub ou no GitLab. Outros tickets que vinculam a mesma issue mantêm a própria referência.