À 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 et numériques.
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 représente l’identificateur de référence de la ressource liée.
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.
-
Sur GitHub, accédez à la page principale du référentiel.
-
Sous le nom de votre dépôt, cliquez sur Paramètres. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.
-
Dans la section « Intégrations » de la barre latérale, cliquez sur Références de lien automatique.
-
En haut à droite de la page, cliquez sur Ajouter une référence de lien automatique.
-
Sélectionnez le format de l’identificateur de référence utilisé dans la ressource externe, alphanumérique ou numérique.
-
Sous « Préfixe de référence », tapez un préfixe court et explicite. Les collaborateurs utilisent ce texte pour générer des liens automatiques pour la ressource externe.
-
Sous « URL cible », tapez le format du lien vers le système externe que vous souhaitez créer. Utilisez la variable
<num>
comme espace réservé pour l’identificateur de référence. -
Examinez l’aperçu et vérifiez que le lien automatique et la référence externe sont corrects, puis cliquez sur Ajouter une référence de lien automatique pour définir le lien.
Par exemple, vous pourriez entrer ce qui suit.
- Préfixe de référence :
JIRA-
- URL cible :
https://jira.example.com/issue?query=<num>
- Aperçu :
JIRA-123
est converti enhttps://jira.example.com/issue?query=123