Gestión de propiedades personalizadas para organizaciones

Con las propiedades personalizadas, puede agregar metadatos a las organizaciones de su empresa y usar esos metadatos para dirigirse a repositorios con conjuntos de reglas.

¿Quién puede utilizar esta característica?

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.

En este artículo

Nota:

Para GitHub Enterprise Server, esta característica solo estará disponible desde la versión 3.21.

Acerca de las propiedades personalizadas

Las propiedades personalizadas son campos de metadatos estructurados que puede agregar a repositorios y organizaciones en GitHub para permitir una mejor organización, gobernanza y automatización en todo el entorno. Consulte Propiedades personalizadas.

En este artículo se relaciona con las propiedades personalizadas de la organización.

Caracteres permitidos

Los nombres y valores de propiedades personalizados solo pueden contener determinados caracteres:

  • Nombres: a-z, A-Z, 0-9, _, -, , , $``#
  • Valores: todos los caracteres ASCII imprimibles excepto "

Adición de propiedades personalizadas

Puede agregar propiedades personalizadas a su empresa y establecer valores para esas propiedades para las organizaciones de su empresa.

También puedes usar la API de REST para crear y administrar organizaciones. Consulta Propiedades personalizadas.

  1. Vaya a su empresa. Por ejemplo, desde la página Empresas en GitHub.com.

  2. En el nombre de la empresa, haz clic en la pestaña Organizations.

    Captura de pantalla de una empresa. La pestaña "Organizaciones" aparece resaltada con un contorno naranja.

  3. En la barra lateral izquierda, haga clic en Propiedades personalizadas.

  4. Para agregar una nueva propiedad personalizada, haz clic en Nueva propiedad en la esquina superior derecha.

  5. En el campo «Nombre», escribe el nombre que quieras usar para la propiedad personalizada. El nombre no puede contener espacios y no puede superar los 75 caracteres de longitud.

  6. Opcionalmente, en el campo "Descripción", agregue una descripción para la propiedad personalizada.

  7. En «Tipo», selecciona el tipo de propiedad que deseas añadir.

  8. Opcionalmente, seleccione Permitir que los actores de la organización establezcan esta propiedad para permitir que los usuarios y las aplicaciones de la organización con el permiso de nivel de organización de "propiedades personalizadas" establezcan y actualicen el valor de la propiedad para su organización.

  9. Opcionalmente, seleccione Requerir esta propiedad para todas las organizaciones y agregue un valor predeterminado. Al habilitar esta opción, se indica que necesita que todas las organizaciones de la empresa tengan un valor para esta propiedad. Las organizaciones que no tienen un valor explícito para esta propiedad heredarán el valor predeterminado.

  10. Haz clic en Guardar propiedad.

Establecimiento de valores para organizaciones de su empresa

Usted y cualquier usuario con el permiso "Editar valores de propiedades personalizados en el nivel de organización", puede establecer valores para las propiedades personalizadas para las organizaciones de su empresa.

  1. Vaya a su empresa. Por ejemplo, desde la página Empresas en GitHub.com.

  2. En el nombre de la empresa, haz clic en la pestaña Organizations.

    Captura de pantalla de una empresa. La pestaña "Organizaciones" aparece resaltada con un contorno naranja.

  3. En la barra lateral izquierda, haga clic en Propiedades personalizadas.

  4. Haz clic en la pestaña «Establecer valores».

  5. Seleccione una o varias organizaciones de la lista y haga clic en Editar propiedades.

  6. En el cuadro de diálogo modal que aparece, seleccione un valor para cada propiedad que quiera establecer para las organizaciones seleccionadas.

  7. Haga clic en Guardar cambios.