Verwalten von benutzerdefinierten Eigenschaften für Repositorys in Ihrer Organisation

Mit benutzerdefinierten Eigenschaften können Sie den Repositorys in Ihrem Unternehmen Metadaten hinzufügen. Sie können diese Eigenschaften verwenden, um Repositorys mit Regelsätzen zu adressieren.

Wer kann dieses Feature verwenden?

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.

In diesem Artikel

Informationen zu benutzerdefinierten Eigenschaften

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.

Eine Organisation über bis zu 100 Eigenschaftsdefinitionen besitzen. Eine Liste zulässiger Werte kann bis zu 200 Elemente enthalten.

Mit Hilfe von Repository-Eigenschaften können Sie bestimmen, welche Repositorys mit einem Regelsatz adressiert werden sollen. Weitere Informationen finden Sie unter Erstellen von Regelsätzen für Repositorys in deiner Organisation.

Du kannst benutzerdefinierte Eigenschaften auf Unternehmensebene definieren, um für alle Organisationen eine einheitliche Benutzeroberfläche zu erstellen. Weitere Informationen findest du unter Verwalten von benutzerdefinierten Eigenschaften für 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 ".

Hinzufügen von benutzerdefinierten Eigenschaften

Sie können Ihrer Organisation benutzerdefinierte Eigenschaften hinzufügen und Werte für diese Eigenschaften für Repositorys in Ihrer Organisation festlegen.

Sie können auch die REST-API verwenden, um eine Organisation zu erstellen und zu verwalten. Weitere Informationen findest du unter REST-API-Endpunkte für benutzerdefinierte Eigenschaften.

  1. Wählen Sie in der oberen rechten Ecke von GitHub Ihr Profilfoto aus, und klicken Sie dann auf Ihre Organisationen.
  2. Klicke neben der Organisation auf Einstellungen.
  3. Klicke im Abschnitt „Third-party Access“ der Seitenleiste auf OAuth app policy.
  4. Um eine neue benutzerdefinierte Eigenschaft hinzuzufügen, klicken Sie oben rechts auf Neue Eigenschaft.
  5. Geben Sie in das Feld „Name"“ den Namen ein, den Sie für Ihre benutzerdefinierte Eigenschaft verwenden möchten. Der Name darf keine Leerzeichen enthalten.
  6. Optional können Sie in das Feld „Beschreibung“ eine Beschreibung Ihrer benutzerdefinierten Eigenschaft eingeben.
  7. Wählen Sie unter „Typ“ den Typ der Eigenschaft aus, die Sie hinzufügen möchten. Dabei kann es sich entweder um eine Textzeichenfolge, ein Auswahlfeld für nur eine Option, ein Auswahlfeld für mehrere Optionen oder einen booleschen True/False-Wert handeln.
  8. Optional können Sie Festlegen dieser Eigenschaft durch Repository-Akteure zulassen auswählen. Wenn diese Option aktiviert ist, können Repositorybenutzer und Apps mit der abgestimmten Berechtigung „benutzerdefinierte Eigenschaften“ auf Repositoryebene den Eigenschaftswert für ihr Repository festlegen und aktualisieren.
  9. Optional können Sie die Option Diese Eigenschaft für alle Repositorys anfordern auswählen und einen Standardwert hinzufügen. Das bedeutet, dass alle Repositorys in Ihrer Organisation einen Wert für diese Eigenschaft haben müssen. Repositorys, die keinen expliziten Wert für diese Eigenschaft haben, erben den Standardwert.
  10. Klicken Sie auf Eigenschaft speichern.

Festlegen von Werten für Repositorys in Ihrer Organisation

Sie und alle Benutzer mit der Berechtigung „Bearbeiten von Werten für benutzerdefinierte Eigenschaften auf Organisationsebene“ können Werte für benutzerdefinierte Eigenschaften für Repositorys in Ihrer Organisation festlegen.

  1. Wählen Sie in der oberen rechten Ecke von GitHub Ihr Profilfoto aus, und klicken Sie dann auf Ihre Organisationen.

  2. Klicke neben der Organisation auf Einstellungen.

  3. Klicke im Abschnitt „Third-party Access“ der Seitenleiste auf OAuth app policy.

  4. Klicken Sie dazu auf die Registerkarte „Werte festlegen“.

  5. Wählen Sie ein oder mehrere Repositorys aus der Liste und klicken Sie auf Eigenschaften bearbeiten.

    Screenshot der Seite zum Festlegen von Werten für Repositorys. Eine Schaltfläche mit einem Stiftsymbol und der Beschriftung „Eigenschaften bearbeiten“ wird durch einen orangefarbenen Rahmen hervorgehoben.

  6. Wählen Sie in dem daraufhin angezeigten Dialogfeld einen Wert für jede Eigenschaft aus, die Sie für die ausgewählten Repositorys festlegen möchten.

  7. Klicke auf Änderungen speichern.

Anzeigen von Werten für Repositorys in Ihrer Organisation

Personen mit Leseberechtigung für ein Repository können die Werte der benutzerdefinierten Eigenschaften für dieses Repository anzeigen, aber nicht bearbeiten.

Sie können auch die REST-API verwenden, um die benutzerdefinierten Eigenschaften aufzulisten, die einem Repository von Ihrer Organisation zugewiesen wurden. Weitere Informationen findest du unter REST-API-Endpunkte für benutzerdefinierte Eigenschaften.

  1. Klicke im Abschnitt „Code and automation“ der Randleiste auf Custom properties.

Suchen und Filtern von Repositorys nach Werten benutzerdefinierter Eigenschaften

Sie können anhand von Werten benutzerdefinierter Eigenschaften nach Repositorys in Ihrer Organisation suchen.

  1. Wählen Sie in der oberen rechten Ecke von GitHub Ihr Profilfoto aus, und klicken Sie dann auf Ihre Organisationen.
  2. Klicke auf den Namen Deiner Organisation.
  3. Klicken Sie unter dem Namen Ihrer Organisation auf Repositorys.
  4. Geben Sie prop in die Suchleiste ein, um eine Liste aller benutzerdefinierten Eigenschaften in Ihrer Organisation anzuzeigen, und wählen Sie die Eigenschaft aus, nach der Sie suchen möchten.