Просмотр результатов запроса Azure DevOps на сайте SharePoint
Введение
Объединение SharePoint Online и Azure DevOps позволяет командам работать с инженерными данными в реальном времени, не покидая среду совместной работы, в которой они уже планируют, документируют и общаются.
В этой статье описана установка и настройка Azure DevOps Query Viewer Web Part в SharePoint Online для отображения результатов запроса Azure DevOps.
Независимо от того, разработчик ли вы, оптимизирующий свой рабочий процесс, или администратор, повышающий эффективность управления проектами команды, это пошаговое руководство поможет вам настроить веб-часть под свои задачи.
Веб-часть Azure DevOps Query Viewer
Веб-часть Azure DevOps Query входит в состав решения My Tasks и доступна начиная с версии 6.x.
📝 Примечание
Чтобы использовать эту веб-часть, убедитесь, что ваше решение My Tasks обновлено до последней версии. Пошаговые инструкции см. в руководстве по обновлению решения.
Предварительные требования
Прежде чем устанавливать и настраивать веб-часть на сайте SharePoint Online, убедитесь, что выполнены следующие предварительные требования:
1. Одобренный доступ к API для решения SharePoint
В вашей среде SharePoint Online должен быть одобрен необходимый доступ к API. Это означает регистрацию решения SharePoint в Entra ID и предоставление ему разрешения вызывать REST API Azure DevOps.
Без этого доступа веб-часть не сможет получать и отображать данные из Azure DevOps.
💡 Совет
Подробные инструкции по установке см. в статье How to Install a Vitextra Product in SharePoint Online.
2. Доступ к организации Azure DevOps
Вам нужен доступ к организации Azure DevOps, которая будет служить источником данных для веб-части. Это означает наличие активной учётной записи Azure DevOps и членство в организации, где хранятся запросы.
Без этого доступа веб-часть не сможет получить нужные ей данные.
📝 Примечание
В пределах SharePoint Online и Azure DevOps решение My Tasks вызывает API и другие службы от имени вошедшего в систему пользователя.
Подробнее о конфиденциальности и защите данных см. в записи Data Protection when using Vitextra Application.
3. Необходимые разрешения на чтение сведений о проектах и запросах
Каждому, кто использует веб-часть, нужны соответствующие разрешения Azure DevOps на чтение проектов и запросов — как правило, как минимум доступ на чтение к проектам и запросам, отображаемым на странице SharePoint.
Убедитесь, что роли пользователей в Azure DevOps предоставляют эти разрешения, чтобы избежать проблем с доступом во время работы.
Добавление веб-части
Когда все предварительные требования выполнены, вы можете добавить веб-часть Azure DevOps Query на сайт SharePoint Online.
Перейдите на страницу, где нужна веб-часть, и нажмите Edit (Изменить). Затем нажмите значок +, чтобы добавить новую веб-часть, — появится список доступных веб-частей.
Найдите в списке веб-часть Azure DevOps Query и выберите её, чтобы добавить на страницу.
После добавления веб-часть покажет уведомление о том, что она ещё не настроена:
Настройте её для отображения нужных результатов запроса.
Настройка веб-части
Нажмите значок Edit web part (карандаш) или кнопку Configure Web Part, чтобы открыть панель настройки.
Источник данных
На панели настройки введите сведения, необходимые для подключения к вашей организации Azure DevOps:
- Organization (Организация) Azure DevOps.
- Project (Проект), результаты запроса которого вы хотите отобразить.
- Конкретный Query (Запрос) для отображения.
Поддерживаемые типы запросов
В настоящее время веб-часть поддерживает только плоские (flat) запросы. Плоский запрос перечисляет рабочие элементы без какой-либо иерархии, поэтому веб-часть показывает простой список рабочих элементов, соответствующих вашим критериям. Древовидные запросы и запросы с прямыми связями — включающие отношения «родитель–потомок» или связанные рабочие элементы — не поддерживаются.
❗ Важно
Веб-часть Azure DevOps Query в настоящее время поддерживает только плоские (flat) запросы.
Параметры отображения
С помощью ползунка Row Limit задайте, сколько рабочих элементов отображается одновременно.
Чтобы включить постраничную навигацию, выберите Display items in batches of the specified size (Отображать элементы порциями заданного размера) и укажите, где будет находиться элемент управления навигацией (сверху, снизу или в обоих местах).
Чтобы отключить постраничную навигацию, выберите Limit the total number of items returned to the specified amount (Ограничить общее количество возвращаемых элементов заданным числом) и введите нужное количество.
Внешний вид
Последний раздел позволяет настроить, как результаты запроса отображаются на вашем сайте SharePoint Online. Два ключевых параметра:
Compact List (Компактный список). Отображает список результатов в более сжатом виде, чтобы вместить больше информации на экране с меньшей прокруткой.
Command Bar (Командная панель). Даёт пользователям быстрый доступ к действиям над отображаемыми результатами, таким как обновление данных и экспорт в Excel.
Результат
После выполнения этих шагов результаты запроса Azure DevOps интегрируются в ваш сайт SharePoint Online. Теперь ваша команда может просматривать данные Azure DevOps в реальном времени прямо в SharePoint, повышая эффективность совместной работы и управления проектами.
Заключение
Веб-часть Azure DevOps Query переносит актуальные результаты запросов из Azure DevOps в SharePoint, так что ваша команда всегда видит самую свежую информацию, не переключаясь между платформами. Благодаря таким возможностям, как компактный режим и командная панель, вы можете адаптировать отображение под свои задачи и дать каждому единое общее представление о задачах и ходе проекта.