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.

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

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 finden Sie 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. Klicken Sie im Abschnitt „Zugriff durch Dritte“ auf der Randleiste auf -OAuth-Anwendungsrichtlinie.
  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. Das kann entweder eine Textzeichenfolge, ein einzelnes Auswahlfeld, ein Mehrfachauswahlfeld oder ein boolescher Wert (true/false) sein.
  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. Klicken Sie im Abschnitt „Zugriff durch Dritte“ auf der Randleiste auf -OAuth-Anwendungsrichtlinie.

  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 finden Sie unter REST-API-Endpunkte für benutzerdefinierte Eigenschaften.

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. Wähle unter dem Namen deines Repositorys die Option Einstellungen aus. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

    Screenshot eines Repositoryheaders mit den Registerkarten. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet.

  3. 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.