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.

¿Quién puede utilizar esta característica?

Los enlaces automáticos están disponibles en los repositorios con GitHub Pro, GitHub Team, GitHub Enterprise Cloud y GitHub Enterprise Server.

En este artículo

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 vínculo automático ahora pueden aceptar caracteres alfanuméricos. Cuando se introdujeron originalmente, los vínculos automáticos personalizados se limitaban a los recursos externos que usaban identificadores numéricos. Actualmente, los vínculos automáticos personalizados funcionan con identificadores numéricos y alfanuméricos.

Para definir vínculos automáticos personalizados, especifica un prefijo de referencia y una dirección URL de destino.

  • Los prefijos de referencia no pueden tener nombres superpuestos. Por ejemplo, un repositorio no puede tener dos vínculos automáticos personalizados con prefijos como TICKET y TICK, ya que ambos prefijos coincidirían con la cadena TICKET123a.
  • Las direcciones URL de destino incluyen una variable <num> que representa el identificador de referencia del recurso vinculado.

En este procedimiento se muestra cómo configurar vínculos automáticos para hacer referencia a recursos externos. Por ejemplo, si usas Zendesk para hacer el seguimiento de incidencias notificadas por el usuario, puedes hacer referencia a un número de incidencia en la solicitud de incorporación de cambios que abriste para corregir el problema.

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. En el nombre del repositorio, haz clic en Configuración. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

    Captura de pantalla de un encabezado de repositorio en el que se muestran las pestañas. La pestaña "Configuración" está resaltada con un contorno naranja oscuro.

  3. En la sección "Integraciones" de la barra lateral, haga clic en Referencias de enlace automático.

  4. En la parte superior derecha de la página, haga clic en Agregar referencia de vínculo automático.

    Captura de pantalla de la página "Referencias de vínculo automático". El botón "Agregar referencia de vínculo automático" está resaltado por un contorno naranja oscuro.

  5. Selecciona el formato del identificador de referencia que se usa en el recurso externo, ya sea numérico o alfanumérico.

  6. En "Prefijo de referencia", escriba un prefijo corto y significativo. Los colaboradores usarán este texto para generar vínculos automáticos para el recurso externo.

  7. En "URL de destino", escriba el formato del enlace al sistema externo que desea crear. Usa la variable <num> como marcador de posición para el identificador de referencia.

  8. Revise la vista previa y compruebe que el vínculo automático y la referencia externa son correctos y, a continuación, haga clic en Agregar referencia de vínculo automático para definir el vínculo.

Por ejemplo, puede introducir lo siguiente.

  • Prefijo de referencia: JIRA-
  • URL de destino: https://jira.example.com/issue?query=<num>
  • Versión preliminar: JIRA-123 se convierte en https://jira.example.com/issue?query=123