Связывание с рабочими элементами из других объектов

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

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

В следующих областях можно ввести #ID ссылку на рабочие элементы:

  • Обсуждение рабочего элемента или любое поле с форматированным текстом
  • Комментарии фиксации Git и описания запросов на вытягивание
  • Комментарии к набору изменений или набору полок TFVC
  • Вики-страницы
  • Обсуждение рабочего элемента
  • Комментарии фиксации Git и описания запросов на вытягивание
  • Комментарии к набору изменений или набору полок TFVC

Совет

Вы можете настроить автоматическое связывание и другие параметры, которые связывают рабочие элементы с фиксациями Git, запросами на вытягивание, сборками и т. д. Чтобы узнать, как это сделать, ознакомьтесь со следующими ресурсами:

Типы ссылок, используемые для связывания рабочих элементов с объектами devops ( как показано на следующем рисунке), — build, Found in build, Integrated in build, Integrated in release for build and release pipelines; Ветвь, фиксация, запрос на вытягивание и тег для репозиториев Git и Changeset, Shelveset и VersionedItem для репозиториев система управления версиями Team Foundation (TFVC). Все они обозначены как внешние типы ссылок.

Концептуальное изображение типов ссылок, используемых для связывания рабочих элементов с объектами devops.

На вкладке "Ссылки " формы рабочего элемента можно просмотреть все объекты, связанные с рабочим элементом , как описано далее в этой статье. Однако вы не можете создать запрос рабочего элемента для перечисления этих ссылок. Запросы рабочих элементов возвращают только рабочие элементы, связанные с другими рабочими элементами. Однако можно создать запрос, содержащий рабочие элементы, содержащие внешние ссылки. Чтобы узнать, как это сделать, см. статью "Запрос по ссылке или количеству вложений".

Примечание

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

  1. Введите # , чтобы активировать #ID средство выбора рабочих элементов в фиксациях запроса на вытягивание, зафиксировать комментарии, примечания к набору изменений, комментарии наборов полок, описание и многое другое. Вы увидите список из 50 рабочих элементов, которые вы недавно изменили или которые назначены вам.

    Снимок экрана: список рабочих элементов, созданный при вводе # в описании запроса на вытягивание.

  2. Сузьте список предлагаемых рабочих элементов, введя ключевые слова, соответствующие типу, идентификатору или названию рабочего элемента.

    Снимок экрана: ввод ключевого слова после # и результирующий рабочий элемент в поиске

    Чтобы дополнительно отфильтровать список, продолжайте вводить ключевые слова, пока не найдете совпадение. Можно ввести до пяти ключевых слов.

Настройка состояния рабочего элемента в запросе на вытягивание

При создании запроса на вытягивание можно задать значение состояния связанных рабочих элементов в описании. Следуйте синтаксису: {state value}: #ID. При слиянии запроса на вытягивание система считывает описание и обновляет состояние рабочего элемента. В следующем примере для рабочих элементов #300 и #301 задано значение Resolved, а для #323 и 324 — значение Closed.

Снимок экрана: настройка состояния рабочего элемента в запросе на вытягивание.

Примечание

Для этого компонента требуется установка обновления Azure DevOps Server 2020.1. Дополнительные сведения см. в заметках о выпуске версии 1 версии 1 Azure DevOps Server 2020, Boards.

Принцип работы

Система учитывает следующие три разных критерия (в этом порядке) при попытке задать состояние #mentioned рабочих элементов:

  • Состояние
  • Категория состояния
  • ключевое слово

Логика критериев

В следующей таблице описана логика.

Критерии Действие
Если значение соответствует состоянию, Затем присвойте ему это состояние.
Else If the value matches a state category, Затем присвойте рабочему элементу первое состояние в этой категории. См. следующее примечание.
Else If the value соответствует ключевому слову, Затем установите рабочий элемент в соответствии с состоянием ключевого слова. См. следующую таблицу.
Еще Пропустить его и ничего не делать.

Логика ключевых слов

Логика ключевых слов помогает с сопоставлением намерений. Например, можно ввести "Разрешить", но вы действительно означало "Разрешено".

