Création de propriétés personnalisées pour les référentiels dans votre entreprise

Les propriétés personnalisées vous permettent d'enrichir vos référentiels avec des informations telles que les frameworks de conformité, la sensibilité des données ou des détails de projet. Les propriétés personnalisées sont privées et ne peuvent être consultées que par les personnes disposant d'autorisations de lecture sur le référentiel. Une entreprise peut avoir jusqu'à 100 définitions de propriétés. Une liste de valeurs autorisées peut contenir jusqu'à 200 éléments.

Définir des propriétés personnalisées au niveau de l'entreprise vous permet de créer des valeurs cohérentes que les utilisateurs peuvent appliquer aux référentiels. Une fois les propriétés personnalisées en place, vous pouvez appliquer une gouvernance cohérente à l'ensemble des référentiels de votre entreprise en créant un ensemble de règles ou une stratégie de référentiel ciblant les référentiels avec certaines propriétés.

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 "

Qui peut définir et afficher des valeurs pour les propriétés personnalisées que je définis ?

Après avoir défini une propriété personnalisée, les utilisateurs peuvent définir une valeur pour cette propriété dans les référentiels de l'entreprise. Consultez Gestion des propriétés personnalisées pour les référentiels de votre organisation.

• En tant que propriétaire d'entreprise, vous pouvez définir une valeur par défaut pour les propriétés requises.
• Les propriétaires d'organisation peuvent définir des valeurs dans leur organisation, soit pour l'ensemble des référentiels, soit au niveau du référentiel.
• Si cette option est activée, les personnes ayant accès au référentiel, ou disposant de l'autorisation custom properties granulaire, peuvent définir et mettre à jour la valeur de la propriété pour leur référentiel.

Les personnes disposant d'autorisations de lecture sur un référentiel peuvent afficher les valeurs de propriétés personnalisées de ce référentiel.

En outre, les propriétaires d'organisation peuvent rechercher des référentiels dans leur organisation par valeurs de propriétés personnalisées. Consultez Gestion des propriétés personnalisées pour les référentiels de votre organisation.

Ajout de propriétés personnalisées

Vous pouvez ajouter des propriétés personnalisées à votre entreprise pour rendre ces propriétés disponibles dans toutes vos organisations.

1. Accédez à votre entreprise. Par exemple, depuis la page Entreprises sur GitHub.com.

2. Dans la barre latérale gauche, dans « Stratégies », cliquez sur Propriétés personnalisées.

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

4. Entrez un nom, une description et un type pour la propriété personnalisée. Le nom doit être unique dans toutes vos organisations, ne peut pas contenir d’espaces et ne peut pas dépasser 75 caractères de longueur.

5. 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 custom properties granulaire au niveau du référentiel pourront définir et mettre à jour la valeur de la propriété pour leur référentiel. En outre, tout acteur qui crée un référentiel peut définir la propriété sur le référentiel.

6. 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 entreprise 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.

   • Si vous le souhaitez, vous pouvez sélectionner Exiger des valeurs spécifiées par l’utilisateur explicites. Lorsque cette option est activée, les utilisateurs et les applications autorisés à définir des valeurs de propriété doivent fournir une valeur explicite lors de la définition des propriétés, de la création de référentiels ou du transfert de référentiels. Les dépôts qui n’ont pas encore de valeur explicite hériteront toujours de la valeur par défaut.

7. Cliquez sur Enregistrer la propriété.

Étapes suivantes

Appliquez des stratégies aux référentiels en fonction de leurs propriétés personnalisées. Consultez Définition de stratégies pour les référentiels dans votre entreprise.