À propos des liens automatiques
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
etTICK
, étant donné que les deux préfixes correspondent à la chaîneTICKET123a
. - 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-
.
Configuration de liens automatiques pour référencer des ressources externes
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.
-
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.
-
Dans la section « Intégrations » de la barre latérale, cliquez sur Références de lien automatique.
-
Cliquez sur Ajouter une référence de lien automatique.
-
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.
-
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. -
Cliquez sur Ajouter une référence de lien automatique.