Бөлісу құралы:

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

  • Мақала

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

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

В этой статье описано, как выполнить следующие задачи:

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

Необходимые условия Description
Администратор проекта или участник Необходимо добавить в проект в качестве члена группы безопасности участников или администраторов проектов.
Доступ заинтересованных лиц Чтобы добавить или изменить рабочие элементы, необходимо предоставить заинтересованным лицам доступ или выше. Пользователи с доступом заинтересованных лиц для общедоступных проектов имеют полный доступ к функциям невыполненной работы и доски, например пользователям с базовым доступом. Дополнительные сведения см. в кратком справочнике по правам доступа для заинтересованных лиц.
Участник или разрешить пермы — Для просмотра или изменения рабочих элементов необходимо иметь рабочие элементы view в этом узле и изменить рабочие элементы в этом узле, для которых задано значение Allow. По умолчанию группа участников имеет это разрешение на разрешение. Дополнительные сведения см. в разделе "Настройка разрешений и доступ для отслеживания работы".
— Чтобы настроить параметры интеграции для классического конвейера выпуска, необходимо иметь разрешения на изменение выпуска.
— Чтобы связать рабочие элементы с фиксациями и запросами на вытягивание, необходимо задать разрешения "Изменить рабочие элементы" в этом узле , чтобы разрешить путь к области, назначенный рабочему элементу. По умолчанию группа участников имеет этот набор разрешений.
— Для просмотра рабочих элементов необходимо иметь рабочие элементы представления в этом узле, заданные для разрешения пути к области, назначенному рабочему элементу.
Определенные итерации Чтобы использовать область планирования , администратор команды должен определить пути итерации (спринт) и настроить итерации команды.
Предварительные требования Description
Администратор проекта или участник Необходимо добавить в проект в качестве члена группы безопасности участников или администраторов проектов.
Доступ заинтересованных лиц Чтобы добавить или изменить рабочие элементы, необходимо предоставить заинтересованным лицам доступ или выше.
Участник или разрешить пермы — Для просмотра или изменения рабочих элементов необходимо иметь рабочие элементы view в этом узле и изменить рабочие элементы в этом узле, для которых задано значение Allow. По умолчанию группа участников имеет это разрешение на разрешение. Дополнительные сведения см. в разделе "Настройка разрешений и доступ для отслеживания работы".
— Чтобы настроить параметры интеграции для классического конвейера выпуска, необходимо иметь разрешения на изменение выпуска.
— Чтобы связать рабочие элементы с фиксациями и запросами на вытягивание, необходимо задать разрешения "Изменить рабочие элементы" в этом узле , чтобы разрешить путь к области, назначенный рабочему элементу. По умолчанию группа участников имеет этот набор разрешений.
— Для просмотра рабочих элементов необходимо иметь рабочие элементы представления в этом узле, заданные для разрешения пути к области, назначенному рабочему элементу.
Определенные итерации Чтобы использовать область планирования , администратор команды должен определить пути итерации (спринт) и настроить итерации команды.
Предварительные требования Description
Администратор проекта или участник Необходимо добавить в проект в качестве члена группы безопасности участников или администраторов проектов.
Доступ заинтересованных лиц Чтобы добавить или изменить рабочие элементы, необходимо предоставить заинтересованным лицам доступ или выше.
Участник или разрешить пермы Чтобы просмотреть или изменить рабочие элементы, необходимо иметь рабочие элементы Представления в этом узле и изменить рабочие элементы в разрешениях этого узла, для которых задано значение Allow. По умолчанию группа участников имеет это разрешение на разрешение. Дополнительные сведения см. в разделе "Настройка разрешений и доступ для отслеживания работы".
Определенные итерации Чтобы использовать область планирования , администратор команды должен определить пути итерации (спринт) и настроить итерации команды.

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

Тип ссылки Description
Гиперссылка Подключает рабочий элемент к любому URL-адресу или сетевому ресурсу
Тип внешней ссылки Подключает рабочий элемент к внешнему объекту, например объекту кода, сборке или вики-странице
Тип канала удаленной работы Подключает рабочие элементы, определенные в разных организациях
Тип ссылки GitHub Подключает рабочий элемент к фиксации, проблеме или запросу на вытягивание репозитория GitHub
Тип рабочей ссылки Подключает рабочие элементы, включая выбор рабочих элементов управления тестом

