Sdílet prostřednictvím

Integrace systému vizuálů Power BI

  • Článek

Tento článek popisuje rozhraní VISUAL API a způsob, jakým Power BI zpracovává interakce mezi vámi, vizuálem a hostitelem.

Akce a následné aktualizace v Power BI je možné spustit ručně nebo automaticky. Typy aktualizací:

Následující obrázek ukazuje, jak běžné akce založené na vizuálu, jako je například výběr záložky, probíhají v Power BI.

Diagram vizuálního procesu Power BI

Interakce s vizuálem prostřednictvím Power BI

Vizuál můžete pomocí Power BI aktualizovat následujícím způsobem:

  • Otevřete panel vlastností vizuálu.

    Když otevřete panel vlastností vizuálu, Power BI načte podporované objekty a vlastnosti ze souboru capabilities.json vizuálu. Pokud chcete přijímat skutečné hodnoty vlastností, Power BI volá metodu vizuálu getFormattingModel (u rozhraní API starších než verze 5.0 je volána enumerateObjectInstances). Rozhraní API vrátí součásti modelu formátovacího panelu, jejich vlastnosti a skutečné hodnoty.

    Další informace najdete v tématu Možnosti a vlastnosti vizuálů Power BI.

  • Přizpůsobte si názvy vizualizací, pozadí, popisky a legendy.

    Když změníte hodnotu vlastnosti na panelu Formát, Power BI volá metodu update . Power BI předá do metody nový options objekt update a objekty obsahují nové hodnoty.

    Další informace najdete v tématu Objekty a vlastnosti vizuálů Power BI.

  • Změňte velikost vizuálu.

    Když změníte velikost vizuálu, Power BI zavolá metodu update a předá nový objekt options. Objekty options mají vnořené viewport objekty, které obsahují novou šířku a výšku vizuálu.

  • Použijte filtr na úrovni sestavy, stránky nebo vizuálu.

    Power BI filtruje data na základě podmínek filtru. Power BI volá update metodu vizuálu, která vizuál aktualizuje novými daty.

    Vizuál získá novou aktualizaci options objektů, když v jednom z vnořených objektů existují nová data. Způsob provedení aktualizace závisí na konfiguraci mapování zobrazení dat u vizuálu.

    Další informace najdete v tématu Principy mapování zobrazení dat ve vizuálech Power BI.

  • Vyberte datový bod v jiném vizuálu v sestavě.

    Když v sestavě vyberete datový bod v jiném vizuálu, Power BI filtruje nebo zvýrazňuje vybrané datové body a zavolá metodu vizualizace update. Vizuál získá nová filtrovaná data nebo získá stejná data s polem zvýraznění.

    Další informace najdete v tématu Zvýraznění datových bodů ve vizuálech Power BI.

  • Vyberte záložku na panelu Záložky.

    Když na panelu Záložky vyberete záložku, můžete:

    • Power BI volá funkci, která je předána a zaregistrována metodou registerOnSelectionCallback . Funkce zpětného volání získá pole výběrů pro odpovídající záložku.

    • Power BI volá metodu update s odpovídajícím filter objektem uvnitř objektu options .

      V obou případech vizuál změní svůj stav podle přijatých výběrů nebo filter objektu.

      Další informace o záložkách a filtrech najdete v tématu Rozhraní API vizuálních filtrů ve vizuálech Power BI.

Přímé interakce s vizuálem

Můžete také pracovat přímo s vizuálem a aktualizovat ho:

  • Najeďte myší na datový prvek.

    Vizuál může zobrazit další informace o datovém bodu prostřednictvím Power BI Tooltips API. Když najedete myší na prvek vizuálu, může vizuál zpracovat událost a zobrazit data o přidruženém prvku popisu. Vizuál může zobrazit buď standardní popisek, nebo popisek stránky sestavy.

    Další informace najdete v Přidání nápověd do vizuálů Power BI.

  • Změňte vlastnosti vizuálu (například rozbalením stromu) a vizuál uloží nový stav do vlastností vizuálu.

    Vizuál může ukládat hodnoty vlastností prostřednictvím API Power BI. Když například pracujete s vizuálem a vizuál potřebuje uložit nebo aktualizovat hodnoty vlastností, může vizuál volat metodu persistProperties .

  • Vyberte adresu URL.

    Ve výchozím nastavení vizuál nemůže otevřít adresu URL přímo. Chcete-li otevřít adresu URL na nové kartě, vizuální prvek může zavolat metodu launchUrl a předat adresu URL jako parametr.

    Další informace najdete v tématu Vytvoření adresy URL pro spuštění.

  • Použijte filtr v rámci vizuálu.

    Vizuál může volat metodu applyJsonFilter a předat podmínky pro filtrování dat v jiných vizuálech. K dispozici je několik typů filtrů, včetně filtrů Základní, Pokročilé a Dvojité.

    Další informace najdete v tématu Rozhraní API vizuálních filtrů Power BI.

  • Vyberte prvky ve vizuálu.

    Další informace o výběrech ve vizuálu Power BI najdete v tématu Přidání interaktivity do vizuálu pomocí výběrů vizuálů Power BI.

Vizuál komunikuje s Power BI

Vizuál někdy zahájí komunikaci s hostitelem Power BI bez jakéhokoli vstupu od vás:

  • Vizuál požaduje více dat z Power BI.

    Vizuální proces zpracovává data po částech. Metoda fetchMoreData rozhraní API požaduje další fragment dat v sémantickém modelu.

    Další informace najdete v tématu Načtení dalších dat z Power BI.

  • Aktivuje se služba událostí.

    Power BI může exportovat sestavu do PDF nebo odeslat sestavu e-mailem (platí jenom pro certifikované vizuály). Chcete-li upozornit Power BI, že vykreslování je dokončeno a vizuál je připravený k zaznamenání jako PDF nebo odeslání e-mailem, měl by vizuál použít API událostí vykreslování.

    Další informace najdete v tématu Export sestav z Power BI do PDF.

    Další informace o službě událostí najdete v tématu Vykreslování událostí ve vizuálech Power BI.

Související obsah

Zajímá vás vytváření vizualizací a jejich přidání do Microsoft AppSource? Podívejte se na tyto články: