Gerenciando propriedades personalizadas para organizações

Com propriedades personalizadas, você pode adicionar metadados às organizações em sua empresa e usar esses metadados para direcionar repositórios com conjuntos de regras.

Quem pode usar esse recurso?

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.

Neste artigo

Observação

Para GitHub Enterprise Server, esse recurso estará só disponível na versão 3.21.

Sobre propriedades personalizadas

As propriedades personalizadas são campos de metadados estruturados que você pode adicionar a repositórios e organizações em GitHub para habilitar uma melhor organização, governança e automação em seu ambiente. Consulte Propriedades personalizadas.

Este artigo refere-se a propriedades personalizadas da organização.

Caracteres permitidos

Nomes e valores de propriedades personalizadas apenas podem conter determinados caracteres:

  • Nomes: a-z, A-Z, 0-9, _, -, $, #
  • Valores: todos os caracteres ASCII imprimíveis, exceto "

adicionar propriedades personalizadas

Você pode adicionar propriedades personalizadas à sua empresa e definir valores para essas propriedades para organizações em sua empresa.

Você também pode usar a API REST para criar e gerenciar propriedades personalizadas para uma organização. Confira Propriedades personalizadas.

  1. Navegue até sua empresa. Por exemplo, na página Enterprises em GitHub.com.

  2. No nome da empresa, clique na guia Organizations.

    Captura de tela de uma empresa. A guia "Organizations" está realçada com um contorno laranja.

  3. Na barra lateral esquerda, clique em Propriedades personalizadas.

  4. Para adicionar uma nova propriedade personalizada, clique em Nova propriedade no canto superior direito.

  5. No campo "Nome", digite o nome que gostaria de usar para sua propriedade personalizada. O nome não pode conter espaços nem pode exceder 75 caracteres de comprimento.

  6. Opcionalmente, no campo "Descrição", adicione uma descrição para a propriedade personalizada.

  7. Em "Tipo", selecione o tipo de propriedade que você deseja adicionar.

  8. Opcionalmente, selecione Permitir que os atores da organização definam essa propriedade para permitir que usuários e aplicativos da organização, com permissão específica de "propriedades personalizadas" no nível da organização, definam e atualizem o valor da propriedade para sua organização.

  9. Opcionalmente, selecione Exigir essa propriedade para todas as organizações e adicione um valor padrão. Habilitar essa opção indica que você precisa que todas as organizações em sua empresa tenham um valor para essa propriedade. As organizações que não têm um valor explícito para essa propriedade herdarão o valor padrão.

  10. Clique em Salvar propriedade.

Definindo valores para organizações em sua empresa

Você e todos os usuários com a permissão "Editar valores de propriedades personalizadas no nível da organização" podem definir valores para propriedades personalizadas para organizações em sua empresa.

  1. Navegue até sua empresa. Por exemplo, na página Enterprises em GitHub.com.

  2. No nome da empresa, clique na guia Organizations.

    Captura de tela de uma empresa. A guia "Organizations" está realçada com um contorno laranja.

  3. Na barra lateral esquerda, clique em Propriedades personalizadas.

  4. Clique na guia "Definir valores".

  5. Selecione uma ou mais organizações da lista e clique em Editar propriedades.

  6. Na caixa de diálogo modal exibida, selecione um valor para cada propriedade que você deseja definir para as organizações selecionadas.

  7. Selecione Salvar alterações.