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


Подключение аналитики с помощью соединителя данных Power BI

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

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

Внимание

Аналитические представления поддерживают только данные Azure Boards (рабочие элементы). Представления аналитики не поддерживают другие типы данных, такие как конвейеры. Представления предоставляют неструктурированный список рабочих элементов и не поддерживают иерархии рабочих элементов. На этом этапе у нас нет планов обновить соединитель для поддержки других типов данных. Дополнительные сведения о других подходах см. в разделе "Сведения об интеграции Power BI".

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

  • Ознакомьтесь с тем, что такое аналитика и база знаний статей Power BI.
  • Установите обновление Power BI Desktop за октябрь 2018 г. или более новую версию.
  • Убедитесь, что вы являетесь членом проекта по крайней мере базовым доступом. Если у вас еще нет проекта, создайте его.
  • Убедитесь, что вы являетесь членом проекта. Если вы этого не сделали, добавьте его сейчас. Любой пользователь с доступом к проекту, кроме заинтересованных лиц, может просматривать аналитические представления.
  • Убедитесь, что аналитика установлена, а если нет, включите ее. Для добавления расширений или включения службы необходимо быть владельцем учетной записи или членом группы администраторов коллекции проектов.
  • Убедитесь, что доски включены. Если нет, представления аналитики не отображаются. Сведения о повторной сборке досок см. в статье "Включение и отключение службы Azure DevOps".
  • Убедитесь, что у вас есть разрешения, необходимые для доступа к Аналитике. Если вы являетесь членом группы участников проекта, у вас есть разрешение.
  • Создайте представление аналитики, для которого необходимо создать отчет Power BI.

Внимание

Azure DevOps не поддерживает проверку подлинности альтернативных учетных данных. Если вы по-прежнему используете альтернативные учетные данные, мы настоятельно рекомендуем переключиться на более безопасный метод проверки подлинности.

Подключение к представлению Аналитики

  1. Запустите Power BI Desktop.

  2. Войдите в службу. Для первого доступа требуется выполнить вход и пройти проверку подлинности учетных данных. Power BI Desktop сохраняет свои учетные данные, поэтому это необходимо сделать только один раз.

    Примечание.

    Azure DevOps не поддерживает сценарии между клиентами с помощью OAuth. Вместо этого используйте субъекты-службы и управляемые удостоверения.

  3. Выберите "Подключиться " при проверке учетных данных.

    Снимок экрана: диалоговое окно подключения Power BI.

  4. Выберите "Получить веб-службы данных>", а затем выберите Azure DevOps (только доски) для облачных служб или выберите Azure DevOps Server (только boards) для локальной среды. Нажмите Подключиться. Аналитические представления поддерживают только запросы к рабочим элементам и тестовых случаях.

    Снимок экрана: поток получения данных.

  5. Укажите основные параметры для подключения к данным.

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

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

    • URL-адрес коллекции: введите URL-адрес, в котором размещен экземпляр сервера Azure DevOps. Пример URL-адреса.http://fabrikam-server/AzureDevOpsServer/fabrikam-collection
    • Командный проект: введите только имя проекта. Например, используйте Fabrikam-Fibre , если URL-адрес экземпляра http://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-FiberСервера Azure DevOps.

    Внимание

    Не путайте имя команды с именем проекта, что является распространенной ошибкой. Например, если используется http://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber-Git/DeviceURL-адрес, то Fabrikam-Fibre-Git — это имя проекта, а устройство — имя команды.

    После успешного входа Power BI проверяет, имеют ли учетные данные пользователя разрешения на доступ к указанному проекту. Если возникают ошибки, ознакомьтесь с часто задаваемыми вопросами о решениях наиболее распространенных проблем.

