Enterprise Server 3.20 ist derzeit als Release Candidate verfügbar.

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

Benutzerdefinierte Eigenschaften sind strukturierte Metadatenfelder, die Sie Repositorys und Organisationen in GitHub hinzufügen können, um eine bessere Organisation, Governance und Automatisierung in Ihrer gesamten Umgebung zu ermöglichen.

Dieser Artikel bezieht sich auf benutzerdefinierte Repositoryeigenschaften.

Die Sichtbarkeit benutzerdefinierter Eigenschaften entspricht der Sichtbarkeit des Repositorys. Benutzerdefinierte Eigenschaften für öffentliche Repositorys können von jedem angezeigt werden, während benutzerdefinierte Eigenschaften für interne oder private Repositorys von Konten mit read Berechtigungen für das Repository angezeigt werden können.

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.

  1. Klicke in der rechten oberen Ecke von GitHub auf dein Profilbild und dann auf Your organizations.

  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 und maximal 75 Zeichen lang sein.

  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. Dies kann entweder eine Textzeichenfolge, a single select field, a multi select field, oder Boolescher Wert (wahr/falsch) 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 zum Bearbeiten von Werten für benutzerdefinierte Eigenschaften auf Organisationsebene können Werte für benutzerdefinierte Eigenschaften für Repositorys in Ihrer Organisation festlegen.

  1. Klicke in der rechten oberen Ecke von GitHub auf dein Profilbild und dann auf Your organizations.

  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ähle ein oder mehrere Repositorys aus der Liste aus, und klicke auf Edit properties

    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. Dieser Wert darf maximal 75 Zeichen lang sein.

  7. Klicken Sie 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.

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. Klicke unter dem Repositorynamen auf Settings. 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. Klicke in der rechten oberen Ecke von GitHub auf dein Profilbild und dann auf Your organizations.
  2. Klicke auf den Namen Deiner Organisation.
  3. Klicke unter dem Namen deiner Organisation auf Repositories.
  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.