Skip to main content

Verwalten von benutzerdefinierten Eigenschaften für Repositorys in deinem Unternehmen

Erstelle benutzerdefinierte Eigenschaften, um Organisationen eine konsistente Möglichkeit zum Kategorisieren von Repositorys zu bieten.

Wer kann dieses Feature verwenden?

Enterprise owners

Note

Benutzerdefinierte Eigenschaften für dein Unternehmen befinden sich in der public preview. Änderungen sind vorbehalten.

Mithilfe benutzerdefinierter Eigenschaften können Sie Ihre Repositorys mit Informationen wie Compliance-Rahmenbedingungen, Datensensitivität oder Projektdetails ausstatten. Benutzerdefinierte Eigenschaften sind privat und können nur von Personen mit Leseberechtigung für das Repository eingesehen werden. Ein Unternehmen kann über bis zu 100 Eigenschaftsdefinitionen verfügen. Eine Liste zulässiger Werte kann bis zu 200 Elemente enthalten.

Wenn du benutzerdefinierte Eigenschaften auf Unternehmensebene definierst, kannst du konsistente Werte erstellen, die Benutzer auf Repositorys anwenden können. Mit benutzerdefinierten Eigenschaften kannst du eine konsistente Governance auf die Repositorys in deinem Unternehmen anwenden, indem du einen Regelsatz oder Repositoryrichtlinien für Repositorys mit bestimmten Eigenschaften erstellst. Weitere Informationen findest du unter Verwalten der Verwendung von Repositorys in deinem Unternehmen.

Zulässige Zeichen

Die Namen und Werte benutzerdefinierter Eigenschaften dürfen nur bestimmte Zeichen enthalten:

  • Namen: a-z, A-Z, 0-9, _, -, $, #.
  • Werte: Alle druckbaren ASCII-Zeichen außer ".

Wer kann Werte für benutzerdefinierte Eigenschaften festlegen und anzeigen, die ich definiert habe?

Nachdem du eine benutzerdefinierte Eigenschaft definiert hast, können Benutzer einen Wert für diese Eigenschaft in Repositorys im Unternehmen festlegen. Weitere Informationen findest du unter Verwalten von benutzerdefinierten Eigenschaften für Repositorys in Ihrer Organisation.

  • Als Unternehmensbesitzer kannst du einen Standardwert für erforderliche Eigenschaften festlegen.
  • Organisationsbesitzer können in ihrer Organisation Werte entweder für Repositorys oder auf Repositoryebene festlegen.
  • Wenn diese Option aktiviert ist, können Personen mit Repositoryzugriff oder der differenzierten Berechtigung custom properties den Eigenschaftswert für ihr Repository festlegen und aktualisieren.

Personen mit Leseberechtigungen für ein Repository können die benutzerdefinierten Eigenschaftswerte für dieses Repository anzeigen.

Darüber hinaus können Organisationsbesitzer mit benutzerdefinierten Eigenschaftswerten nach Repositorys in ihrer Organisation suchen. Weitere Informationen findest du unter Verwalten von benutzerdefinierten Eigenschaften für Repositorys in Ihrer Organisation.

Hinzufügen von benutzerdefinierten Eigenschaften

Du kannst deinem Unternehmen benutzerdefinierte Eigenschaften hinzufügen, um diese Eigenschaften in allen deinen Organisationen verfügbar zu machen.

  1. Klicke auf GitHub in der oberen rechten Ecke auf dein Profilfoto.
  2. Klicke je nach deiner Umgebung auf Dein Unternehmenoder auf Deine Unternehmen, und klicke dann auf das Unternehmen, das du anzeigen möchtest.
  3. Klicke in der linken Randleiste unter „Policies“ auf Custom properties.
  4. Um eine neue benutzerdefinierte Eigenschaft hinzuzufügen, klicke in der oberen rechten Ecke auf New property.
  5. Gib einen Namen, eine Beschreibung und einen Typ für die benutzerdefinierte Eigenschaft ein. Der Name muss in allen deinen Organisationen eindeutig sein und darf keine Leerzeichen enthalten.
  6. Optional kannst du Allow repository actors to set this property auswählen. Wenn diese Option aktiviert ist, können Repositorybenutzer und Apps mit der differenzierten Berechtigung custom properties auf Repositoryebene den Eigenschaftswert für ihr Repository festlegen und aktualisieren. Darüber hinaus kann jeder Akteur, der ein Repository erstellt, die Eigenschaft für das Repository festlegen.
  7. Optional kannst du Require this property for all repositories auswählen und einen Standardwert hinzufügen. Dies bedeutet, dass alle Repositorys in deinem Unternehmen einen Wert für diese Eigenschaft aufweisen müssen. Repositorys, die keinen expliziten Wert für diese Eigenschaft haben, erben den Standardwert.
  8. Klicken Sie auf Eigenschaft speichern.