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

Создание отчетов Power BI для отображения данных Dynamics 365 Business Central

  • Статья

Вы можете сделать свои данные Dynamics 365 Business Central доступными в качестве источника данных в Power BI Desktop и создавать мощные отчеты о состоянии вашего бизнеса.

В этой статье рассказывается, как начать использовать Power BI Desktop для создания отчетов, отображающих данные Dynamics 365 Business Central. После создания отчетов вы можете опубликовать их в своей службе Power BI или поделиться ими со всеми пользователями в вашей организации. Как только эти отчеты будут в службе Power BI, пользователи, которые имеют к ней доступ, смогут просматривать отчеты в Dynamics 365 Business Central.

Подготовка

Заметка

С помощью веб-служб OData можно было получить данные из разных организаций в одном отчете. Однако начиная с Business Central волны 2 выпуска 2021 г. поддерживается только ODataV4. ODataV4 не экспортирует данные из нескольких организаций. Функция $expand Power BI, которую вы, возможно, считали альтернативным способом создания отчета по нескольким организациям, также не может быть использована. Она создает столбец с названием организации, но не заполняет его данными организации после обновления.

Добавление Business Central в качестве источника данных в Power BI Desktop

Первая задача при создании отчетов — добавить Business Central как источник данных в Power BI Desktop. После подключения вы можете приступить к созданию отчета.

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

  2. Выберите Получить данные.

    Если вы не видите пункт Получить данные, выберите меню Файл, затем Получить данные.

  3. На странице Получить данные выберите Веб-службы.

  4. В области Веб-службы выполните одно из следующих действий:

    • Чтобы подключиться к Business Central Online, выберите Dynamics 365 Business Central, затем Подключить.

  5. Выполните вход в Business Central (только один раз).

    Если вы еще не вошли в Business Central из Power BI Desktop, вам будет предложено выполнить вход.

    • Для Business Central Online выберите Войти, затем выберите соответствующую учетную запись. Используйте ту же учетную запись, которую вы используете для входа в Business Central. Когда готово, выберите Подключить.

    Заметка

    После подключения к Business Central входить в систему больше будет не нужно. Как изменить или удалить учетную запись, которую я сейчас использую для подключения к Business Central из Power BI Desktop?

  6. После подключения Power BI связывается со службой Business Central. Появляется окно Навигатор, в котором отображаются доступные источники данных для построения отчетов. Выберите какую-либо папку, чтобы развернуть ее и просмотреть доступные источники данных.

    Эти источники данных представляют все веб-службы и API, которые опубликованы для Business Central, сгруппированные по средам и организациям. С Business Central Online Навигатор имеет следующую структуру:

    • Имя среды
      • Название организации

        • Расширенные API

          В этой папке перечислены расширенные API, опубликованные Microsoft, например API автоматизации Business Central и API, опубликованные другими организациями (эти API называются пользовательскими API). Пользовательские API далее сгруппированы по папкам по свойствам APIPublisher/APIGroup исходного кода API.

        • Стандартные API v2.0

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

        • Веб-службы (устаревшие версии)

          В этой папке перечислены страницы, модули codeunit и запросы, опубликованные как веб-службы в Business Central. Не рекомендуется использовать этот устаревший метод для чтения данных из Business Central. Вместо этого мы рекомендуем использовать API.

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

  8. Если позже вы захотите добавить дополнительные данные Business Central, вы можете повторить предыдущие шаги.

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

Чаевые

Дополнительные сведения об использовании Power BI Desktop см. в разделе Начало работы с Power BI Desktop.

Создание доступных отчетов

Важно, чтобы ваши отчеты были доступны как можно большему количеству людей. Постарайтесь создавать отчеты так, чтобы они не требовали специальной адаптации для удовлетворения конкретных потребностей разных пользователей. Убедитесь, что дизайн позволяет пользователям использовать технологии специальных возможностей, например программы чтения с экрана. Power BI включает различные специальные возможности, инструменты и рекомендации, которые помогут. Чтобы узнать больше, перейдите в Разработка отчетов Power BI с учетом специальных возможностей в документации Power BI.

Создание отчетов для отображения данных, связанных со списком в Business Central

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

Использование темы отчета Business Central (необязательно)

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

Заметка

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

Скачивание темы