Дополнительные сведения о типах ссылок, включая родительский или дочерний, связанный и предшественник-преемник, см. в разделе "Типы ссылок".

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

  1. На веб-портале откройте рабочий элемент, из которого вы хотите связаться, или создайте новый.

  2. Перейдите на вкладку "Ссылки" и выберите ссылку.

  3. В раскрывающемся списке "Тип ссылки" выберите тип ссылки, которую вы хотите создать.

  4. В поле "Ссылка на ссылку" введите или выберите объект, к которому требуется связаться. В зависимости от типа ссылки можно ввести или выбрать следующие объекты.

  5. (Необязательно) Введите комментарий, чтобы описать ссылку.

  6. Выберите ОК для создания ссылки.

Совет

Существуют и другие функции, которые можно использовать для ссылки или изменения ссылок, использующих тип ссылки Parent/Child . Некоторые функции зависят от версий. Дополнительные сведения см. в связанных статьях.

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

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

  2. В форме рабочего элемента выберите раздел "Связанная работа ".

  3. Выберите " Добавить ссылку" и " Существующий элемент".

  4. В раскрывающемся списке "Тип ссылки" выберите тип ссылки, которую нужно создать, например родительский, дочерний или связанный.

  5. В поле "Рабочий элемент" введите идентификатор рабочего элемента, к которому нужно связаться, а затем нажмите кнопку "ОК".

    В следующем примере используется тип связанной ссылки для связывания трех элементов с идентификатором 400.

    Снимок экрана: диалоговое окно добавления ссылки, веб-портал в существующий рабочий элемент.

    Ссылки можно добавлять только в один раз. Нельзя вводить идентификаторы, разделенные запятыми или пробелами.

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

  6. (Необязательно) Если вы работаете на странице результатов запроса, массово сохраните измененные рабочие элементы. При работе из невыполненной работы рабочие элементы автоматически сохраняются.

    Снимок экрана: страница результатов запроса, сохранение массовых измененных элементов.

  1. На веб-портале откройте страницу результатов невыполненной работы или запроса и выберите рабочие элементы, к которым нужно добавить ссылку.

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

    В следующем примере несколько выборок из невыполненной работы продукта и выбор существующего элемента....

    Снимок экрана: контекстное меню невыполненной работы, пункты с несколькими выборами в невыполненной работе, откройте контекстное меню, выберите

  3. В раскрывающемся списке "Тип ссылки" выберите тип ссылки, которую нужно создать, например Parent, Child или Related.

  4. В поле "Рабочий элемент" введите идентификатор рабочего элемента, к которому нужно связаться, а затем нажмите кнопку "ОК".

  1. На веб-портале откройте рабочий элемент и выберите "Ссылки".

  2. Выберите ссылку "Изменить дополнительные действия".>

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

  3. Выберите тип ссылки, на который нужно изменить, и нажмите кнопку "Сохранить".

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

  4. Сохраните рабочий элемент.

Выполните следующие действия, чтобы связать рабочий элемент с новым рабочим элементом.

  1. Укажите тип ссылки, тип рабочего элемента и заголовок нового рабочего элемента. Нажмите ОК. Рабочий элемент выбранного типа.

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

  2. Введите дополнительные сведения и сохраните рабочий элемент.

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

  3. (Необязательно) Если вы работаете на странице результатов запроса, массово сохраните измененные рабочие элементы.

Организации, использующие идентификатор Microsoft Entra, могут связываться с рабочими элементами, существующими в разных проектах в разных организациях. Используйте следующие типы ссылок, как указано ниже.

  • Используйте типы ссылок "Использование из" или "Создание" для отслеживания зависимостей рабочих элементов, определенных в разных организациях и управляемых различными командами.
  • Используйте тип ссылки удаленного связи, если связанные рабочие элементы определяются в разных организациях и управляются разными командами, но не имеют сильных межзависимостей.

Снимок экрана: форма

