Интеграция системы визуальных элементов Power BI

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

Действия и последующие обновления в Power BI можно инициировать вручную или автоматически. Типы обновлений:

• Взаимодействие с визуальным элементом с помощью Power BI.
• Взаимодействие с визуальным элементом напрямую.
• Визуальное взаимодействие с Power BI.

На следующем рисунке показано, как распространенные визуальные действия, например выбор закладки, процесс в Power BI.

Взаимодействие с визуальным элементом с помощью Power BI

Вы можете обновить визуальный элемент с помощью Power BI следующим образом:

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

  При открытии панели свойств визуального элемента Power BI извлекает поддерживаемые объекты и свойства из файла visual capabilities.json . Чтобы получить фактические значения свойств, Power BI вызывает getFormattingModel метод визуального элемента (API более ранней версии 5.0 enumerateObjectInstances ). API возвращает компоненты модели современной области форматирования, свойства и их фактические значения.

  Дополнительные сведения см. в разделе "Возможности и свойства визуальных элементов Power BI".

• Настройка заголовков визуализаций, фонов, меток и условных обозначений.

  При изменении значения свойства на панели "Формат" Power BI вызывает update метод. Power BI передает новый options объект update методу, а объекты содержат новые значения.

  Дополнительные сведения см. в разделе "Объекты и свойства визуальных элементов Power BI".

• Изменение размера визуального элемента.

  При изменении размера визуального элемента Power BI вызывает update метод и передает новый options объект. Объекты options имеют вложенные viewport объекты, содержащие новую ширину и высоту визуального элемента.

• Применение фильтра на уровне отчета, страницы или визуального элемента.

  Power BI фильтрует данные на основе условий фильтрации. Power BI вызывает update метод визуального элемента для обновления визуального элемента новыми данными.

  Визуальный элемент получает новое обновление options объектов при наличии новых данных в одном из вложенных объектов. Как происходит обновление, зависит от конфигурации сопоставления представления данных визуального элемента.

  Дополнительные сведения см. в разделе "Общие сведения о сопоставлении представлений данных" в визуальных элементах Power BI.

• Выберите точку данных в другом визуальном элементе отчета.

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

  Дополнительные сведения см. в разделе "Выделение точек данных" в визуальных элементах Power BI.

• Выберите закладку на панели закладок отчета.

  При выборе закладки на панели "Закладки " либо:

  • Power BI вызывает функцию, переданную и зарегистрированную методом registerOnSelectionCallback . Функция обратного вызова получает массивы выделений для соответствующей закладки.

  • Power BI вызывает update метод с соответствующим filter объектом внутри options объекта.

    В обоих случаях визуальный элемент изменяет состояние в соответствии с полученными выделенными фрагментами или filter объектом.

    Дополнительные сведения о закладках и фильтрах см. в разделе API визуальных фильтров в визуальных элементах Power BI.

Взаимодействие с визуальным элементом напрямую

Вы также можете взаимодействовать непосредственно с визуальным элементом, чтобы обновить его:

• Наведите указатель мыши на элемент данных.

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

  Дополнительные сведения см. в разделе "Добавление подсказок" в визуальные элементы Power BI.

• Изменение визуальных свойств (например, путем расширения дерева) и визуального элемента сохраняет новое состояние в визуальных свойствах.

  Визуальный элемент может сохранять значения свойств через API Power BI. Например, при взаимодействии с визуальным элементом и визуальным элементом необходимо сохранить или обновить значения свойств, визуальный элемент может вызвать persistProperties метод.

• Выберите URL-адрес.

  По умолчанию визуальный элемент не может открыть URL-адрес напрямую. Чтобы открыть URL-адрес на новой вкладке, визуальный элемент может вызвать launchUrl метод и передать URL-адрес в качестве параметра.

  Дополнительные сведения см. в разделе "Создание URL-адреса запуска".

• Применение фильтра через визуальный элемент.

  Визуальный applyJsonFilter элемент может вызывать метод и передавать условия для фильтрации данных в других визуальных элементах. Доступны несколько типов фильтров, включая фильтры "Базовый", "Расширенный" и "Кортеж".

  Дополнительные сведения см. в разделе API визуальных фильтров в визуальных элементах Power BI.

• Выберите элементы в визуальном элементе.

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

Визуальный элемент взаимодействует с Power BI

Иногда визуальный элемент инициирует взаимодействие с узлом Power BI без каких-либо входных данных:

• Визуальный элемент запрашивает больше данных из Power BI.

  Визуальный элемент обрабатывает данные по части. Метод fetchMoreData API запрашивает следующий фрагмент данных в семантической модели.

  Дополнительные сведения см. в статье "Получение дополнительных данных из Power BI".

• Триггеры службы событий.

  Power BI может экспортировать отчет в PDF-файл или отправить отчет по электронной почте (применяется только к сертифицированным визуальным элементам). Чтобы уведомить Power BI о завершении отрисовки и готовности визуального элемента к захвату в формате PDF или электронной почты, визуальный элемент должен вызвать API событий отрисовки.

  Дополнительные сведения см. в статье "Экспорт отчетов из Power BI в PDF".

  Дополнительные сведения о службе событий см. в разделе "Отрисовка" в визуальных элементах Power BI.

Связанный контент

Заинтересованы в создании визуализаций и их добавлении в Microsoft AppSource? См. следующие статьи:

• Визуальный API
• Разработка визуального элемента карта круга Power BI
• Публикация визуальных элементов Power BI в коммерческой платформе Майкрософт