Поделиться через


Просмотр, запуск или отправка запроса рабочего элемента

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

Visual Studio 2022 год

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

Предварительные условия

  • Проект Azure DevOps, содержащий рабочие элементы, назначенные вам или которые вы отслеживаете, и запросы, созданные вами или доступные вам. Сведения о определении запроса см. в разделе "Определение запроса рабочего элемента".
Категория Требования
Уровни доступа — Для просмотра и выполнения общих запросов: член проекта .
— Чтобы добавить и сохранить общий запрос: необходим как минимум доступ уровня Basic.
Разрешения Установите разрешение Contribute в состояние Разрешено для папки, в которую вы хотите добавить запрос. По умолчанию у группы участников нет этого разрешения.

Примечание.

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

Категория Требования
Уровни доступа — Для просмотра и выполнения общих запросов: член проекта .
— Чтобы добавить и сохранить общий запрос: по крайней мере базовый доступ.
Разрешения Установите разрешение Contribute в состояние Разрешено для папки, в которую вы хотите добавить запрос. По умолчанию у группы участников нет этого разрешения.

Открытие страницы "Запросы"

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

На вкладке "Избранное" также отображаются последние запросы, которые вы открыли в разделе "Продолжить, где вы остановились".

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

Чтобы просмотреть все личные и общие запросы в проекте, перейдите на вкладку "Все " на странице "Запросы ". На вкладке "Все" отображаются встроенные запросы, заданные вами запросы и запросы, которые используются в проекте. Разверните папки Мои Запросы, Общие Запросы и другие, чтобы открыть их содержимое.

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

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

На вкладке "Все" страницы "Запросы" папка "Мои запросы" содержит следующие встроенные запросы в дополнение к заданным вами запросам:

  • Назначенный мне макрос используется @Me для перечисления всех рабочих элементов, назначенных вам в текущем проекте.
  • Следуемые рабочие элементы используют макрос @Follows в ID@Follows, чтобы перечислить все рабочие элементы, за которыми вы следите. Дополнительные сведения см. в разделе «Подписка на рабочий элемент или pull request».

Поддерживаемые задачи на вкладке "Все" и "Избранное"

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


Задача
Избранное Все
Вывод списка всех избранных запросов, вашей или команды, к которой вы принадлежите ✔️
Перечислите все ваши запросы или общие запросы текущего проекта. ✔️
Добавить запрос в Избранное ✔️
Удалить запрос из избранного ✔️ ✔️
Фильтрация списка запросов ✔️ ✔️
Развернуть или свернуть папки ✔️ ✔️
Запуск запроса или открытие контекстного меню для запроса ✔️ ✔️

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

Фильтрация списка запросов

Введите ключевое слово в поле фильтра на вкладках "Избранное " или " Все " страницы "Запросы ", чтобы отфильтровать отображаемые запросы. Дополнительные сведения см. в разделе «Интерактивная фильтрация невыполненных работ, досок, запросов и планов».

Снимок экрана: все запросы в проекте, отфильтрованные по критериям ключевого слова.

Снимок экрана: все запросы в проекте, отфильтрованные по критериям ключевого слова.

На вкладке "Избранное " или " Все " страницы "Запросы " можно перейти к поиску и открытию определенных запросов.

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

При выборе и открытии папок в верхней части страницы отображаются хлебные крошки.

Снимок экрана хлебных крошек на странице запроса.

Снимок экрана хлебных крошек на странице запроса.

Вы можете выбрать папку в хлебных крошках, чтобы открыть её.

Снимок экрана: пример навигации запросов.

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

Снимок экрана: раскрывающийся список запросов.

Снимок экрана: раскрывающийся список навигации по запросу.

Выполнение запроса

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

Вы также можете выбрать значок "Дополнительные действия " рядом с запросом на странице "Запросы " и выбрать команду "Выполнить запрос " или другие параметры в контекстном меню.

Снимок экрана: контекстное меню запроса на странице