Выполните следующие действия, чтобы связать рабочие элементы с объектами, определенными в других организациях Azure DevOps. Это можно сделать только в том случае, если обе организации используют один и тот же идентификатор Microsoft Entra для управления пользователями.

  1. Выберите один из следующих типов удаленных ссылок:

    • Используется из или создает для: если требуется отслеживать зависимости рабочих элементов, определенных в разных организациях и управляемых различными командами.
    • Удаленные связи: когда рабочие элементы, связанные, определяются в разных организациях и управляются разными командами, но не имеют сильных межзависимостей.

  2. В диалоговом окне "Добавить ссылку" выберите тип ссылки, введите URL-адрес удаленного рабочего элемента и нажмите кнопку "ОК".

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

    Снимок экрана: удаление ссылки на рабочий элемент.

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

В следующем примере показаны две удаленные ссылки, указанные значком облака, добавленными в историю пользователя.

Снимок экрана: форма

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

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

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

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

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

При подключении Azure Boards к репозиториям GitHub можно связать рабочие элементы с GitHub Commit, GitHub Pull Request, GitHub Branch и GitHub Issue. Вы можете использовать GitHub для разработки программного обеспечения при использовании Azure Boards для планирования и отслеживания работы.

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

Внимание

Рабочие элементы можно связать только с объектами GitHub с репозиториями, подключенными к Azure Boards. Дополнительные сведения см. в разделе "Подключение azure Boards к GitHub" и "Ссылка на рабочие элементы" из запросов на вытягивание, фиксации и комментарии.

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

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

Снимок экрана: невыполненная работа, контекстное меню, выберите

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

Примечание.

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

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

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

    Номер сборки — это сочетание имени конвейера и сборки. Если номер сборки не известен, найдите его, выбрав значок.

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

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

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

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

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

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

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

    Снимок экрана: диалоговое окно добавления ссылки с введенным номером сборки.

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

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

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

    Номер сборки — это сочетание имени конвейера и сборки. Если номер сборки не известен, найдите его, выбрав значок.

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

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

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

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

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

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

    Снимок экрана: диалоговое окно добавления ссылки с введенным номером сборки.

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

Типы ссылок, используемые для создания этих ссылок: Branch, Build, Changeset, Commit, Found in build, Integrated in build, Pull Request, Versioned Item и Integrated in release environment. Эти типы отображаются на следующем рисунке.

Концептуальное изображение типов ссылок devops.

Совет

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

  • Перед фиксацией изменений добавьте идентификаторы рабочих элементов в Git Changes for Visual Studio 2022 или Team Explorer для предыдущих версий Visual Studio:

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

  • Используйте команду git-commit и добавьте идентификатор рабочего элемента в комментарий. Например, примените этот комментарий #35 Catch null exception к фиксации. При отправке фиксации система создает связь фиксации между фиксацией и рабочим элементом #35.

  • Используйте элемент управления "Разработка" для разработки git из рабочего элемента. Дополнительные сведения см. в статье о разработке Drive Git из рабочего элемента в Azure Boards.

Как показано на следующем рисунке, элемент управления развертыванием отображает сведения о выпуске на двух этапах выпуска. Он включает рабочие элементы, связанные с фиксацией Git или запросом на вытягивание для конвейера выпуска, настроенного для интеграции с Azure Boards.

Снимок экрана: несколько сред, предназначенных для выпуска.

Контроль развертывания

Формы рабочих элементов предоставляют два элемента управления для отображения и перехода к объектам разработки. В этой статье описывается элемент управления "Развертывание". Сведения об элементе управления "Разработка" см. в разделе "Разработка диска Git" из рабочего элемента.

По умолчанию элемент управления развертыванием отображается в формах рабочих элементов для пользовательской истории (Agile), элемента невыполненной работы продукта (scrum), проблемы (базовый), требования (CMMI), компонента, epic, Bug, Task и Test Case рабочих элементов.

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

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

Снимок экрана: форма рабочего элемента, элемент управления

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

Снимок экрана: несколько сред, предназначенных для выпуска.

При открытии рабочего элемента можно просмотреть этапы в режиме реального времени.

Снимок экрана: этапы параметров выпуска, включая тестирование, промежуточное размещение, рабочую среду и разработку.

Чтобы заполнить элемент управления развертыванием, сделайте следующее:

Примечание.

