Skrytí nebo zobrazení záhlaví vizuálů
Sestavy Power BI, které vkládáte do aplikací, obsahují vizuály, jako jsou grafy, heat mapy a měřidla. Tyto vizuály mají hlavičky, které uživatelům zpřístupní akce. Když používáte Power BI, můžete skrýt nebo zobrazit záhlaví každého vizuálu v sestavě. Každý vizuál má kartu v oddílu Formátování podokna Vizualizace s názvem záhlaví vizuálu. Tuto kartu můžete použít k zapnutí a vypnutí záhlaví vizuálu. Přečtěte si další informace o záhlavích vizuálů v záhlavích vizuálů.
Mezi příklady akcí v záhlaví vizuálů patří:
- Otevření vizuálu v detailním režimu
- Procházení k podrobnostem nebo nahoru
- Zobrazení, které filtry a průřezy jsou aktuálně použity pro vizuál.
- Otevření nabídky možností vizuálu
Někdy je užitečné tyto akce skrýt. Pokud se například dva vizuály překrývají, možná nebudete chtít zobrazit záhlaví obou vizuálů.
Toto rozhraní API poskytuje způsob, jak skrýt nebo zobrazit záhlaví všech vizuálů v sestavě nebo jenom konkrétní vizuály. Můžete nakonfigurovat viditelnost při načítání sestavy nebo můžete volat metodu updateSettings
sestavy, která změní viditelnost po načtení sestavy, viz Aktualizovat nastavení sestavy za běhu.
Rozhraní API můžete použít v mnoha scénářích, včetně následujících případů použití:
- Skrytí pouze některých záhlaví vizuálů v sestavě
- Pomocí obchodní logiky v aplikaci, například kliknutím na tlačítko, skryjte nebo zobrazte záhlaví po načtení sestavy.
Skrytí nebo zobrazení záhlaví vizuálů
Pokud chcete v rozhraní API skrýt nebo zobrazit záhlaví vizuálů, nakonfigurujete určité parametry v nastavení sestavy. Obecné informace o konfiguraci možností v vložených sestav najdete v tématu Konfigurace nastavení sestavy.
Nastavení záhlaví vizuálu
U záhlaví vizuálů je viditelnost aktuálně jediným nastavením, které můžete nakonfigurovat. Chcete-li skrýt nebo zobrazit záhlaví, zadejte seznam objektů konfigurace záhlaví vizuálu. Každý z nich obsahuje objekt nastavení a může obsahovat také selektor. selektory identifikují vizuály, na které nastavení používáte. Přečtěte si další informace o selektorech v selektorech.
Typ objektu konfigurace, který poskytnete rozhraní API, je IVisualSettings. Dále v tomto článku najdete příklady, které ukazují, jak toto rozhraní používat ve vašem kódu. modely Power BI zobrazí seznam všech definic rozhraní, které příklady používají.
Všimněte si následujících bodů:
- Selektor je v těchto nastaveních volitelný. Pokud nevypíšete žádné selektory, rozhraní API použije vaše nastavení pro všechny vizuály v sestavě.
- Při použití selektorů můžete zadat vizuály buď podle názvu, nebo podle typu. Pokud chcete na dané stránce získat názvy a typy vizuálů, použijte metodu Page getVisuals.
Pravidla priority
Rozhraní API použije nastavení konfigurace v následujícím pořadí:
- Nastavení uložená v sestavě
- Nastavení, která definujete v objektu konfigurace pro vložení, které rozhraní API použije při zatížení.
- Nastavení, která poskytnete rozhraní API
updateSettings
Pokud u vizuálu může platit více než jedno nastavení, použije rozhraní API poslední nastavení, které platí. Tento bod ukazuje Skrýt všechny kromě jednoho záhlaví vizuálu příklad v další části.
Příklady
Tyto příklady ukazují různé způsoby použití rozhraní API ke skrytí nebo zobrazení záhlaví vizuálů.
Skrytí všech záhlaví vizuálů
Tento jednoduchý scénář poskytuje zákazníkům čisté zobrazení sestavy skrytím všech záhlaví vizuálů v sestavě:
let embedConfig = {
...
settings: {
...
visualSettings: {
visualHeaders: [
{
settings: {
visible: false
}
/* No selector is listed. The API hides the headers of all the visuals in the report. */
}
]
}
}
};
...
let report = powerbi.embed(embedContainer, embedConfig);
Skrytí záhlaví konkrétního vizuálu
Tento příklad používá selektor k použití nastavení viditelnosti u jednoho vizuálu. Tento scénář nastane, když chcete skrýt funkce, které nedává smysl pro vizuál. V takovém případě použijte tento kód:
let embedConfig = {
...
settings: {
...
visualSettings: {
visualHeaders: [
{
settings: {
visible: false
},
selector: {
$schema: "http://powerbi.com/product/schema#visualSelector",
visualName: <The name of the visual> // You can retrieve the name by using getVisuals.
}
}
]
}
}
};
...
let report = powerbi.embed(embedContainer, embedConfig);
Skrytí záhlaví všech vizuálů kromě jednoho vizuálu
Tento kód slouží ke skrytí všech záhlaví vizuálů v sestavě s výjimkou hlavičky konkrétního vizuálu:
let embedConfig = {
...
settings: {
...
visualSettings: {
visualHeaders: [
{
settings: {
visible: false
}
/* No selector is listed. The API hides the headers of all the visuals in the report. */
},
{
settings: {
visible: true
},
selector: {
$schema: "http://powerbi.com/product/schema#visualSelector",
visualName: <The name of the visual> // You can retrieve the name by using getVisuals.
}
}
]
}
}
};
...
let report = powerbi.embed(embedContainer, embedConfig);
Pokud chcete zobrazit více než jednu hlavičku, můžete tento kód rozšířit. Nastavte další instance IVisualHeader
s parametrem visible
v settings
nastaveným na true
. Pro každý vizuál, který by měl mít viditelné záhlaví, přidejte do seznamu jednu instanci IVisualHeader
.
Důležité informace a omezení
- Viditelnost záhlaví vizuálů můžete řídit pouze v případě, že sestava, kterou vložíte, je v režimu zobrazení.
- Můžete jenom skrýt nebo zobrazit celé záhlaví vizuálu. Viditelnost konkrétních položek v nabídce záhlaví není možné konfigurovat.
- Pokud k zadání názvu nebo typu vizuálu použijete selektor, použijte metodu Page getVisuals k získání názvu vizuálu, což je jedinečný identifikátor. Nekonfigurujte selektor s názvem vizuálu.
- Pokud uživatel uloží sestavu, kterou vložíte do rozhraní API, uloží se do sestavy nastavení vizuálu, které jste definovali. Této situaci se můžete vyhnout konfigurací sestavy s úrovní oprávnění
View
místoEdit
neboSave
.