Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.

Configurar links automáticos para fazer referência a recursos externos

Você pode adicionar links automáticos para recursos externos como problemas do JIRA e tíquetes do Zendesk a fim de ajudar a otimizar o fluxo de trabalho.

Os links automáticos estão disponíveis em repositórios com o GitHub Pro, o GitHub Team, o GitHub Enterprise Cloud, e o GitHub Enterprise Server. Para obter mais informações, confira "produtos de GitHub".

Qualquer pessoa com permissões de administrador para um repositório pode configurar referências de autolink para vincular problemas, pull requests, mensagens do commit e descrições de versões para serviços externos de terceiros.

As referências de link automático agora podem aceitar caracteres alfanuméricos. Logo que foram introduzidos, os links automáticos personalizados eram limitados a recursos externos que usavam identificadores numéricos. Os links automáticos personalizados agora funcionam com identificadores alfanuméricos e numéricos.

Você define os links automáticos personalizados especificando um prefixo de referência e uma URL de destino.

  • Os prefixos de referência não podem ter nomes que se sobreponham. Por exemplo, um repositório não pode ter dois links automáticos personalizados com prefixos como TICKET e TICK, pois os dois prefixos corresponderiam à cadeia de caracteres TICKET123a.
  • As URLs de destino incluem uma variável <num> que representa o identificador de referência do recurso vinculado.

Este procedimento demonstra como configurar links automáticos para referenciar recursos externos. Por exemplo, ao usar o Zendesk para acompanhar tíquetes relatados por usuários, você pode referenciar um número de tíquete na solicitação de pull que foi aberta para corrigir o problema.

  1. No GitHub.com, navegue até a página principal do repositório. 1. Abaixo do nome do repositório, clique em Configurações. Botão Configurações do repositório

  2. Na seção "Integrações" na barra lateral, clique em Referências de link automático.

  3. Clique em Adicionar referência de link automático. Botão usado para preencher as informações de referência do link automático.

  4. Selecione o formato do identificador de referência usado no recurso externo, seja ele alfanumérico ou numérico. Configuração de formato do link automático, seja ele alfanumérico ou numérico.

  5. Em "Reference prefix" (Prefixo da referência), digite um prefixo curto e significativo que os colaboradores devem usar para gerar links automáticos para os recursos externos. Campo para digitar a abreviação do sistema externo.

  6. Em "Target URL" (URL de destino), digite o link para o sistema externo com o qual deseja criar vínculo. Use a variável <num> como um espaço reservado para o identificador de referência. Campo para digitar a URL do sistema externo.

  7. Clique em Adicionar referência de link automático.