Элемент управления развертывания требует настройки классического конвейера выпуска. Он не поддерживает связывание с этапами выпуска, определенными для конвейера YAML.

  1. Определите классический конвейер выпуска и настройте этапы выпуска. Дополнительные сведения см. в разделе "Определение многоэтапного конвейера непрерывного развертывания (CD).

  2. Настройте конвейер. Дополнительные сведения см. в разделе "Настройка конвейеров для поддержки отслеживания работы", состояния развертывания отчета в Boards.

  3. Связывание рабочих элементов с запросом фиксации или извлечения в репозитории Azure Repos Git. Дополнительные сведения см. в разделе:

  4. Запуск конвейера.

Управление версиями Team Foundation (TFVC) позволяет связывать рабочие элементы с наборами изменений в версиях или версиями файлов исходного кода с помощью типов ссылок "Изменения " и "Версияя элемента ". При возврате ожидающих изменений или использовании my Work для проверки изменений рабочие элементы автоматически связываются с изменениями. Дополнительные сведения см. в статье "Проверка работы".

Снимок экрана: Team Explorer, My Work, Pending Changes, Check in.

Типы ссылок, связанные с тестом, связывают рабочие элементы управления тестом друг с другом или с другими рабочими элементами. На веб-портале или Microsoft Test Manager можно просмотреть тестовые случаи, определенные для набора тестов, и какие наборы тестов определены для плана тестирования. Эти объекты не связаны друг с другом с помощью типов ссылок.

Рабочие элементы можно связать с тестируемыми вариантами с помощью типов ссылок Tested/Tested By . Используйте те же элементы управления ссылками, которые используются для связывания рабочих элементов с другими рабочими элементами. См. статью " Ссылки рабочих элементов".

На следующем рисунке показан полный набор типов ссылок, которые можно использовать с типами рабочих элементов управления тестами. Большинство связей между объектами управления тестами выполняются путем выполнения задачи на страницах тестирования или Microsoft Test Manager.

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

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

Снимок экрана: форма тестового рабочего элемента с инструкциями.

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

В тестовом режиме можно добавить планы тестирования, наборы тестов и тестовые случаи, связанные. Их нельзя добавить с помощью определенного типа ссылки. Тестовая система создает ассоциации результатов теста и управляет ими с тестовых вариантами и планами тестирования.

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

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

Снимок экрана: тип ссылки

Azure DevOps предоставляет несколько способов просмотра зависимостей и отслеживания связанных работ:

  • Редактор запросов. Вы можете использовать Редактор запросов для создания пользовательских запросов, отображающих все рабочие элементы, связанные с определенным рабочим элементом.
  • Невыполненные работы и доски: в представлениях невыполненных работ и досок отображаются связи между рабочими элементами с родительским дочерним элементом, что позволяет просматривать зависимости на первый взгляд.
  • Средство отслеживания зависимостей. Средство отслеживания зависимостей — это отчет Power BI, предоставляющий визуальное представление зависимостей между рабочими элементами.

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

  1. Откройте рабочий элемент и выберите "Ссылки". Вкладка ссылок указывает количество всех связанных объектов. Связанные объекты группируются в соответствии с типом ссылки с подсчетом в каждой группе.

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

  2. (Необязательно) Разверните или свернуть каждую группу и сортируйте в каждой группе по состоянию, последнему обновлению или примечания , выбрав соответствующий заголовок столбца.

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

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

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

Запрос связанных рабочих элементов

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

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

Примеры запросов см. в разделе "Запрос рабочих элементов" по ссылке или количеству вложений.

Невозможно создать запрос, показывающий иерархическое представление планов тестирования, наборов тестов и тестовых вариантов. Эти элементы не связаны друг с другом с помощью родительского или дочернего или другого типа ссылки. Иерархию можно просмотреть только на странице "Тестовые>планы тестирования". Дополнительные сведения см. в разделе "Создание планов тестирования" и наборов тестов.

Вы можете добавлять, удалять и отображать сведения о ссылках на рабочий элемент с помощью команды az boards work-item relation . Дополнительные сведения см. в статье "Начало работы с Azure DevOps CLI".

Типы ссылок включают типы рабочих ссылок, типы удаленных ссылок, гиперссылки и вложенные файлы. Для списка всех типов ссылок, которые можно указать, выполните команду az boards work-item relation list-type .

az boards work-item relation add
az boards work-item relation remove
az boards work-item relation show

