Skip to main content

Configurar enlaces automáticos para referenciar recursos externos

Puedes agregar enlaces automáticos a recursos externos, como propuestas de JIRA y tickets de Zendesk, para ayudar a optimizar tu flujo de trabajo.

Los autoenlaces se encuentran disponibles en los repositorios con GitHub Pro, GitHub Team, Nube de GitHub Enterprise, y GitHub Enterprise Server. Para obtener más información, consulta la sección "Productos de GitHub".

Cualquier usuario con permisos de administración en un repositorio puede configurar referencias de enlace automático para vincular propuestas, solicitudes de cambios, mensajes de confirmación y descripciones de lanzamientos con los servicios externos de terceros.

Las referencias de los autoenlaces ahora pueden aceptar caracteres alfanuméricos. Cuando se introdujeron originalmente, los autoenlaces personalizados se limitaron a los recursos externos que utilizaban identificadores numéricos. Los autoenlaces personalizados ahora funcionan con identificadores aklfanuméricos. Las referencias de autoenlace tradicionales que reconocen únicamente identificadores numéricos son obsoletas ahora y se muestran con la etiqueta "legacy".

Puedes definir los autoenlaces personalizados si especificas un prefijo de referencia y una URL destino.

  • Los prefijos de referencia no pueden tener nombres superpuestos. Por ejemplo, un repositorio no puede tener dos autoenlaces personalizados con prefijos tales como TICKET y TICK, ya que ambos prefijos coincidirían con la secuencia TICKET123a.
  • Las URL destino incluyen una variable <num> que es compatible con los siguientes caracteres: a-z (con distinción de mayúsculas y minúsculas), 0-9 y -.

Este procedimiento demuestra cómo configurar los autoenlaces para referenciar recursos externos. Por ejemplo, si utilizas Zendesk para rastrear los tickets que reportan los usuarios, puedes referenciar un número de ticket en la solicitud de cambios que abriste para corregir la propuesta.

  1. En GitHub.com, visita la página principal del repositorio.

  2. Debajo de tu nombre de repositorio, da clic en Configuración. Botón de configuración del repositorio

  3. En la sección de "integraciones" de la barra lateral, haz clic en Referencias de autoenlace.

  4. Haz clic en Add autolink reference (Agregar referencia de enlace automático). Botón para completar con información de la referencia de enlace automático

  5. Debajo de "Reference prefix" (Prefijo de referencia), escribe un prefijo corto y significativo que quieras que los colaboradores utilicen para generar enlaces automáticos para el recurso externo. Field to type abbreviation for external system

  6. Debajo de "Target URL" (URL de destino), escribe el enlace al sistema externo al que te quieras vinculr. Asegúrate de conservar <num> como variable para el número de referencia. Field to type URL to external system

  7. Haz clic en Add autolink reference (Agregar referencia de enlace automático).