Az Elemzés panel Power BI-vizualizációkbanThe Analytics pane in Power BI visuals
Az Elemzés panel 2018 novemberében lett bevezetve natív vizualizációkhoz.The Analytics pane was introduced for native visuals in November 2018. Ez a cikk azt ismerteti, hogy hogyan jeleníthetik meg és kezelhetik tulajdonságaikat a Power BI-vizualizációk az API 2.5.0-ás verziójával az Elemzés panelen.This article discusses how Power BI visuals with API v2.5.0 can present and manage their properties in the Analytics pane.
Az Elemzés panel kezeléseManage the Analytics pane
Az Elemzés panel kezelése a tulajdonságok Formátum panelen végzett kezeléséhez hasonlóan, a vizualizáció capabilities.json fájljában definiált objektummal végezhető.Just as you'd manage properties in the Format pane, you manage the Analytics pane by defining an object in the visual's capabilities.json file.
Az Elemzés panel esetében az eltérések a következők:For the Analytics pane, the differences are as follows:
Az objektum definíciója alatt egy objectCategory mezőt is fel kell venni a 2 értékkel.Under the object's definition, you add an objectCategory field with a value of 2.
Megjegyzés
A nem kötelező
objectCategory
mező az API 2.5.0-ás verziójában lett bevezetve.The optionalobjectCategory
field was introduced in API 2.5.0. A vizualizációnak az objektum által vezérelt jellemzőjét határozza meg (1 = Formázás, 2 = Elemzés).It defines the aspect of the visual that the object controls (1 = Formatting, 2 = Analytics). AFormatting
olyan elemekre vonatkozik, mint a megjelenés, a színek, a tengelyek és a címkék.Formatting
is used for such elements as look and feel, colors, axes, and labels. AzAnalytics
előrejelzésekhez, trendvonalakhoz, referenciavonalakhoz, alakzatokhoz és hasonló elemekhez használható.Analytics
is used for such elements as forecasts, trendlines, reference lines, and shapes.Ha az érték nincs megadva, az
objectCategory
alapértelmezett értéke „Formázás”.If the value isn't specified,objectCategory
defaults to "Formatting."Az objektumnak rendelkeznie kell az alábbi két tulajdonsággal:The object must have the following two properties:
- A
show
típusabool
, alapértelmezett értékefalse
.show
of typebool
, with a default value offalse
. - A
displayName
típusatext
.displayName
of typetext
. Ennek az alapértelmezettnek választott értéke lesz a példány kezdeti megjelenítendő neve.The default value that you choose becomes the instance's initial display name.
- A
{
"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
}
}
...
}
}
Más tulajdonságok is a Formátum objektumoknál használt módon határozhatók meg.You can define other properties in the same way that you do for Format objects. Az objektumok enumerálása pontosan úgy végezhető el, ahogyan a Formátum panelen.And you can enumerate objects just as you do in the Format pane.
Az Elemzés panel ismert korlátozásai és problémáiKnown limitations and issues of the Analytics pane
- Az Elemzés panel egyelőre nem támogat több példányt.The Analytics pane has no multi-instance support yet. Az objektumokhoz nem tartozhat más selector, csak statikus (tehát „selector”: null), és a Power BI-vizualizációk nem rendelkezhetnek egy kártya több, felhasználó által definiált példányával.Objects can't have a selector other than static (that is, "selector": null), and Power BI visuals can't have user-defined multiple instances of a card.
- Az
integer
típusú tulajdonságok nem megfelelően jelennek meg.Properties of typeinteger
aren't displayed correctly. Ennek elkerülésére használható anumeric
típus.As a workaround, use typenumeric
instead.
Megjegyzés
- Az Elemzés panelt csak olyan objektumokhoz érdemes használni, amelyek új információkat nyújtanak, vagy új megvilágításba helyezik a megjelenített információt (ilyenek például a fontos trendeket szemléltető dinamikus referenciavonalak).Use the Analytics pane only for objects that add new information or shed new light on the presented information (for example, dynamic reference lines that illustrate important trends).
- A vizualizáció megjelenését szabályozó beállításokat (tehát a formázást) ajánlott a Formátum panelen tartani.Any options that control the look and feel of the visual (that is, formatting) should be limited to the Formatting pane.