Панель аналитики в визуальных элементах Power BI

В области Аналитика вы можете добавить динамические строки ссылок (минимум, максимум, среднее и т. д.) в свои визуальные элементы. Эти строки позволяют подробнее изучить важные тенденции и аналитические сведения. В этой статье описывается создание визуальных элементов Power BI, который может предоставлять динамические строки ссылок и управлять ими на панели Аналитика.

The Analytics pane

Примечание

Панель Аналитика доступна в API начиная с версии 2.5.0. Чтобы узнать, какую версию вы используете, выполните команду pbiviz -V.

Управление панелью "Аналитика"

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

В случае с панелью Аналитика объект определяется следующим образом.

  • В определении объекта добавьте displayName, а в поле objectCategory добавьте значение 2.

    Примечание

    Поле objectCategory определяет аспект визуального элемента, контролируемый объектом (1 = Formatting (Форматирование), 2 = Analytics (Аналитика)). Значение Formatting используется для элементов оформления, цветов, осей и меток. Значение Analytics используется для прогнозов, линий трендов, строк ссылок, фигур и т. д.

    Если значение не указано, поле objectCategory по умолчанию будет иметь значение Formatting.

  • Добавьте в объект следующие два свойства:

    • Свойство show типа bool со значением по умолчанию true.
    • Свойство displayName типа text со значением по умолчанию true.
{
  "objects": {
    "YourAnalyticsPropertiesCard": {
      "displayName": "Your analytics properties card's name",
      "objectCategory": 2,
      "properties": {
        "show": {
          "type": {
            "bool": true
          }
        },
        "displayName": {
          "type": {
            "text": true
          }
        },
      ... //any other properties for your Analytics card
      }
    }
  ...
  }
}

Другие свойства можно определить так же, как и для объектов Формат. Кроме того, вы можете перечислять объекты так же, как и в панели Формат.

Примечание

  • Используйте панель Аналитика только для объектов, которые добавляют новые сведения или раскрывают новые аспекты представленной информации (например, динамические строки ссылок, которые иллюстрируют важные тренды).
  • Все параметры, определяющие внешний вид визуального элемента, например форматирование, должны находиться на панели Форматирование.

Рекомендации и ограничения

  • В панели Аналитика по-прежнему не реализована поддержка нескольких экземпляров. Объекты не могут иметь селектор, отличный от статического (то есть selector: null), а визуальные элементы Power BI не могут иметь определенные пользователем множественные экземпляры карты.
  • Свойства типа integer отображаются неправильно. Чтобы обойти эту проблему, используйте тип numeric.

Next Steps