Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

Configuration de liens automatiques pour référencer des ressources externes

Vous pouvez ajouter des liens automatiques à des ressources externes comme des problèmes JIRA et des tickets Zendesk pour simplifier votre workflow.

Les liens automatiques sont disponibles dans les référentiels avec GitHub Pro, GitHub Team, GitHub Enterprise Cloud, et GitHub Enterprise Server. Pour plus d’informations, consultez « Produits de GitHub ».

Toute personne disposant d’autorisations d’administrateur pour un dépôt peut configurer des références de lien automatique pour lier des problèmes, des demandes de tirage, des messages de commit et des descriptions de mise en production à des services tiers externes.

Les références de lien automatique acceptent désormais les caractères alphanumériques. Quand ils ont été introduits initialement, les liens automatiques personnalisés étaient limités aux ressources externes utilisant des identificateurs numériques. Les liens automatiques personnalisés fonctionnent désormais avec des identificateurs alphanumériques. Les références de lien automatique héritées qui acceptent uniquement les identificateurs numériques sont déconseillées. Elles portent une étiquette « héritée ».

Vous définissez les liens automatiques personnalisés en spécifiant un préfixe de référence et une URL cible.

  • Les préfixes de référence ne peuvent pas présenter des noms qui se chevauchent. Un référentiel ne peut par exemple pas avoir deux liens automatiques personnalisés avec des préfixes comme TICKET et TICK, étant donné que les deux préfixes correspondent à la chaîne TICKET123a.
  • Les URL cibles incluent une variable <num> qui prend en charge les caractères suivants : a-z (qui ne respecte pas la casse), 0-9 et -.

Cette procédure montre comment configurer les liens automatiques pour référencer des ressources externes. Si vous utilisez Zendesk par exemple pour suivre les tickets signalés par l’utilisateur, vous pouvez référencer un numéro de ticket dans la demande de tirage (pull request) que vous avez ouverte pour résoudre le problème.

  1. Dans GitHub.com, accédez à la page principale du dépôt. 1. Sous le nom de votre dépôt, cliquez sur Paramètres. Bouton Paramètres du dépôt

  2. Dans la section « Intégrations » de la barre latérale, cliquez sur Références de lien automatique.

  3. Cliquez sur Ajouter une référence de lien automatique. Bouton pour renseigner les informations de référence de lien automatique

  4. Sous « Préfixe de référence », tapez un préfixe court et explicite que vous souhaitez que les collaborateurs utilisent afin de générer des liens automatiques pour la ressource externe. Champ où taper l’abréviation pour le système externe

  5. Sous « URL cible », tapez le lien vers le système externe auquel vous souhaitez établir un lien. Veillez à conserver <num> en tant que variable pour le numéro de référence. Champ où taper l’abréviation pour le système externe

  6. Cliquez sur Ajouter une référence de lien automatique.