Experimente as APIs em tempo real usando seu próprio relatório ou nosso relatório de exemplo na seção de área restrita do Developer do do Power BI Embedded Analytics Playground.
Os eventos são usados para se comunicar entre o componente do Power BI (por exemplo, um relatório) e o código do aplicativo Web.
Um componente inserido emite eventos depois que uma ação é executada dentro do componente. Elas podem ser interações do usuário ou uma ação automatizada (como um visual sendo renderizado) dentro do componente.
Por exemplo, buttonClicked é um evento emitido por um relatório do Power BI quando um usuário clica em um botão no relatório. Você pode ouvir o evento usando report.on(...)e, em seguida, definir um manipulador de eventos.
Um exemplo de como lidar com um evento
Este exemplo mostra como lidar com um evento de relatório. Para saber mais sobre outros tipos de eventos, consulte Eventos e seus valores de resposta.
Observação
Aguarde até que o componente seja carregado antes de usar as APIs. Ouça o evento carregado e emita novos comandos.
Você pode usar report.off(...) para remover todos os manipuladores de eventos para um evento específico.
Eventos e seus valores de resposta
Exiba uma lista completa de possíveis eventos e seus valores de resposta.
Eventos de erro (relevantes para todos os inserções)
Um evento de erro é emitido para descrever uma operação com falha.
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
}
Observação
Somente a propriedade message é necessária e as outras propriedades podem ser indefinidas.
Eventos de relatório
Um evento de relatório é emitido para uma interação com um relatório inserido, como clicar em um botão de relatório ou renderizar um visual.
buttonClicked
O evento buttonClicked é gerado quando um usuário clica em um botão Relatório.
O evento dataHyperlinkClicked é gerado quando um hiperlink é clicado e o comportamento do hiperlink é definido como NavigateAndRaiseEvent ou RaiseEvent.
O evento loaded é gerado quando o relatório é inicializado. O carregamento é concluído quando o logotipo do Power BI desaparece.
pageChanged
O evento pageChanged é gerado sempre que uma página é alterada.
newPage: Models.IPage
Processado
O evento rendered é gerado quando um relatório é totalmente renderizado. Por exemplo, se todos os visuais forem renderizados ao carregar um relatório ou após uma interação do usuário.
saveAsTriggered
O evento saveAsTriggered é gerado quando um usuário clica em Salvar como na interface do usuário. Isso permite que você crie sua própria caixa de diálogo para a ação Salvar como.
Salvou
O evento saved é gerado quando um salvamento é disparado por uma ação save ou saveAs na interface do usuário ou usando as APIs.
selectionChanged
O evento selectionChanged é gerado sempre que o usuário estiver alterando o visual selecionado.
selectedItems é uma lista de todos os visuais selecionados quando mais de um está selecionado.
O evento visualRendered é gerado quando um visual é renderizado (requer a configuração visualRenderedEvents para verdadeiro no objeto de configurações).
Observação
Como os visuais podem ser renderizados devido às interações do usuário, é recomendável que esse evento só seja ativado quando necessário.
Um evento de Inserção de Relatório móvel é emitido para uma interação com um relatório inserido em um layout móvel, como o início ou o fim de um deslize.
Eventos swipeStart e swipeEnd
swipeStart ou eventos de swipeEnd são gerados quando um usuário começa ou termina um movimento de passar o dedo em um relatório inserido.
interface ISwipeEvent {
currentPosition: IPosition
startPosition: IPosition
}
interface IPosition {
x: number
y: number
}
Eventos de painel
Um evento de painel é emitido quando o painel é carregado e quando um usuário clica em um bloco no painel.
carregado
O evento loaded é gerado quando o painel é inicializado.
blocos lambidos
O evento tileClicked é gerado quando um usuário final clica em um bloco. Ele não é gerado para páginas ao vivo fixadas.
Transforme e carregue dados, defina relações e cálculos de modelos semânticos, crie visuais interativos e distribua relatórios usando o Power BI. (DP-605T00)
Demonstre métodos e boas práticas que se alinhem aos requisitos técnicos e comerciais para modelagem, visualização e análise de dados com o Microsoft Power BI.