Файл темы доступен как файл json в коллекции тем сообщества Microsoft Power BI. Чтобы скачать файл темы, выполните следующие действия:

  1. Перейдите в Коллекцию тем сообщества Microsoft Power BI для Microsoft Dynamics 365 Business Central.
  2. Выберите скачивание вложения Microsoft Dynamics Business Central.json.

Импорт темы в отчет

После того, как вы скачали тему отчета Business Central, вы можете импортировать ее в свои отчеты. Чтобы импортировать тему, выберите Представление>Темы>Поиск тем. Подробнее см. в разделе Power BI Desktop — импорт пользовательских тем отчетов.

Публикация отчетов

После того как вы создали или изменили отчет, вы можете опубликовать его в своей службе Power BI, а также передать его другим пользователям в своей организации. После публикации отчета он будет доступна в Business Central. Отчет также становится доступным для выбора в Business Central.

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

Распространение отчета или предоставление доступа к нему

Существует несколько способов делиться отчетами:

  • Предоставление доступа к отчету из вашей службы Power BI (рекомендуется)

    Если у вас есть лицензия Power BI PRO или используется Power BI Premium, вы можете поделиться отчетом прямо из своей службы Power BI. Чтобы узнать больше, перейдите к Power BI — как поделиться панелью мониторинга или отчетом.

  • Распространяйте отчеты в виде файлов .pbix.

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

    Заметка

    Распространение отчетов таким образом означает, что обновление данных для отчетов выполняется каждым пользователем индивидуально. Эта ситуация может повлиять на производительность Business Central.

Как разрабатывать отчеты Power BI, охватывающие несколько организаций или сред

Все конечные точки API Business Central имеют префикс https://api.businesscentral.dynamics.com/v2.0/<environment_name>/api/v2.0, после которого идет /companies({company_id})/accounts({id}) (здесь мы используем API accounts в качестве иллюстрации). Вы можете использовать эту структуру для создания запросов PowerQuery, которые загружают данные для нескольких организаций или нескольких сред, если у пользователя, читающего данные, есть к ним доступ.

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

  1. Возьмите запрос PowerQuery, который загружает данные для одной организации. Преобразуйте его в пользовательскую функцию Power Query, которая принимает идентификатор организации (или, возможно, имя среды) в качестве параметров. Подробнее см. в статье Использование пользовательских функций Power Query.
  2. Теперь используйте эту новую пользовательскую функцию в запросе PowerQuery, где вам нужно будет сопоставить эту функцию со списком компаний, а затем объединить наборы данных с помощью функции Power Query Table.Combine.

Дополнительно: настройка языка, времени ожидания, реплики базы данных или размера страницы для источника данных Business Central

Соединитель Power BI для Business Central поддерживает несколько дополнительных свойств для подключения к источнику данных Business Central, который вы можете задавать в своих запросах Power Query. В следующей таблице приводится описание параметров.

Параметр Описанием По умолч. Дополнительные сведения см. на странице
AcceptLanguage Этот параметр позволяет указать предпочитаемые языки для ответов, гарантируя, что пользователи будут получать сообщения и переводимые строки на желаемом ими языке. Он задает язык, на котором выполняется сеанс API в Business Central. Он влияет на язык сообщений об ошибках, форматированные значения в AL и другие значения, зависящие от языка или языка и региональных параметров.

Установка этого параметра повышает удовлетворенность пользователей и делает данные более доступными и релевантными.		 не указано Использование значений языковых стандартов в многоязычных отчетах Power BI.
ODataMaxPageSize Этот параметр ограничивает количество сущностей на странице результатов, что обеспечивает большую гибкость при подключении к большим наборам данных или использовании сложных запросов. Он устанавливает максимальное количество записей, возвращаемых для каждой страницы при вызове API. Например, если таблица Клиенты содержит 13 000 записей и для параметра ODataMaxPageSize задано значение 5000, Power BI выполняет 3 вызова API для получения клиентов. Первый вызов получает 5000 записей, следующий — еще 5000, а последний — оставшиеся 3000. Этот параметр не может превышать максимальный размер страницы, применяемый Business Central, который составляет 20 000.

