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


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

Панель "Аналитика" позволяет добавлять динамические ссылочные строки, такие как min, max или average, в визуальные элементы. Эти строки помогут увеличить масштаб важных тенденций или аналитических сведений. В этой статье описывается создание визуальных элементов Power BI, которые могут представлять динамические ссылочные строки и управлять ими в области аналитики .

Screenshot of the Analytics pane in the Visualizations section.

Примечание.

Область аналитики доступна в API версии 2.5.0. Чтобы узнать, какая версия используется, проверка apiVersion в файле pbiviz.json.

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

Управление свойствами в области "Аналитика" аналогично свойствам управления в области "Формат". Объект определяется в файле capabilities.json визуального элемента.

Для области аналитики объект определяется следующим образом:

В определении объекта добавьте только имя объекта, имя свойства и тип, как описано здесь. Пример:

{
  "objects": {
    "YourAnalyticsPropertiesCard": {
      "properties": {
        "show": {
          "type": {
            "bool": true
          }
        },
        "displayName": {
          "type": {
            "text": true
          }
        },
      ... //any other properties for your Analytics card
      }
    }
  ...
  }
}

В параметрах форматирования карта укажите, что этот карта принадлежит области аналитики, задав set card analyticsPane параметру значение true. По умолчанию параметр имеет значение false, analyticsPane а карта будет добавлен в область форматирования. См. следующие реализации:

class YourAnalyticsCardSettings extends FormattingSettingsCard {
    show = new formattingSettings.ToggleSwitch({
        name: "show",
        displayName: undefined,
        value: false,
        topLevelToggle: true
    });

    displayNameProperty = new formattingSettings.TextInput({
        displayName: "displayName",
        name: "displayName",
        placeholder: "",
        value: "Analytics Instance",
    });

    name: string = "YourAnalyticsPropertiesCard";
    displayName: string = "Your analytics properties card's name";
    analyticsPane: boolean = true; // <===  Add and set analyticsPane variable to true 
    slices = [this.show, this.displayNameProperty];
}

Определите другие свойства так же, как и для объектов Format , и перечислите объекты так же, как и в области "Формат ".

Примечание.

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

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

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

Добавление условного форматирования