Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Сервисы Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022
Visual Studio 2022
В этой статье описывается, как получить доступ к рабочим элементам Azure Boards и взаимодействовать с ними, выполняя запросы и предоставляя общий доступ к ним. Вы можете просматривать и запускать встроенные или общие запросы, чтобы определить рабочие элементы, назначенные вам или соответствующие другим критериям.
Подсказка
Вы можете использовать ИИ, чтобы помочь с этой задачей позже в этой статье или ознакомиться с включение помощи ИИ в Azure DevOps MCP Server, чтобы начать работу.
Предварительные условия
- Проект Azure DevOps с рабочими элементами, назначенными вам или отслеживаемыми вами, или запросами, определенными вами или разделенными с вами. Сведения о определении запроса см. в разделе "Определение запроса рабочего элемента".
Примечание.
Пользователи с доступом заинтересованных лиц для общедоступного проекта имеют полный доступ к функциям запросов, как и пользователи с базовым доступом. Дополнительные сведения см. в кратком справочнике по правам доступа для заинтересованных лиц.
| Категория | Требования |
|---|---|
| Уровни доступа | — Для просмотра и выполнения общих запросов: член проекта . — Чтобы добавить и сохранить общий запрос: по крайней мере базовый доступ. |
| Разрешения | Установите разрешение 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-адрес запроса " в контекстном меню.
Вы можете отправлять электронные письма только тем членам проекта, которых система распознает. Отправка в группу групп или группу безопасности не поддерживается. Получатели должны иметь разрешения на чтение почтовых рабочих элементов.
Электронная почта отправляется через почтовый клиент по умолчанию и содержит ссылку на запрос, который возвращает только перечисленные рабочие элементы. Дополнительные сведения см. в разделе "Копирование или клонирование рабочих элементов".
Примечание.
Чтобы отправить по электронной почте форматированный список пользователям, которые не являются участниками проекта, см. статью "Копировать" или отправлять по электронной почте список рабочих элементов.
Примечание.
Для локального Azure DevOps все действия электронной почты требуют настройки сервера Simple Mail Transfer Protocol. Если у вас нет настроенного SMTP-сервера, вы можете обойти это требование с помощью Копировать как HTML, как описано в разделе Копирование или отправка электронной почты списка рабочих элементов.
Просмотр рабочих элементов в Visual Studio
На странице Work Items Visual Studio Team Explorer можно перечислить рабочие элементы для подключенных проектов. Создание запросов и управление ими должно выполняться в веб-интерфейсе Azure Boards.
В области поиска Рабочих элементов можно применить фильтры для просмотра перечисленных рабочих элементов по Назначено, Создано, Состояние или Тип рабочего элемента.
Вы можете развернуть список рабочих элементов и выбрать стрелку рядом с текущим представлением, чтобы выбрать встроенные представления Назначенные мне, Отслеживание, Упомянутые или Мои действия.
Из перечисленных отдельных рабочих элементов вы можете:
- Наведите указатель мыши на рабочий элемент, чтобы отобразить сведения.
- Выберите название рабочего элемента, чтобы переименовать рабочий элемент.
- Щелкните правой кнопкой мыши рабочий элемент, чтобы назначить его себе или завершить рабочий элемент.
- Дважды щелкните элемент или щелкните правой кнопкой мыши и выберите Open, чтобы открыть рабочий элемент в пользовательском интерфейсе Azure Boards.
Вы также можете создать рабочие элементы, выбрав новый рабочий элемент и введя название рабочего элемента. Изменения, внесенные через Visual Studio, отражаются в Azure Boards.
Следующий шаг
Использование ИИ для запроса рабочих элементов
Если у вас есть Azure Boards MCP Server подключен к агенту ИИ в режиме агента, вы можете использовать запросы естественного языка для поиска рабочих элементов без создания формальных запросов.
| Задача | Пример запроса |
|---|---|
| Поиск рабочих элементов | Show all active work items assigned to <me> in my project |
| Запрос по статусу | List all bugs in the Resolved state for the current sprint |
| Поиск по критериям | Find user stories created in the last 7 days that are still in the New state |
| Получение информации о рабочем элементе | Show me the details for work item 1234 including all comments |
| Быстрая командная панель | Show active work items for each team member in the current sprint for <Contoso> with their states |
| Утренний список приоритезации | List all new and unassigned work items in <Contoso> created since yesterday, sorted by priority |
| Сводка по окончании дня | Show work items I updated today in <Contoso> with what changed |
| Определите заблокированные задачи | Find active work items in the current sprint for <Contoso> that are tagged "blocked" or have the word "blocked" in their latest comment |
| Просмотр результатов запроса по типу | Show active work items in <Contoso> grouped by work item type with counts |
| Список готовых к экспорту | List all completed user stories in the current sprint for <Contoso> with ID, title, story points, and closed date |
Примечание.
Режим агента и сервер MCP используют естественный язык, чтобы настроить эти запросы или задать дальнейшие вопросы, чтобы уточнить результаты.