Настройка этого параметра обеспечивает эффективный и отзывчивый поиск данных, что позволяет быстрее получать информацию и принимать решения. Вы не можете превышать максимальный размер страницы, определенный в службе.		 5000 Свойство ODataPreferenceHeader.MaxPageSize
Время ожидания Этот параметр определяет максимальную продолжительность запроса перед отменой. Он устанавливает время ожидания для каждого отдельного вызова API к Business Central. Его значение не может превышать время ожидания, применяемое к службе Business Central, которое в настоящее время составляет 10 минут (00:10:00).

Настройка этого параметра помогает эффективно управлять системными ресурсами и предотвращает влияние длительных запросов на общую производительность системы. Пользователи сталкиваются с минимальными задержками и перерывами, что обеспечивает более плавный рабочий процесс.		 00:08:00 OData.Feed
UseReadOnlyReplica Этот параметр определяет, будут ли запросы нацелены на первичную базу данных или на реплику, доступную только для чтения. Разгрузка операций чтения из основной базы данных может значительно повысить производительность.

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

Настройка дополнительных параметров

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

  2. Выполните шаг, соответствующий вашему сценарию:

    1. Выберите Файл>Открыть.
    2. Найдите и выберите отчет (.pbix).
    3. На ленте выберите Преобразовать данные, чтобы открыть Редактор Power Query.

  1. В редакторе Power Query выберите Расширенный редактор на ленте.

  2. В Расширенном редакторе найдите строку, которая начинается с Source =:

    Source = Dynamics365BusinessCentral.ApiContentsWithOptions(null, null, null, null),

  3. В строке замените четвертый параметр Dynamics365BusinessCentral.ApiContentsWithOptions с разделенным запятыми списком свойств и значений, которые вы хотите задать, например:

    Source = Dynamics365BusinessCentral.ApiContentsWithOptions(null, null, null, Dynamics365BusinessCentral.ApiContentsWithOptions(null, null, null, [UseReadOnlyReplica = true, Timeout = Duration.From("00:07:00"), ODataMaxPageSize = 10000, AcceptLanguage = "it-it"])

  4. Нажмите Готово, чтобы закрыть расширенный редактор.

  5. Выберите Закрыть и применить, чтобы сохранить изменения и закрыть редактор Power Query.

Устранение проблем

Ошибка "Expression.Error: "Рабочая" среда не существует" при указании среды Business Central

ПРИМЕНЯЕТСЯ К: Business Central Online

При подключении к Business Central Online из Business Central или Power BI при установке приложения Power BI Desktop из него Microsoft AppSource , использующего данные Business Central, вам может быть предложено ввести имя среды Business Central, к которой вы хотите подключиться.

Если вы получаете сообщение об ошибке типа "Expression.Error: "Рабочая" среда не существует", выполните следующие действия, чтобы устранить неполадку:

  1. Убедитесь, что вы используете нужные учетные данные для доступа к Business Central. Эти учетные данные могут не совпадать с учетными данными, используемыми для доступа к Power BI. Как изменить или удалить учетную запись, которую я сейчас использую для подключения к Business Central из Power BI Desktop?
  2. Если среда является средой внедрения независимых поставщиков программного обеспечения, необходимо указать имя внедренного независимого поставщика программного обеспечения в скобках как часть имени среды. Например, если вы хотите подключиться к среде с именем «Рабочая» из встраиваемого независимого поставщика программного обеспечения с именем Fabrikam, необходимо указать «Рабочая (fabrikam)» в качестве имени среды.

«Невозможно вставить запись. Текущее намерение подключения — «Только для чтения». Ошибка при подключении к пользовательской странице API

ПРИМЕНЯЕТСЯ К: Business Central Online

По умолчанию, отчеты, использующие данные Business Central подключаются к доступной только для чтения реплике базы данных Business Central. В редких случаях, в зависимости от дизайна API, вы будете видеть сообщение об ошибке при попытке подключения и получения данных со API. Ошибка выглядит следующим образом:

Dynamics365BusinessCentral: Request failed: The remote server returned an error: (400) Bad Request. (Can't insert a record. Current connection intent is Read-Only. CorrelationId: [...])".

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

Включение бизнес-данных для Power BI
Бизнес-аналитика
Подготовка к ведению бизнеса
Импорт бизнес-данных из других финансовых систем
Настройка Business Central
Финансы
Быстрый старт: подключение к данным в Power BI Desktop

Бесплатные модули электронного обучения для Business Central можно найти здесь