Выполнение запроса из интерфейса командной строки Azure DevOps

Запрос Azure Boards можно выполнить с помощью команды az boards query в интерфейсе командной строки Azure DevOps. Сведения о начале работы см. в статье "Начало работы с Azure DevOps CLI".

az boards query [--id] [--org] [--path] [--project] [--wiql] 

Параметры

  • id: идентификатор существующего запроса. Обязательный, если --path не указан или --wiql не указан.
  • wiql: запрос в формате языка запросов рабочих элементов (WIQL). Игнорируется, если --id или --path указан.
  • path: путь к существующему запросу. Игнорируется, если --id указано.
  • org: URL-адрес организации Azure DevOps, например --org https://dev.azure.com/MyOrganizationName/. Требуется, если не настроено как по умолчанию или выбрано с помощью git config. Настройте организацию по умолчанию с помощью az devops configure -d organization=ORG_URL.
  • project: имя или идентификатор проекта. Требуется, если не настроено в качестве значения по умолчанию или выбрано с помощью git config. Настройте проект по умолчанию с помощью az devops configure -d project=NAME_OR_ID.

Примеры

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

az boards query --id 6c286d74-26a5-4cce-bfcf-bf9123495bfe  --output table

Priority    Node Name         Work Item Type    Title                             Remaining Work
----------  ----------------  ----------------  --------------------------------  ----------------
1           Voice             Bug               Apply fix elsewhere as needed
2           CMMI              Bug               Slow response on form

Следующая команда запускает запрос WIQL и показывает результат в формате таблицы.

az boards query --wiql "SELECT [Microsoft.VSTS.Common.Priority], [System.NodeName], [System.WorkItemType], [System.Title], [Microsoft.VSTS.Scheduling.RemainingWork] FROM workitems WHERE [System.WorkItemType] = 'Bug' AND [System.AreaPath] = 'Fabrikam Fiber' ORDER BY [System.WorkItemType]" --output table

Priority    Node Name       Work Item Type    Title                  Remaining Work
----------  --------------  ----------------  ----------------       ----------------
2           Fabrikam Fiber  Bug               Slow response on form
2           Fabrikam Fiber  Bug               Check permissions

Отправьте запрос по электронной почте или поделитесь им

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

Щелкните значок "Дополнительные действия " в правом верхнем углу, а затем выберите "Запрос электронной почты " или "Копировать URL-адрес запроса " в контекстном меню.

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

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

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

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

Примечание.

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

Примечание.

Для локальной среды Azure DevOps все действия электронной почты требуют настройки сервера simple Mail Transfer Protocol (SMTP). Если у вас нет настроенного SMTP-сервера, вы можете обойти это требование с помощью Копировать как HTML, как описано в разделе Копирование или отправка электронной почты списка рабочих элементов.

Просмотр рабочих элементов в Visual Studio

На странице рабочих элементов Visual Studio Team Explorer можно перечислить рабочие элементы для подключенных проектов. Создание запросов и управление ими должно выполняться в веб-интерфейсе Azure Boards.

В области поиска Рабочих элементов можно применить фильтры для просмотра перечисленных рабочих элементов по Назначено, Создано, Состояние или Тип рабочего элемента.

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

Снимок экрана: страница

Из перечисленных отдельных рабочих элементов вы можете:

  • Наведите указатель мыши на рабочий элемент, чтобы отобразить сведения.
  • Выберите название рабочего элемента, чтобы переименовать рабочий элемент.
  • Щелкните правой кнопкой мыши рабочий элемент, чтобы назначить его себе или завершить рабочий элемент.
  • Дважды щелкните элемент или щелкните правой кнопкой мыши и выберите "Открыть ", чтобы открыть рабочий элемент в пользовательском интерфейсе Azure Boards.

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

Вы также можете создать рабочие элементы, выбрав новый рабочий элемент и введя название рабочего элемента. Изменения, внесенные в Visual Studio, отражаются в Azure Boards.

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