Ключевое слово Действие
Предлагаемое, предложение, предложение Задайте первое состояние в предлагаемой категории.
InProgress Задайте первое состояние в категории "Выполняется".
Завершено, Завершено, Завершено Задайте первое состояние в категории "Завершено".
Разрешено, разрешается, разрешается Задайте первое состояние в категории "Разрешено".
Исправления, исправление, исправление Закройте рабочий элемент. За исключением ошибки, которая получает значение Resolved.

Примечание

Сопоставление категорий не поддерживается в проектах с помощью размещенного XML-процесса. Сопоставление категорий доступно только для проектов, использующих унаследованный процесс.

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

Примечание

Для этого компонента требуется установка обновления Azure DevOps Server 2020.1. Дополнительные сведения см. в заметках о выпуске версии 1 версии 1 Azure DevOps Server 2020, Boards.

  1. На вкладке "Ссылки" рабочего элемента нажмите кнопку "Добавить существующий>элемент".

  2. В диалоговом окне "Добавить ссылку" выберите один из типов ссылок сборки — "Сборка", " Найдено в сборке", "Интегрировано в сборку" и укажите номер сборки.

    Если вы не знаете номер сборки ( сочетание конвейера и имени сборки), его можно найти, щелкнув значок.

    Диалоговое окно добавления ссылки с выбранным типом ссылки

  3. В диалоговом окне "Сборки ссылок " выберите параметры для фильтрации поиска сборок.

    При связывании со сборкой в другом проекте сначала выберите проект , сборка которого требуется связать.

    Например, можно указать номер сборки, выбрать конвейер сборки, результат сборки, например " Все", "Успешно", "Частично выполнено", "Сбой" или "Отменено". Или, выбрав "Все " для результата, выберите "Найти ", чтобы получить список доступных сборок для ссылки.

    Диалоговое окно поиска сборок с выбранным проектом и перечисленными сборками.

  4. Выберите сборку из списка, на который вы хотите связаться, и нажмите кнопку "ОК".

  5. В диалоговом окне "Добавить ссылку " нажмите кнопку "ОК ", чтобы завершить операцию.

    Диалоговое окно добавления ссылки с заполненным номером сборки.

Рабочие элементы можно связать с существующими сборками в диалоговом окне добавления ссылки .

  1. На вкладке "Ссылки" рабочего элемента нажмите кнопку "Добавить ссылку>Существующий элемент".

  2. В диалоговом окне "Добавить ссылку " выберите один из типов ссылок на сборку — "Сборка", "Найдено в сборке", "Интегрировано в сборку" и укажите номер сборки.

    Если вы не знаете номер сборки ( сочетание конвейера и имени сборки), его можно найти, щелкнув значок.

    Диалоговое окно добавления ссылки с выбранным типом ссылки

  3. В диалоговом окне "Компоновка сборок" выберите параметры для фильтрации поиска сборок.

    Например, можно указать номер сборки, выбрать конвейер сборки, результат сборки, например " Все", "Успешно", "Частично выполнено", "Сбой" или "Отменено". Или, выбрав "Все " для результата, выберите "Найти ", чтобы получить список доступных сборок для ссылки.

    Диалоговое окно поиска сборок, ссылка на сборку в проекте.

  4. Выберите сборку из списка, на который вы хотите связаться, и нажмите кнопку "ОК".

  5. В диалоговом окне "Добавить ссылку " нажмите кнопку "ОК ", чтобы завершить операцию.

    Диалоговое окно добавления ссылки с заполненным номером сборки.

Введите # , чтобы активировать #ID средство выбора рабочих элементов на вики-странице.

Дополнительные сведения о встроенном вики-сайте см. в разделе "Добавление & редактирования вики-страниц" и руководства по вики-разметке Markdown.

Вы также можете связать таблицу результатов запроса с вики-сайтом. Это поддерживает быстрый доступ к каждому связанному рабочему элементу в запросе. Дополнительные сведения см. в руководстве по Wiki Markdown.

Просмотр списка связанных объектов

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

Снимок экрана: вкладка

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

Например, на следующей вкладке "Ссылки" показана часть 64 связанных объектов для рабочего элемента.

Снимок экрана: вкладка

Ссылки, предшествующие красной восклицательный знак, указывают на то, что сборка, выпуск или другой объект удалены. Обычно это связано с политиками хранения, которые автоматически удаляют эти объекты по истечении определенного периода времени.

Azure Repos, Git