Gestion des propriétés personnalisées pour les référentiels de votre organisation

Grâce aux propriétés personnalisées, vous pouvez ajouter des métadonnées aux référentiels de votre organisation. Vous pouvez utiliser ces propriétés pour cibler des référentiels avec des ensembles de règles.

Qui peut utiliser cette fonctionnalité ?

Organization owners and users with the "Manage the organization's custom properties definitions" permission can add and set a custom property schema at the organization level.

Dans cet article

À propos des propriétés personnalisées

Les propriétés personnalisées sont des champs de métadonnées structurées que vous pouvez ajouter aux référentiels et aux organisations dans GitHub afin d’améliorer l’organisation, la gouvernance et l’automatisation dans votre environnement.

Cet article concerne les propriétés personnalisées du référentiel.

La visibilité des propriétés personnalisées correspond à la visibilité du référentiel. Les propriétés personnalisées sur les référentiels publics peuvent être consultées par n’importe qui, tandis que les propriétés personnalisées sur des référentiels internes ou privés peuvent être consultées par des comptes disposant read d’autorisations sur le référentiel.

Caractères autorisés

Les noms et valeurs de propriétés personnalisés ne peuvent contenir que certains caractères :

  • Noms : a-z, , A-Z``0-9, _, -, $``#
  • Valeurs : tous les caractères ASCII imprimables à l’exception de "

Ajout de propriétés personnalisées

Vous pouvez ajouter des propriétés personnalisées à votre organisation et définir des valeurs pour ces propriétés pour les référentiels de votre organisation.

  1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

  2. En regard de l’organisation, cliquez sur Paramètres.

  3. Dans la barre latérale gauche, dans la section « Code, planification et automatisation », cliquez sur Repository, puis cliquez sur Propriétés personnalisées.

    Capture d’écran de la page des paramètres d’une organisation. Dans la barre latérale, un lien intitulé « Propriétés personnalisées » est surligné en orange.

  4. Pour ajouter une nouvelle propriété personnalisée, cliquez sur Nouvelle propriété dans le coin supérieur droit.

  5. Dans le champ « Nom », tapez le nom que vous souhaitez utiliser pour votre propriété personnalisée. Le nom ne peut pas contenir d’espaces et ne peut pas dépasser 75 caractères.

  6. Dans le champ « Description », vous pouvez renseigner une description facultative de votre propriété personnalisée.

  7. Sous « Type », sélectionnez le type de propriété que vous souhaitez ajouter. Il peut s’agir d’une chaîne de texte, un champ de sélection unique, un champ à sélection multiple, ou un booléen true/false.

  8. Si vous le souhaitez, sélectionnez Autoriser les acteurs du référentiel à définir cette propriété. Lorsque cette option est activée, les utilisateurs du référentiel et les applications disposant de l’autorisation granulaire « propriétés personnalisées »custom properties au niveau du référentiel pourront définir et mettre à jour la valeur de la propriété pour leur référentiel.

  9. Si vous le souhaitez, sélectionnez Exiger cette propriété pour tous les référentiels et ajoutez une valeur par défaut. Cela signifie que vous exigez que tous les référentiels de votre organisation aient une valeur pour cette propriété. Les référentiels qui ne disposent pas d’une valeur explicite pour cette propriété hériteront de la valeur par défaut.

  10. Cliquez sur Enregistrer la propriété.

Définition des valeurs des référentiels dans votre organisation

Vous, et tous les utilisateurs disposant de l’autorisation « Modifier les valeurs de propriétés personnalisées au niveau de l’organisation », pouvez définir des valeurs pour les propriétés personnalisées pour les référentiels de votre organisation.

  1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

  2. En regard de l’organisation, cliquez sur Paramètres.

  3. Dans la barre latérale gauche, dans la section « Code, planification et automatisation », cliquez sur Repository, puis cliquez sur Propriétés personnalisées.

    Capture d’écran de la page des paramètres d’une organisation. Dans la barre latérale, un lien intitulé « Propriétés personnalisées » est surligné en orange.

  4. Cliquez sur l’onglet « Définir des valeurs ».

  5. Sélectionnez un ou plusieurs référentiels dans la liste, puis cliquez sur Modifier les propriétés.

    Capture d’écran de la page de définition de valeurs pour les référentiels. Un bouton, étiqueté avec une icône de crayon et « Modifier les propriétés », est mis en évidence par un contour orange.

  6. Dans la boîte de dialogue modale qui s’affiche, sélectionnez une valeur pour chaque propriété que vous souhaitez définir pour les référentiels sélectionnés. Cette valeur ne peut pas dépasser 75 caractères de longueur.

  7. Cliquez sur Save changes.

Affichage des valeurs des référentiels dans votre organisation

Les utilisateurs avec des autorisations d’accès en lecture pour un référentiel peuvent voir les valeurs des propriétés personnalisées pour ce référentiel, mais elles ne peuvent pas modifier ces valeurs.

  1. Sur GitHub, accédez à la page principale du référentiel.

  2. Sous le nom de votre référentiel, cliquez sur Paramètres. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

    Capture d’écran d’un en-tête de dépôt montrant les onglets. L’onglet « Paramètres » est mis en évidence avec un encadré orange foncé.

  3. Dans la section « Code et automatisation » de la barre latérale, cliquez sur Propriétés personnalisées.

Recherche et filtrage de référentiels par valeurs de propriétés personnalisées

Vous pouvez rechercher des référentiels dans votre organisation par valeurs de propriétés personnalisées.

  1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.
  2. Cliquez sur le nom de votre organisation.
  3. Sous le nom de votre organisation, cliquez sur référentiels.
  4. Dans la barre de recherche, tapez prop pour afficher la liste de toutes les propriétés personnalisées de votre organisation, puis sélectionnez la propriété à utiliser pour effectuer la recherche.