Gestion des propriétés personnalisées pour les organisations

Avec des propriétés personnalisées, vous pouvez ajouter des métadonnées aux organisations de votre entreprise et utiliser ces métadonnées pour cibler des référentiels avec des ensembles de règles.

Qui peut utiliser cette fonctionnalité ?

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

Dans cet article

Remarque

Pour GitHub Enterprise Server, cette fonctionnalité sera disponible uniquement à partir de la version 3.21.

À 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. Voir Propriétés personnalisées.

Cet article concerne les propriétés personnalisées de l’organisation.

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 entreprise et définir des valeurs pour ces propriétés pour les organisations de votre entreprise.

Vous pouvez également utiliser l’API REST afin de créer et gérer des propriétés personnalisées pour une organisation. Consultez Propriétés personnalisées.

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

  2. Sous le nom de l’entreprise, cliquez sur l’onglet Organisations.

    Capture d’écran d’une entreprise. L’onglet « Organisations » est mis en surbrillance avec un encadré orange.

  3. Dans la barre latérale gauche, cliquez sur Propriétés personnalisées.

  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. Si vous le souhaitez, dans le champ « Description », ajoutez une description pour la propriété personnalisée.

  7. Sous « Type », sélectionnez le type de propriété que vous souhaitez ajouter.

  8. Si vous le souhaitez, sélectionnez Autoriser les acteurs de l’organisation à définir cette propriété pour permettre aux utilisateurs et applications de l’organisation avec l’autorisation « propriétés personnalisées » de niveau organisation de définir et de mettre à jour la valeur de propriété pour leur organisation.

  9. Optionnellement, sélectionnez Exiger cette propriété pour toutes les organisations et ajoutez une valeur par défaut. L’activation de cette option indique que toutes les organisations de votre entreprise ont une valeur pour cette propriété. Les organisations qui n’ont pas de valeur explicite pour cette propriété hériteront de la valeur par défaut.

  10. Cliquez sur Enregistrer la propriété.

Définition de valeurs pour les organisations de votre entreprise

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

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

  2. Sous le nom de l’entreprise, cliquez sur l’onglet Organisations.

    Capture d’écran d’une entreprise. L’onglet « Organisations » est mis en surbrillance avec un encadré orange.

  3. Dans la barre latérale gauche, cliquez sur Propriétés personnalisées.

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

  5. Sélectionnez une ou plusieurs organisations dans la liste, puis cliquez sur Modifier les propriétés.

  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 organisations sélectionnées.

  7. Cliquez sur Save changes.