Связывание фиксаций GitHub, запросов на вытягивание и проблемы с рабочими элементами в Azure Boards

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

После подключения проекта Azure Boards к репозиторию GitHub можно связать рабочие элементы с фиксациями GitHub и запросами на вытягивание. Вы можете добавить ссылки с помощью синтаксиса #упоминание, знакомого пользователям GitHub, или добавить тип ссылки запроса на вытягивание GitHub из рабочего элемента Azure Boards.

Примечание.

Благодаря использованию приложения Azure Boards для GitHub поддерживается интеграция Azure Boards и Azure DevOps Services с репозиториями GitHub.com и GitHub Enterprise Server. Azure DevOps Server 2019 и более поздних версий поддерживают интеграцию только с репозиториями GitHub Enterprise Server. Интеграция с другими репозиториями Git не поддерживается.

Необходимые компоненты

• Проект Azure Boards должен быть подключен к репозиторию GitHub, где фиксации и запросы на вытягивание, к которым требуется связаться или из него. Дополнительные сведения см. в статье об интеграции Azure Boards-GitHub.
• Вы должны быть участником проекта Azure Boards и репозитория GitHub.

Примечание.

Проекты, использующие модель процесса размещенного XML, требуют обновления типов рабочих элементов для просмотра разделов разработки и ссылок GitHub. Дополнительные сведения см. в разделе "Обновление xml-определений" для выбора типов рабочих элементов.

Использование AB# ссылки с GitHub на рабочие элементы Azure Boards

Из фиксации GitHub, запроса на вытягивание или проблему используйте следующий синтаксис, чтобы создать ссылку на рабочий элемент Azure Boards. AB#ID Введите текст сообщения фиксации. Или для запроса на вытягивание или проблемы введите AB#ID в заголовке или описании (а не комментарий).

AB#{ID}

Например, AB#125 ссылки на рабочий элемент ID 125.

Вы также можете ввести сообщение о фиксации или запросе на вытягивание для перехода рабочего элемента. Система распознает fix, fixes, fixed и применяет его к следующему элементу #-упоминание. Упомянутые рабочие элементы переходили в первое состояние, связанное с состоянием категории разрешенных рабочих процессов. Если состояние не связано с разрешенным, оно переходит в состояние, связанное с состоянием категории завершенного рабочего процесса. Сведения о сопоставлении состояний рабочего процесса и состояний категорий см. в статье о том, как используются состояния категорий рабочих процессов в невыполненных работах и досках Azure Boards.

См. следующую таблицу примеров.

Сообщение о фиксации или запросе на вытягивание	Действие
Fixed AB#123	Связывает и перемещает рабочий элемент в категорию состояния разрешенного рабочего процесса или, если он не определен, то категория состояния завершенного рабочего процесса.
Adds a new feature, fixes AB#123.	Связывает и перемещает рабочий элемент в категорию состояния разрешенного рабочего процесса или, если он не определен, то категория состояния завершенного рабочего процесса.
Fixes AB#123, AB#124, and AB#126	Ссылки на рабочие элементы Azure Boards 123, 124 и 126. Переходит только первый элемент, 123 в категорию состояния разрешенного рабочего процесса или, если он не определен, то категория состояния завершенного рабочего процесса.
Fixes AB#123, Fixes AB#124, Fixes AB#125	Ссылки на рабочие элементы Azure Boards 123, 124 и 126. Перемещает все элементы в категорию состояния разрешенного рабочего процесса или, если он не определен, то категория состояния завершенного рабочего процесса.
Fixing multiple bugs: issue #123 and user story AB#234	Ссылки на выпуск GitHub 123 и Рабочий элемент Azure Boards 234. Переходы не выполняются.

Примечание.

Если вы подключили один репозиторий GitHub к проектам, определенным в двух или нескольких организациях Azure DevOps, может возникнуть непредвиденная привязка AB# упоминание. Дополнительные сведения см. в разделе "Устранение проблем с подключением". По этой причине рекомендуется подключить репозиторий GitHub только к проектам, определенным в одной организации Azure DevOps.

Добавление ссылки из рабочего элемента в фиксацию, запрос на вытягивание или проблему GitHub

1. Чтобы связаться с запросом фиксации или вытягивания, откройте рабочий элемент и нажмите кнопку "Добавить ссылку " в разделе "Разработка".

   

   Чтобы связаться с проблемой, перейдите на вкладку "Ссылки", а затем нажмите кнопку "Добавить существующий элемент ссылки>".

   

2. В диалоговом окне "Добавить ссылку" выберите один из типов ссылок GitHub, введите URL-адрес фиксации, запроса на вытягивание или проблему, а затем нажмите кнопку "ОК".
   Здесь мы добавим ссылку на запрос на вытягивание GitHub.

   

   Azure Boards завершает проверка, чтобы убедиться, что вы ввели действительную ссылку. Связанный с репозиторием GitHub должен быть подключен к проекту Azure Boards или проверка завершается ошибкой.

   Здесь мы добавим ссылку на проблему GitHub.

   

Просмотр или открытие ссылок из раздела "Разработка"

В разделе "Разработка" в форме рабочего элемента перечислены ссылки, созданные для фиксаций GitHub и запросов на вытягивание с помощью значка GitHub.

Выберите ссылку, указанную для открытия запроса фиксации или извлечения в GitHub.

Просмотр объектов GitHub на доске Kanban

С включенными заметками GitHub на доске Kanban можно быстро открыть связанные фиксации GitHub, запросы на вытягивание или дополнительные сведения о проблемах. Дополнительные сведения см. в разделе "Настройка карта".

Следующие шаги

Настройка индикаторов состояния

Связанные статьи

• Добавление или удаление репозиториев
• Изменение доступа к репозиторию GitHub
• Интеграция Azure Boards-GitHub
• Использование состояний категории рабочих процессов в невыполненных работах и досках в Azure Boards
• Связывание рабочих элементов с объектами
• Устранение неполадок при интеграции между GitHub и Azure Boards