Выберите представление "Аналитика"

  1. Разверните папку "Общие представления" , выберите представление "Аналитика" и выберите " Загрузить". Соединитель данных представляет список доступных представлений Аналитики. Каждое представление представляет набор данных, которые можно извлечь в Power BI. Вы также можете создавать пользовательские представления аналитики.

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

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

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

    Примечание.

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

  2. Выберите представление.

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

    Примечание.

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

    • Выберите рабочую таблицу — текущую таблицу и дождитесь загрузки предварительного просмотра. Он представляет текущее состояние всех рабочих элементов проекта.
    • Установите флажок рядом с таблицей "Рабочие элементы" и выберите "Загрузить".

    Примечание.

    Представления аналитики не применяют фильтры, определенные с помощью Power BI на сервере. Все фильтры, применяемые в Power BI, ограничивают данные, отображаемые конечным пользователям, но не сокращают объем данных, полученных из аналитики. Если фильтр предназначен для уменьшения размера набора данных, примените его , настроив представление.

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

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

  4. Просмотрите модель данных. Пока модель загружается, просмотрите проект набора данных для соединителя данных Power BI.

Создание отчета

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

Снимок экрана: представление отчета Power BI Desktop.

Вопросы и ответы

Найдите ответы на распространенные вопросы об ошибках Соединителя данных Power BI и аналитики.

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

Ответ. Может возникнуть проблема с чтением сообщений об ошибках, поступающих из соединителя, так как они обычно содержат дополнительные контекстные сведения. Если операция загрузки завершается ошибкой, сообщение начинается с "Не удалось сохранить изменения на сервере...". Когда вы видите его, выполните поиск по запросу [DataSource.Error] Azure DevOps...:. В следующем примере показано сообщение об ошибке, возвращенное соединителем. Наиболее важной частью сообщения об ошибке является "Результат запроса превышает максимальный размер. Уменьшите количество записей, применяя дополнительные фильтры".

Снимок экрана: результат запроса превышает сообщение об ошибке максимального размера.

Вопрос: Разделы справки разрешить "Результат запроса превышает максимальный размер. Уменьшите количество записей, применяя дополнительные фильтры"?

Ответ. Вы получите следующую ошибку, если количество записей, полученных из Аналитики, превышает 250 000:

"Не удалось сохранить изменения на сервере. Возвращена ошибка: "Ошибка OLE DB или ODBC: [DataSource.Error] VSTS: запрос завершился ошибкой: удаленный сервер вернул ошибку: (400) Недопустимый запрос. (Результат запроса превышает максимальный размер. Уменьшите количество записей, применяя дополнительные фильтры)."

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

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

Вопрос: Разделы справки устранить ошибку "пользователь не был авторизован"?

Ответ. Эта ошибка может возникнуть, если вы пытаетесь получить доступ к проекту, которому у вас нет разрешений. Вы также можете увидеть, если Power BI не распознает учетные данные. Сведения о проверке разрешений см. в разделе "Настройка разрешений для доступа к представлениям аналитики и аналитики". Если это проблема с учетными данными, обратитесь к администратору, чтобы узнать, может ли он устранить проблему. Дополнительные сведения см. в статье о безопасности Power BI, проверке подлинности пользователей и устранении неполадок при входе в Power BI.

Снимок экрана, на котором показана ошибка отказа в доступе.

Примечание.

Power BI использует идентификатор Microsoft Entra для проверки подлинности пользователей, которые входят в служба Power BI, и, в свою очередь, используют учетные данные входа в Power BI, когда пользователь пытается получить доступ к ресурсам, требующим проверки подлинности. Пользователи войдите в служба Power BI с помощью адреса электронной почты, используемого для установки учетной записи Power BI. Power BI использует это сообщение электронной почты входа в качестве эффективного имени пользователя, которое передается ресурсам всякий раз, когда пользователь пытается подключиться к данным. Затем эффективное имя пользователя сопоставляется с именем субъекта-пользователя и разрешается с связанной учетной записью домена Windows, к которой применяется проверка подлинности.

Вопрос: Разделы справки устранить ошибку "Доступ к ресурсу запрещено"?

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

Снимок экрана: сообщение об ошибке

Вопрос. Разделы справки устранить ошибку "Проект "X" не существует или у вас нет разрешений на доступ к ней?

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

Например, если используется https://dev.azure.com/fabrikam-fiber-inc/Fabrikam-Fiber-Git/DeviceURL-адрес, то Fabrikam-Fibre-Git — это имя проекта, и его следует использовать в параметре. Устройство — это имя команды.

Снимок экрана: ошибка Project не найдена.