В следующих примерах организация является fabrikam, а идентификатор проекта соответствует aaaa-0000-1111-2222-bbbb. Формат таблицы используется для отображения выходных данных. Другие форматы см. в разделе "Выходные форматы" для команд Azure CLI.

Чтобы связать один или несколько рабочих элементов с одним рабочим элементом, введите команду az boards work-item relation add .

Обязательные параметры включают идентификатор рабочего элемента для ссылки и типа ссылки. Поддерживаемые типы ссылок включают родительский, дочерний, связанный и удаленный. Для списка всех типов ссылок выполните команду az boards work-item relation list-type .

Для рабочих элементов, определенных в одной организации, необходимо указать идентификатор рабочего элемента или целевой URL-адрес. Для рабочих элементов, определенных в удаленной организации, укажите целевой URL-адрес. Можно указать несколько значений, разделив идентификаторы или URL-адреса с запятой.

az boards work-item relation add --id
                                 --relation-type
                                 [--detect {false, true}]
                                 [--org]
                                 [--target-id]
                                 [--target-url]

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

az boards work-item relation add --id 2794 --relation-type Child --target-id 2856 --output table
Are you sure you want to remove this relation(s)? (y/n): y
Relation Type    Url
---------------  -------------------------------------------------------------------------------------------------
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2850
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2808
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2820
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2856
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2811
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2876
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2801
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2877
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2805
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2807

Чтобы просмотреть сведения для связанных рабочих элементов, введите один из URL-адресов, перечисленных в браузере.

Чтобы удалить один или несколько связанных рабочих элементов из одного рабочего элемента, введите команду az boards work-item relation remove .

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

Необходимо указать идентификатор целевого рабочего элемента. Можно указать несколько значений, разделив идентификаторы или URL-адреса с запятой.

az boards work-item relation remove --id
                                    --relation-type
                                    --target-id
                                    [--detect {false, true}]
                                    [--org]
                                    [--yes]

Следующая команда удаляет ссылку на рабочий элемент ID=2794 из рабочего элемента ID=2856 для работы элемента с типом дочерней ссылки. Команда возвращает список всех ссылок, определенных для рабочего элемента.

az boards work-item relation remove --id 2794 --relation-type Child --target-id 2807 --output table
Are you sure you want to remove this relation(s)? (y/n): y
Relation Type    Url
---------------  -------------------------------------------------------------------------------------------------
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2850
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2808
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2820
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2856
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2811
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2876
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2801
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2877
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2805

Чтобы просмотреть сведения для связанных рабочих элементов, введите один из URL-адресов, перечисленных в браузере.

Чтобы просмотреть рабочие элементы, связанные с одним рабочим элементом, введите команду az boards work-item relation show . Чтобы получить список всех типов ссылок, которые можно вернуть, выполните команду az boards work-item relation list-type .

az boards work-item relation show --id
                                  [--detect {false, true}]
                                  [--org]

Следующая команда содержит сведения о ссылках, определенных для рабочего элемента ID=2931 в организации fabrikam в формате таблицы.

az boards work-item relation show --id 2931 --output table
Relation Type    Url
---------------  -----------------------------------------------------------------------------------------------------------------------------------
Related          https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2932
Successor        https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2932
Remote Related   https://dev.azure.com/fabrikam-fiber5/bbbbbbbb-1111-2222-3333-cccccccccccc/_apis/wit/workItems/1777
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2930
Predecessor      https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2933
Attached File    https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/attachments/1cc6c026-b4ed-420c-bfe6-065be726cba7

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

Выполните следующие действия, чтобы удалить ссылку на рабочий элемент.

  1. Откройте рабочий элемент с ссылками или выберите его из результата запроса.
  2. Выберите вкладку "Ссылки", чтобы просмотреть список ссылок.
  3. Выберите ссылку, которую нужно удалить, и нажмите кнопку "Удалить".
  4. Убедитесь, что вы хотите удалить ссылку.

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

Чтобы удалить рабочий элемент из участия в будущих сборках и выпусках, удалите ссылку на последний запрос фиксации и извлечения.

Визуализация связанных работ и других объектов. Скачайте расширение визуализации рабочих элементов, доступное на вкладке Visual Studio Marketplace, Azure DevOps.