Управление настраиваемыми свойствами для репозиториев в организации

Сведения о настраиваемых свойствах

          Настраиваемые свойства — это структурированные поля метаданных, которые можно добавить в репозитории и организации в GitHub, чтобы улучшить организацию, управление и автоматизацию в вашей среде.
           См. [AUTOTITLE](/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/custom-properties).

Эта статья относится к пользовательским свойствам репозитория.

          **Видимость** пользовательских свойств соответствует видимости репозитория. Настраиваемые свойства в общедоступных репозиториях могут просматривать все, в то время как настраиваемые свойства во внутренних или частных репозиториях могут просматривать учетные записи с `read` разрешениями на доступ к репозиторию.

Допустимые символы

Имена и значения настраиваемых свойств могут содержать только определенные символы:

• Имена: a-z, A-Z, 0-9, _``-``$``#
• Значения: Все печатные символы ASCII, за исключением "

Добавление пользовательских свойств

Вы можете добавить настраиваемые свойства в организацию и задать значения для этих свойств для репозиториев в организации.

          Вы также можете использовать REST API для создания и управления пользовательскими свойствами организации. Для получения дополнительной информации см. [AUTOTITLE](/rest/orgs/custom-properties).

1. В правом верхнем углу GitHub, щелкните рисунок профиля, а затем выберите октикона "организация" aria-hidden="true" aria-label="organization" %} Ваши организации.

2. Выберите организацию, кликнув по ней.

3. Под именем организации щелкните Settings. Если вкладка "Параметры" не отображается, выберите раскрывающееся меню и нажмите кнопку "Параметры".

   

4. В левой боковой панели в разделе "Код, планирование и автоматизация" щелкните Репозиторий, а затем выберите "Настраиваемые свойства".

   

5. Чтобы добавить новое настраиваемое свойство, щелкните "Создать свойство " в правом верхнем углу.

6. В поле "Имя" введите имя, которое вы хотите использовать для пользовательского свойства. Имя не может содержать пробелы и не может превышать 75 символов в длину.

7. При необходимости в поле "Описание" введите описание пользовательского свойства.

8. В разделе "Тип" выберите тип свойства, которое вы хотите добавить. Это может быть текстовая строка, одиночное поле select, поле с множественным выбором, или true/false булевое значение.

9. При необходимости можно выбрать субъекты репозитория, чтобы задать это свойство. Если этот параметр включен, пользователи репозитория и приложения с подробным разрешением уровня репозитория "пользовательские свойства" смогут задать и обновить значение свойства для своего репозитория.

10. При необходимости можно выбрать "Требовать это свойство" для всех репозиториев и добавить значение по умолчанию. Это означает, что требуется, чтобы все репозитории в организации имели значение для этого свойства. Репозитории, не имеющие явного значения для этого свойства, наследуют значение по умолчанию.

    • По желанию вы можете выбрать «Требовать явно указанные пользователем значения». Когда эта опция включена, пользователи и приложения с разрешением устанавливать значения свойств должны указывать явное значение при настройке свойств, создании репозиториев или переносе репозиториев. Репозитории, которые ещё не имеют явного значения, всё равно будут наследовать значение по умолчанию.

11. Нажмите кнопку " Сохранить свойство".

Установка значений для репозиториев в организации

Вы и любые пользователи с разрешением «Редактировать пользовательские свойства на уровне организации» можете устанавливать значения для пользовательских свойств для репозиториев вашей организации.

1. В правом верхнем углу GitHub, щелкните рисунок профиля, а затем выберите октикона "организация" aria-hidden="true" aria-label="organization" %} Ваши организации.

2. Выберите организацию, кликнув по ней.

3. Под именем организации щелкните Settings. Если вкладка "Параметры" не отображается, выберите раскрывающееся меню и нажмите кнопку "Параметры".

   

4. В левой боковой панели в разделе "Код, планирование и автоматизация" щелкните Репозиторий, а затем выберите "Настраиваемые свойства".

   

5. Перейдите на вкладку "Задать значения".

6. Выберите один или несколько репозиториев из списка и нажмите «Редактировать свойства».

   

7. В появившемся модальном диалоговом окне выберите значение для каждого свойства, которое вы хотите задать для выбранных репозиториев. Это значение не должно превышать 75 символов в длину.

8. Нажмите кнопку Сохранить изменения.

Просмотр значений для репозиториев в организации

Пользователи с разрешениями на чтение в репозитории могут просматривать значения настраиваемых свойств этого репозитория, но они не могут изменять эти значения.

          Вы также можете использовать REST API для перечисления пользовательских свойств, назначенных вашей организацией репозиторию. Для получения дополнительной информации см. [AUTOTITLE](/rest/repos/custom-properties).

1. На GitHubперейдите на главную страницу репозитория.

2. Под именем репозитория щелкните Settings. Если вкладка "Параметры" не отображается, выберите раскрывающееся меню и нажмите кнопку "Параметры".

   

3. В разделе «Код и автоматизация» боковой панели нажмите «Пользовательские свойства».

Поиск и фильтрация репозиториев по пользовательским значениям свойств

Вы можете искать репозитории в организации по пользовательским значениям свойств.

1. В правом верхнем углу GitHub, щелкните рисунок профиля, а затем выберите октикона "организация" aria-hidden="true" aria-label="organization" %} Ваши организации.
2. Щелкните название своей организации.
3. Под названием вашей организации нажмите «Хранилища».
4. В строке поиска введите prop список всех настраиваемых свойств в вашей организации и выберите свойство, по которым вы хотите выполнить поиск.