Настройка автоматической привязки для отсылок на внешние ресурсы

Вы можете добавить автоматические привязки ко внешним ресурсам, таким как проблемы JIRA и билеты Zendesk, чтобы упростить рабочий процесс.

Кто может использовать эту функцию?

Автоматическое связывание доступно в репозиториях с GitHub Pro, GitHub Team, GitHub Enterprise Cloudи GitHub Enterprise Server.

В этой статье

Любой пользователь с разрешениями администратора для репозитория может настроить ссылки для автопривязки, чтобы связать проблемы, запросы на вытягивание, сообщения фиксации и описания выпусков с внешними сторонними службами.

Ссылки на автоматическое связывание теперь могут принимать буквенно-цифровые символы. При первоначальном вводе пользовательские автоматические привязки были ограничены внешними ресурсами, которые использовали числовые идентификаторы. Пользовательские автоматические связи теперь работают с буквенно-цифровыми и числовыми идентификаторами.

Вы определяете пользовательские автоматические привязки, указывая префикс ссылки и целевой URL-адрес.

  • Префиксы ссылок не могут иметь перекрывающиеся имена. Например, репозиторий не может иметь две пользовательские автоматические привязки с такими префиксами, как TICKET и TICK, так как оба префикса будут соответствовать строке TICKET123a.
  • Целевые URL-адреса включают переменную <num> , представляющую идентификатор ссылки связанного ресурса.

В этой процедуре показано, как настроить автоматические привязки для ссылки на внешние ресурсы. Например, если вы используете Zendesk для отслеживания билетов из отчетов пользователей, вы можете указать номер билета в запросе на вытягивание, который вы создали для устранения проблемы.

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

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

    Снимок экрана: заголовок репозитория с вкладками. Вкладка "Параметры" выделена темно-оранжевым контуром.

  3. В разделе "Integrations" боковой панели щелкните Autolink ссылки.

  4. В правом верхнем углу страницы нажмите кнопку "Добавить ссылку автолинка".

    Снимок экрана: страница "Ссылки на автолинка". Кнопка "Добавить ссылку на автолинка" выделена темной оранжевым контуром.

  5. Выберите формат идентификатора ссылки, используемого во внешнем ресурсе, буквенно-цифровым или числовым.

  6. В разделе "Ссылочный префикс" введите короткий понятный префикс. Сотрудники будут использовать этот текст для создания автоматических ссылок для внешнего ресурса.

  7. В поле "Целевой URL-адрес" введите формат ссылки на внешнюю систему, которую вы хотите создать. <num> Используйте переменную в качестве заполнителя для идентификатора ссылки.

  8. Просмотрите предварительный просмотр и убедитесь, что автоматическая ссылка и внешняя ссылка являются правильными, а затем нажмите кнопку "Добавить ссылку автолинка", чтобы определить ссылку.

Например, можно ввести следующее.

  • Ссылочный префикс: JIRA-
  • Целевой URL-адрес: https://jira.example.com/issue?query=<num>
  • Предварительная версия: JIRA-123 преобразуется в https://jira.example.com/issue?query=123