Report class
O componente de inserção de Relatório do Power BI
- Extends
-
Embed
Propriedades
bookmarks |
Métodos
add |
Adicionar comando de extensão de menu de contexto.
|
add |
Comando adicionar extensão de menu de opções.
|
add |
Adicionar uma página vazia ao relatório
|
apply |
Aplicar um tema ao relatório
|
are |
Retorna se houver filtros, segmentações de dados ou outras alterações de exibição de dados aplicadas no relatório. Se os filtros persistentes forem desabilitados, retornará false.
|
clear |
As limpezas selecionadas não serão exibidas nos visuais, se o sinalizador for passado, todas as seleções de visuais serão desmarcadas.
|
close |
Fecha todos os menus de contexto abertos e dicas de ferramentas.
|
config |
Manipular alterações de configuração. |
delete |
Excluir uma página de um relatório
|
get |
Obtém a página de relatório ativo.
|
get |
Obtém filtros aplicados no nível do relatório.
|
get |
Obtém a ID do relatório do primeiro local disponível: opções, atributo, url de inserção. |
get |
Obtém uma página de relatório pelo nome.
|
get |
Obtém a lista de páginas dentro do relatório.
|
get |
obter o tema do relatório
|
get |
Retorne o nível de zoom atual do relatório. |
is |
verifica se o relatório foi salvo.
|
move |
Atualiza a posição de um visual em uma página.
|
print() | Imprime a página ativa do relatório invocando |
refresh() | Atualiza as fontes de dados do relatório.
|
remove |
Remova o comando de extensão de menu de contexto.
|
remove |
Remove todos os filtros no nível do relatório.
|
remove |
Remover o comando de extensão do menu opções.
|
rename |
Renomear uma página de um relatório
|
render(IReport |
Renderizar um relatório pré-carregado usando a API de inserção em fases
|
reset |
Redefinir filtros, segmentações e outras alterações de exibição de dados do usuário para o estado padrão do relatório
|
reset |
Redefinir e aplicar o tema padrão do relatório
|
resize |
Atualiza o tamanho da página ativa no relatório.
|
resize |
Redimensione um visual em uma página.
|
save |
Salvar filtros, segmentações de dados e outras alterações de exibição de dados do relatório
|
set |
Define filtros no nível do relatório.
|
set |
Define a página ativa do relatório.
|
set |
Atualiza o estado de exibição de um visual em uma página.
|
set |
Define o nível de zoom do relatório. |
switch |
Atualiza o layout do relatório
|
switch |
Alternar modo de exibição de relatório. |
update |
Atualize os filtros no nível do relatório de acordo com a operação: Adicionar, substituir todos, substituir por destino ou remover.
|
update |
Atualiza as configurações de visibilidade do painel de filtro e do painel de navegação da página.
|
Métodos herdados
exit |
Solicita que o navegador saia do modo de tela inteira. |
fullscreen() | Solicita que o navegador renderize o iframe do componente no modo de tela inteira. |
get |
Obtenha a correlationId para a sessão de inserção atual.
|
off<T>(string, IEvent |
Remove um ou mais manipuladores de eventos da lista de manipuladores. Se uma referência à função de identificador existente for especificada, remova o manipulador específico. Se o manipulador não for especificado, remova todos os manipuladores do nome do evento especificado.
|
on<T>(string, IEvent |
Adiciona um manipulador de eventos para um evento específico.
|
reload() | Recarrega o inserção usando a configuração existente. Por exemplo, para relatórios, isso limpa efetivamente todos os filtros e torna a primeira página ativa, o que simula a redefinição de um relatório de volta ao estado carregado.
|
remove |
Remove o atributo tabindex do elemento |
save() | Salva o relatório. |
save |
Relatório SaveAs. |
set |
Defina accessToken. |
set |
Define o atributo tabindex do elemento |
set |
Defina o título do componente para acessibilidade. No caso de iframes, esse método alterará o título iframe. |
Detalhes da propriedade
bookmarksManager
Detalhes do método
addContextMenuCommand(string, string, string, MenuLocation, string, string, string)
Adicionar comando de extensão de menu de contexto.
report.addContextMenuCommand(commandName, commandTitle, contextMenuTitle, menuLocation, visualName, visualType, groupName)
.catch(error => {
...
});
function addContextMenuCommand(commandName: string, commandTitle: string, contextMenuTitle: string, menuLocation: MenuLocation, visualName: string, visualType: string, groupName?: string): Promise<IHttpPostMessageResponse<void>>
Parâmetros
- commandName
-
string
- commandTitle
-
string
- contextMenuTitle
-
string
- menuLocation
- MenuLocation
- visualName
-
string
- visualType
-
string
- groupName
-
string
Retornos
Promise<IHttpPostMessageResponse<void>>
addOptionsMenuCommand(string, string, string, MenuLocation, string, string, string, string)
Comando adicionar extensão de menu de opções.
report.addOptionsMenuCommand(commandName, commandTitle, optionsMenuTitle, menuLocation, visualName, visualType, groupName, commandIcon)
.catch(error => {
...
});
function addOptionsMenuCommand(commandName: string, commandTitle: string, optionsMenuTitle?: string, menuLocation?: MenuLocation, visualName?: string, visualType?: string, groupName?: string, commandIcon?: string): Promise<IHttpPostMessageResponse<void>>
Parâmetros
- commandName
-
string
- commandTitle
-
string
- optionsMenuTitle
-
string
- menuLocation
- MenuLocation
- visualName
-
string
- visualType
-
string
- groupName
-
string
- commandIcon
-
string
Retornos
Promise<IHttpPostMessageResponse<void>>
addPage(string)
Adicionar uma página vazia ao relatório
// Add a page to the report with "Sales" as the page display name
report.addPage("Sales");
function addPage(displayName?: string): Promise<Page>
Parâmetros
- displayName
-
string
Retornos
Promise<Page>
applyTheme(IReportTheme)
Aplicar um tema ao relatório
report.applyTheme(theme);
function applyTheme(theme: IReportTheme): Promise<void>
Parâmetros
- theme
- IReportTheme
Retornos
Promise<void>
arePersistentFiltersApplied()
Retorna se houver filtros, segmentações de dados ou outras alterações de exibição de dados aplicadas no relatório. Se os filtros persistentes forem desabilitados, retornará false.
report.arePersistentFiltersApplied();
function arePersistentFiltersApplied(): Promise<boolean>
Retornos
Promise<boolean>
clearSelectedVisuals(boolean)
As limpezas selecionadas não serão exibidas nos visuais, se o sinalizador for passado, todas as seleções de visuais serão desmarcadas.
report.clearSelectedVisuals()
.then(() => {
...
});
function clearSelectedVisuals(clearPopOutState?: boolean): Promise<void>
Parâmetros
- clearPopOutState
-
boolean
Se a seleção de visuais false/indefinido não for desmarcada se um dos visuais estiver no estado de saída (em foco, mostrar como tabela, destaque...)
Retornos
Promise<void>
closeAllOverlays()
Fecha todos os menus de contexto abertos e dicas de ferramentas.
report.closeAllOverlays()
.then(() => {
...
});
function closeAllOverlays(): Promise<void>
Retornos
Promise<void>
configChanged(boolean)
Manipular alterações de configuração.
function configChanged(isBootstrap: boolean)
Parâmetros
- isBootstrap
-
boolean
deletePage(string)
Excluir uma página de um relatório
// Delete a page from a report by pageName (PageName is different than the display name and can be acquired from the getPages API)
report.deletePage("ReportSection145");
function deletePage(pageName: string): Promise<void>
Parâmetros
- pageName
-
string
Retornos
Promise<void>
getActivePage()
Obtém a página de relatório ativo.
report.getActivePage()
.then(activePage => {
...
});
function getActivePage(): Promise<Page>
Retornos
Promise<Page>
getFilters()
Obtém filtros aplicados no nível do relatório.
// Get filters applied at report level
report.getFilters()
.then(filters => {
...
});
function getFilters(): Promise<IFilter[]>
Retornos
Promise<IFilter[]>
getId()
Obtém a ID do relatório do primeiro local disponível: opções, atributo, url de inserção.
function getId(): string
Retornos
string
getPageByName(string)
Obtém uma página de relatório pelo nome.
report.getPageByName(pageName)
.then(page => {
...
});
function getPageByName(pageName: string): Promise<Page>
Parâmetros
- pageName
-
string
Retornos
Promise<Page>
getPages()
Obtém a lista de páginas dentro do relatório.
report.getPages()
.then(pages => {
...
});
function getPages(): Promise<Page[]>
Retornos
Promise<Page[]>
getTheme()
obter o tema do relatório
report.getTheme();
function getTheme(): Promise<IReportTheme>
Retornos
Promise<IReportTheme>
getZoom()
Retorne o nível de zoom atual do relatório.
function getZoom(): Promise<number>
Retornos
Promise<number>
isSaved()
verifica se o relatório foi salvo.
report.isSaved()
function isSaved(): Promise<boolean>
Retornos
Promise<boolean>
moveVisual(string, string, number, number, number)
Atualiza a posição de um visual em uma página.
report.moveVisual(pageName, visualName, x, y, z)
.catch(error => { ... });
function moveVisual(pageName: string, visualName: string, x: number, y: number, z?: number): Promise<IHttpPostMessageResponse<void>>
Parâmetros
- pageName
-
string
- visualName
-
string
- x
-
number
- y
-
number
- z
-
number
Retornos
Promise<IHttpPostMessageResponse<void>>
print()
Imprime a página ativa do relatório invocando window.print()
no componente iframe de inserção.
function print(): Promise<void>
Retornos
Promise<void>
refresh()
Atualiza as fontes de dados do relatório.
report.refresh();
function refresh(): Promise<void>
Retornos
Promise<void>
removeContextMenuCommand(string, string)
Remova o comando de extensão de menu de contexto.
report.removeContextMenuCommand(commandName, contextMenuTitle)
.catch(error => {
...
});
function removeContextMenuCommand(commandName: string, contextMenuTitle: string): Promise<IHttpPostMessageResponse<void>>
Parâmetros
- commandName
-
string
- contextMenuTitle
-
string
Retornos
Promise<IHttpPostMessageResponse<void>>
removeFilters()
Remove todos os filtros no nível do relatório.
report.removeFilters();
function removeFilters(): Promise<IHttpPostMessageResponse<void>>
Retornos
Promise<IHttpPostMessageResponse<void>>
removeOptionsMenuCommand(string, string)
Remover o comando de extensão do menu opções.
report.removeOptionsMenuCommand(commandName, optionsMenuTitle)
.then({
...
});
function removeOptionsMenuCommand(commandName: string, optionsMenuTitle: string): Promise<IHttpPostMessageResponse<void>>
Parâmetros
- commandName
-
string
- optionsMenuTitle
-
string
Retornos
Promise<IHttpPostMessageResponse<void>>
renamePage(string, string)
Renomear uma página de um relatório
// Rename a page from a report by changing displayName (pageName is different from the display name and can be acquired from the getPages API)
report.renamePage("ReportSection145", "Sales");
function renamePage(pageName: string, displayName: string): Promise<void>
Parâmetros
- pageName
-
string
- displayName
-
string
Retornos
Promise<void>
render(IReportEmbedConfiguration | IReportLoadConfiguration)
Renderizar um relatório pré-carregado usando a API de inserção em fases
// Load report
var report = powerbi.load(element, config);
...
// Render report
report.render()
function render(config?: IReportEmbedConfiguration | IReportLoadConfiguration): Promise<void>
Parâmetros
Retornos
Promise<void>
resetPersistentFilters()
Redefinir filtros, segmentações e outras alterações de exibição de dados do usuário para o estado padrão do relatório
report.resetPersistentFilters();
function resetPersistentFilters(): Promise<IHttpPostMessageResponse<void>>
Retornos
Promise<IHttpPostMessageResponse<void>>
resetTheme()
Redefinir e aplicar o tema padrão do relatório
report.resetTheme();
function resetTheme(): Promise<void>
Retornos
Promise<void>
resizeActivePage(PageSizeType, number, number)
Atualiza o tamanho da página ativa no relatório.
report.resizeActivePage(pageSizeType, width, height)
.catch(error => { ... });
function resizeActivePage(pageSizeType: PageSizeType, width?: number, height?: number): Promise<IHttpPostMessageResponse<void>>
Parâmetros
- pageSizeType
- PageSizeType
- width
-
number
- height
-
number
Retornos
Promise<IHttpPostMessageResponse<void>>
resizeVisual(string, string, number, number)
Redimensione um visual em uma página.
report.resizeVisual(pageName, visualName, width, height)
.catch(error => { ... });
function resizeVisual(pageName: string, visualName: string, width: number, height: number): Promise<IHttpPostMessageResponse<void>>
Parâmetros
- pageName
-
string
- visualName
-
string
- width
-
number
- height
-
number
Retornos
Promise<IHttpPostMessageResponse<void>>
savePersistentFilters()
Salvar filtros, segmentações de dados e outras alterações de exibição de dados do relatório
report.savePersistentFilters();
function savePersistentFilters(): Promise<IHttpPostMessageResponse<void>>
Retornos
Promise<IHttpPostMessageResponse<void>>
setFilters(IFilter[])
Define filtros no nível do relatório.
const filters: [
...
];
report.setFilters(filters)
.catch(errors => {
...
});
function setFilters(filters: IFilter[]): Promise<IHttpPostMessageResponse<void>>
Parâmetros
- filters
-
IFilter[]
Retornos
Promise<IHttpPostMessageResponse<void>>
setPage(string)
Define a página ativa do relatório.
report.setPage("page2")
.catch(error => { ... });
function setPage(pageName: string): Promise<IHttpPostMessageResponse<void>>
Parâmetros
- pageName
-
string
Retornos
Promise<IHttpPostMessageResponse<void>>
setVisualDisplayState(string, string, VisualContainerDisplayMode)
Atualiza o estado de exibição de um visual em uma página.
report.setVisualDisplayState(pageName, visualName, displayState)
.catch(error => { ... });
function setVisualDisplayState(pageName: string, visualName: string, displayState: VisualContainerDisplayMode): Promise<IHttpPostMessageResponse<void>>
Parâmetros
- pageName
-
string
- visualName
-
string
- displayState
- VisualContainerDisplayMode
Retornos
Promise<IHttpPostMessageResponse<void>>
setZoom(number)
Define o nível de zoom do relatório.
function setZoom(zoomLevel: number): Promise<void>
Parâmetros
- zoomLevel
-
number
nível de zoom a ser definido
Retornos
Promise<void>
switchLayout(LayoutType)
Atualiza o layout do relatório
report.switchLayout(layoutType);
function switchLayout(layoutType: LayoutType): Promise<IHttpPostMessageResponse<void>>
Parâmetros
- layoutType
- LayoutType
Retornos
Promise<IHttpPostMessageResponse<void>>
switchMode(string | ViewMode)
Alternar modo de exibição de relatório.
function switchMode(viewMode: string | ViewMode): Promise<void>
Parâmetros
- viewMode
-
string | ViewMode
Retornos
Promise<void>
updateFilters(FiltersOperations, IFilter[])
Atualize os filtros no nível do relatório de acordo com a operação: Adicionar, substituir todos, substituir por destino ou remover.
report.updateFilters(FiltersOperations.Add, filters)
.catch(errors => { ... });
function updateFilters(operation: FiltersOperations, filters?: IFilter[]): Promise<IHttpPostMessageResponse<void>>
Parâmetros
- operation
- FiltersOperations
- filters
-
IFilter[]
Retornos
Promise<IHttpPostMessageResponse<void>>
updateSettings(ISettings)
Atualiza as configurações de visibilidade do painel de filtro e do painel de navegação da página.
const newSettings = {
panes: {
filters: {
visible: false
}
}
};
report.updateSettings(newSettings)
.catch(error => { ... });
function updateSettings(settings: ISettings): Promise<IHttpPostMessageResponse<void>>
Parâmetros
- settings
- ISettings
Retornos
Promise<IHttpPostMessageResponse<void>>
Detalhes do método herdado
exitFullscreen()
Solicita que o navegador saia do modo de tela inteira.
function exitFullscreen()
Herdado de Embed.exitFullscreen
fullscreen()
Solicita que o navegador renderize o iframe do componente no modo de tela inteira.
function fullscreen()
herdado de Inserção.fullscreen
getCorrelationId()
Obtenha a correlationId para a sessão de inserção atual.
// Get the correlationId for the current embed session
report.getCorrelationId()
.then(correlationId => {
...
});
function getCorrelationId(): Promise<string>
Retornos
Promise<string>
Herdado de Embed.getCorrelationId
off<T>(string, IEventHandler<T>)
Remove um ou mais manipuladores de eventos da lista de manipuladores. Se uma referência à função de identificador existente for especificada, remova o manipulador específico. Se o manipulador não for especificado, remova todos os manipuladores do nome do evento especificado.
report.off('pageChanged')
or
const logHandler = function (event) {
console.log(event);
};
report.off('pageChanged', logHandler);
function off<T>(eventName: string, handler?: IEventHandler<T>)
Parâmetros
- eventName
-
string
- handler
-
IEventHandler<T>
Herdado de Inserção.off
on<T>(string, IEventHandler<T>)
Adiciona um manipulador de eventos para um evento específico.
report.on('pageChanged', (event) => {
console.log('PageChanged: ', event.page.name);
});
function on<T>(eventName: string, handler: IEventHandler<T>)
Parâmetros
- eventName
-
string
- handler
-
IEventHandler<T>
Herdado de Inserção.on
reload()
Recarrega o inserção usando a configuração existente. Por exemplo, para relatórios, isso limpa efetivamente todos os filtros e torna a primeira página ativa, o que simula a redefinição de um relatório de volta ao estado carregado.
report.reload();
function reload(): Promise<void>
Retornos
Promise<void>
Herdado de Embed.reload
removeComponentTabIndex(number)
Remove o atributo tabindex do elemento
function removeComponentTabIndex(_tabIndex?: number)
Parâmetros
- _tabIndex
-
number
herdado de Embed.removeComponentTabIndex
save()
Salva o relatório.
function save(): Promise<void>
Retornos
Promise<void>
Herdado de Embed.save
saveAs(ISaveAsParameters)
Relatório SaveAs.
function saveAs(saveAsParameters: ISaveAsParameters): Promise<void>
Parâmetros
- saveAsParameters
- ISaveAsParameters
Retornos
Promise<void>
Herdado de Embed.saveAs
setAccessToken(string)
Defina accessToken.
function setAccessToken(accessToken: string): Promise<void>
Parâmetros
- accessToken
-
string
Retornos
Promise<void>
Herdado de Embed.setAccessToken
setComponentTabIndex(number)
Define o atributo tabindex do elemento
function setComponentTabIndex(tabIndex?: number)
Parâmetros
- tabIndex
-
number
Herdado de Embed.setComponentTabIndex
setComponentTitle(string)
Defina o título do componente para acessibilidade. No caso de iframes, esse método alterará o título iframe.
function setComponentTitle(title: string)
Parâmetros
- title
-
string
Herdado de Embed.setComponentTitle