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