Zpracování událostí
Spropitné
Experimentujte s rozhraními API v reálném čase pomocí vlastní sestavy nebo ukázkové sestavy v sandboxu
Události se používají ke komunikaci mezi komponentou Power BI (například sestavou) a kódem webové aplikace.
Vložená komponenta generuje události po provedení akce uvnitř komponenty. Můžou to být interakce uživatelů nebo automatizovaná akce (například vykreslení vizuálu) v rámci komponenty.
Například buttonClicked je událost vygenerovaná sestavou Power BI, když uživatel klikne na tlačítko v sestavě. Událost můžete naslouchat pomocí report.on(...)a pak nastavit obslužnou rutinu události.
Příklad zpracování události
Tento příklad ukazuje, jak zpracovat událost sestavy. Další informace o jiných typech událostí najdete v tématu Události a jejich hodnoty odpovědí.
Poznámka
Před použitím rozhraní API počkejte, než se komponenta načte. Poslouchejte načtenou událost a pak zadejte nové příkazy.
report.on('loaded', function(event)
{
reportPages = await report.getPages();
});
Odebrání obslužných rutin událostí
Pomocí report.off(...) můžete odebrat všechny obslužné rutiny událostí pro konkrétní událost.
Události a jejich hodnoty odpovědí
Zobrazte úplný seznam možných událostí a jejich hodnot odpovědí.
Chybové události (relevantní pro všechna vložení)
Vygeneruje se chybová událost, která popisuje neúspěšnou operaci.
interface IError {
message: string // A general message that describes the operation that failed (example: "Could not set page")
detailedMessage?: string // Detailed message that describes the error
errorCode?: string // Short message that describes the error
level?: TraceType // The level of the error (example: 'Fatal')
technicalDetails?: ITechnicalDetails
}
interface ITechnicalDetails {
requestId?: string // Id for debugging - should be provided when reporting a bug
}
Poznámka
Je vyžadována pouze message vlastnost a ostatní vlastnosti můžou být nedefinované.
Události sestavy
Událost sestavy se vygeneruje pro interakci s vloženou sestavou, například kliknutí na tlačítko sestavy nebo vykreslení vizuálu.
buttonClicked
Událost buttonClicked se vyvolá, když uživatel klikne na tlačítko Sestava.
id: string
title?: string
type?: string (type of button)
bookmark?: string
commandTriggered
Událost commandTriggered je vyvolána, když uživatel klikne na příkaz rozšíření .
command: string
dataPoints?: IIdentityValue[]
report: models.IReport
page: models.IPage
visual: models.IVisual
DataHyperlinkClicked
Událost dataHyperlinkClicked se vyvolá při kliknutí na hypertextový odkaz a chování hypertextového odkazu je nastaveno na NavigateAndRaiseEvent nebo RaiseEvent.
url: string
report: models.IReport
page: models.IPage
visual: models.IVisual
Další informace najdete v tématu Konfigurace nastavení sestavy.
dataSelected
Událost dataSelected je vyvolána při výběru konkrétního datového bodu.
report: models.IReport
page: models.IPage
visual: models.IVisual
filters: IFilter[]
dataPoints: IIdentityValue[]
naložený
Událost loaded se vyvolá při inicializaci sestavy. Načítání se dokončí, když logo Power BI zmizí.
pageChanged
Událost pageChanged se vyvolá při každé změně stránky.
newPage: Models.IPage
učiněný
Událost rendered se vyvolá při úplném vykreslení sestavy. Pokud se například při načítání sestavy nebo po interakci uživatele vykreslují všechny vizuály.
saveAsTriggered
Událost saveAsTriggered se vyvolá, když uživatel v uživatelském rozhraní klikne na Uložit jako. Díky tomu můžete vytvořit vlastní dialogové okno pro akci Uložit jako.
uložený
Událost saved je vyvolána při aktivaci uložení save nebo saveAs akcí v uživatelském rozhraní nebo pomocí rozhraní API.
selectionChanged
Událost selectionChanged se vyvolá vždy, když uživatel mění vybraný vizuál.
selectedItems je seznam všech vybraných vizuálů, pokud je vybráno více vizuálů.
report: models.IReport
page: models.IPage
visual?: models.IVisual
selectedItems?: models.IVisual[]
VisualClicked
Událost visualClicked se vyvolá při každém kliknutí na vizuál.
report: models.IReport
page: models.IPage
visual: models.IVisual
visualRendered
Událost visualRendered je vyvolána při vykreslení vizuálu (vyžaduje nastavení visualRenderedEvents na true v objektu nastavení).
Poznámka
Vzhledem k tomu, že se vizuály můžou vykreslit z důvodu interakcí uživatelů, doporučujeme tuto událost zapnout jenom v případě potřeby.
name: string
Další informace najdete v tématu Konfigurace nastavení sestavy.
Události Vložení sestavy Mobile
Mobilní událost Vložení sestavy se vygeneruje pro interakci s vloženou sestavou v mobilním rozložení, jako je začátek nebo konec potáhnutí prstem.
swipeStart a swipeEnd – události
swipeStart nebo swipeEnd události jsou vyvolány, když uživatel zahájí nebo ukončí pohyb potáhnutí prstem ve vložené sestavě.
interface ISwipeEvent {
currentPosition: IPosition
startPosition: IPosition
}
interface IPosition {
x: number
y: number
}
Události řídicího panelu
Událost řídicího panelu se vygeneruje při načtení řídicího panelu a když uživatel klikne na dlaždici na řídicím panelu.
naložený
Událost loaded se vyvolá při inicializaci řídicího panelu.
TileClicked
Událost tileClicked se vyvolá, když koncový uživatel klikne na dlaždici. Není vyvolána pro připnuté živé stránky.
tileId: string
navigationUrl: string
pageName: string
reportEmbedUrl: string
Události Q&A
Při vykreslení vizuálu po zadání otázky se vyvolá událost otázky a odpovědi (Q&A).
visualRendered (Q&A)
Událost visualRendered se vyvolá při vykreslení vizuálu po zadání otázky a zobrazí se odpověď.
question: string
normalizedQuestion: string
Události dlaždic
Událost dlaždice se vyvolá, když uživatel klikne na dlaždici.
tileClicked (událost dlaždice)
Událost tileClicked se vyvolá, když koncový uživatel klikne na dlaždici. Není vyvolána pro připnuté živé stránky.
tileId: string
navigationUrl: string
pageName: string
reportEmbedUrl: string
tileLoaded
Událost tileLoaded se vyvolá při inicializaci dlaždice. Načítání se dokončí, když logo Power BI zmizí.