Compartir a través de


Visual class

Componente de inserción de objetos visuales de Power BI

Extends

Propiedades heredadas

bookmarksManager

Métodos

getFilters(FiltersLevel)

Obtiene filtros que se aplican al nivel de filtro. El nivel de filtro predeterminado es el nivel visual.

visual.getFilters(filtersLevel)
  .then(filters => {
    ...
  });
getPages()

Obtiene la lista de páginas del informe: no se admite en el objeto visual.

getVisualDescriptor()

Obtiene el objeto descriptor visual incrustado que contiene el nombre visual, el tipo, etc.

visual.getVisualDescriptor()
  .then(visualDetails => { ... });
removeFilters(FiltersLevel)

Quita todos los filtros del nivel de filtro actual. El nivel de filtro predeterminado es el nivel visual.

visual.removeFilters(filtersLevel);
setFilters(IFilter[], FiltersLevel)

Establece filtros en el nivel de filtro. El nivel de filtro predeterminado es el nivel visual.

const filters: [
   ...
];

visual.setFilters(filters, filtersLevel)
 .catch(errors => {
   ...
 });
setPage(string)

Establece la página activa del informe; no se admite en el objeto visual.

updateFilters(FiltersOperations, IFilter[], FiltersLevel)

Actualiza los filtros en el nivel de filtro. El nivel de filtro predeterminado es el nivel visual.

const filters: [
   ...
];

visual.updateFilters(FiltersOperations.Add, filters, filtersLevel)
 .catch(errors => {
   ...
 });

Métodos heredados

addContextMenuCommand(string, string, string, MenuLocation, string, string, string)

Agregue el comando de extensión del menú contextual.

report.addContextMenuCommand(commandName, commandTitle, contextMenuTitle, menuLocation, visualName, visualType, groupName)
 .catch(error => {
     ...
 });
addOptionsMenuCommand(string, string, string, MenuLocation, string, string, string, string)

Comando agregar opciones de extensión de menú.

report.addOptionsMenuCommand(commandName, commandTitle, optionsMenuTitle, menuLocation, visualName, visualType, groupName, commandIcon)
 .catch(error => {
     ...
 });
addPage(string)

Agregar una página vacía al informe

// Add a page to the report with "Sales" as the page display name
report.addPage("Sales");
applyTheme(IReportTheme)

Aplicar un tema al informe

report.applyTheme(theme);
arePersistentFiltersApplied()

Devuelve si hay filtros, segmentaciones de datos u otros cambios de vista de datos aplicados en el informe. Si los filtros persistentes están deshabilitados, devuelve false.

report.arePersistentFiltersApplied();
clearSelectedVisuals(boolean)

Borra los objetos visuales seleccionados no extraídos, si se pasa la marca, se borrarán todas las selecciones de objetos visuales.

report.clearSelectedVisuals()
 .then(() => {
     ...
 });
closeAllOverlays()

Cierra todos los menús contextuales abiertos y la información sobre herramientas.

report.closeAllOverlays()
 .then(() => {
     ...
 });
configChanged(boolean)

Controle los cambios de configuración.

deletePage(string)

Eliminar una página de un informe

// 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");
exitFullscreen()

Solicita al explorador que salga del modo de pantalla completa.

fullscreen()

Solicita al explorador que represente el iframe del componente en modo de pantalla completa.

getActivePage()

Obtiene la página del informe activo.

report.getActivePage()
 .then(activePage => {
     ...
 });
getCorrelationId()

Obtenga el correlationId para la sesión de inserción actual.

// Get the correlationId for the current embed session
report.getCorrelationId()
  .then(correlationId => {
    ...
  });
getId()

Obtiene el identificador de informe de la primera ubicación disponible: opciones, atributo, dirección URL de inserción.

getPageByName(string)

Obtiene una página de informe por su nombre.

report.getPageByName(pageName)
 .then(page => {
     ...
 });
getTheme()

obtener el tema del informe

report.getTheme();
getZoom()

Devuelve el nivel de zoom actual del informe.

isSaved()

comprueba si el informe se guarda.

report.isSaved()
moveVisual(string, string, number, number, number)

Actualiza la posición de un objeto visual en una página.

report.moveVisual(pageName, visualName, x, y, z)
  .catch(error => { ... });
off<T>(string, IEventHandler<T>)

Quita uno o varios controladores de eventos de la lista de controladores. Si se especifica una referencia a la función de controlador existente, quite el controlador específico. Si no se especifica el controlador, quite todos los controladores para el nombre de evento especificado.

report.off('pageChanged')

or

const logHandler = function (event) {
   console.log(event);
};

report.off('pageChanged', logHandler);
on<T>(string, IEventHandler<T>)

Agrega un controlador de eventos para un evento específico.

report.on('pageChanged', (event) => {
  console.log('PageChanged: ', event.page.name);
});
print()

Imprime la página activa del informe invocando window.print() en el componente insertar iframe.

refresh()

Actualiza los orígenes de datos del informe.

report.refresh();
reload()

Vuelve a cargar la inserción mediante la configuración existente. Por ejemplo, para los informes, esto borra eficazmente todos los filtros y hace que la primera página esté activa que simula restablecer un informe de nuevo al estado cargado.

report.reload();
removeComponentTabIndex(number)

Quita el atributo tabindex del elemento.

removeContextMenuCommand(string, string)

Quite el comando de extensión del menú contextual.

report.removeContextMenuCommand(commandName, contextMenuTitle)
 .catch(error => {
     ...
 });
removeOptionsMenuCommand(string, string)

Comando de extensión de menú Quitar opciones.

report.removeOptionsMenuCommand(commandName, optionsMenuTitle)
 .then({
     ...
 });
renamePage(string, string)

Cambiar el nombre de una página de un informe

// 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");
resetPersistentFilters()

Restablecer los filtros, segmentaciones de datos y otros cambios de vista de datos del usuario en el estado predeterminado del informe

report.resetPersistentFilters();
resetTheme()

Restablecer y aplicar el tema predeterminado del informe

report.resetTheme();
resizeActivePage(PageSizeType, number, number)

Actualiza el tamaño de la página activa en el informe.

report.resizeActivePage(pageSizeType, width, height)
  .catch(error => { ... });
resizeVisual(string, string, number, number)

Cambiar el tamaño de un objeto visual en una página.

report.resizeVisual(pageName, visualName, width, height)
  .catch(error => { ... });
save()

Guarda informe.

saveAs(ISaveAsParameters)

SaveAs Report.

savePersistentFilters()

Guardar los filtros, segmentaciones de datos y otros cambios en la vista de datos del informe

report.savePersistentFilters();
setAccessToken(string)

Establezca accessToken.

setComponentTabIndex(number)

Establece el atributo tabindex del elemento

setComponentTitle(string)

Establezca el título del componente para accesibilidad. En el caso de iframes, este método cambiará el título del iframe.

setVisualDisplayState(string, string, VisualContainerDisplayMode)

Actualiza el estado de visualización de un objeto visual en una página.

report.setVisualDisplayState(pageName, visualName, displayState)
  .catch(error => { ... });
setZoom(number)

Establece el nivel de zoom del informe.

switchLayout(LayoutType)

Actualiza el diseño del informe

report.switchLayout(layoutType);
switchMode(string | ViewMode)

Cambie el modo de vista Informe.

updateSettings(ISettings)

Actualiza la configuración de visibilidad para el panel de filtro y el panel de navegación de páginas.

const newSettings = {
  panes: {
    filters: {
      visible: false
    }
  }
};

report.updateSettings(newSettings)
  .catch(error => { ... });

Detalles de las propiedades heredadas

bookmarksManager

bookmarksManager: BookmarksManager

Valor de propiedad

heredado de Report.bookmarksManager

Detalles del método

getFilters(FiltersLevel)

Obtiene filtros que se aplican al nivel de filtro. El nivel de filtro predeterminado es el nivel visual.

visual.getFilters(filtersLevel)
  .then(filters => {
    ...
  });
function getFilters(filtersLevel?: FiltersLevel): Promise<IFilter[]>

Parámetros

filtersLevel
FiltersLevel

Devoluciones

Promise<IFilter[]>

getPages()

Obtiene la lista de páginas del informe: no se admite en el objeto visual.

function getPages(): Promise<Page[]>

Devoluciones

Promise<Page[]>

getVisualDescriptor()

Obtiene el objeto descriptor visual incrustado que contiene el nombre visual, el tipo, etc.

visual.getVisualDescriptor()
  .then(visualDetails => { ... });
function getVisualDescriptor(): Promise<VisualDescriptor>

Devoluciones

Promise<VisualDescriptor>

removeFilters(FiltersLevel)

Quita todos los filtros del nivel de filtro actual. El nivel de filtro predeterminado es el nivel visual.

visual.removeFilters(filtersLevel);
function removeFilters(filtersLevel?: FiltersLevel): Promise<IHttpPostMessageResponse<void>>

Parámetros

filtersLevel
FiltersLevel

Devoluciones

Promise<IHttpPostMessageResponse<void>>

setFilters(IFilter[], FiltersLevel)

Establece filtros en el nivel de filtro. El nivel de filtro predeterminado es el nivel visual.

const filters: [
   ...
];

visual.setFilters(filters, filtersLevel)
 .catch(errors => {
   ...
 });
function setFilters(filters: IFilter[], filtersLevel?: FiltersLevel): Promise<IHttpPostMessageResponse<void>>

Parámetros

filters

IFilter[]

filtersLevel
FiltersLevel

Devoluciones

Promise<IHttpPostMessageResponse<void>>

setPage(string)

Establece la página activa del informe; no se admite en el objeto visual.

function setPage(_pageName: string): Promise<IHttpPostMessageResponse<void>>

Parámetros

_pageName

string

Devoluciones

Promise<IHttpPostMessageResponse<void>>

updateFilters(FiltersOperations, IFilter[], FiltersLevel)

Actualiza los filtros en el nivel de filtro. El nivel de filtro predeterminado es el nivel visual.

const filters: [
   ...
];

visual.updateFilters(FiltersOperations.Add, filters, filtersLevel)
 .catch(errors => {
   ...
 });
function updateFilters(operation: FiltersOperations, filters: IFilter[], filtersLevel?: FiltersLevel): Promise<IHttpPostMessageResponse<void>>

Parámetros

operation
FiltersOperations
filters

IFilter[]

filtersLevel
FiltersLevel

Devoluciones

Promise<IHttpPostMessageResponse<void>>

Detalles de los métodos heredados

addContextMenuCommand(string, string, string, MenuLocation, string, string, string)

Agregue el comando de extensión del menú contextual.

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

Devoluciones

Promise<IHttpPostMessageResponse<void>>

Se hereda dereport.addContextMenuCommand

addOptionsMenuCommand(string, string, string, MenuLocation, string, string, string, string)

Comando agregar opciones de extensión de menú.

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

Devoluciones

Promise<IHttpPostMessageResponse<void>>

heredado deReport.addOptionsMenuCommand

addPage(string)

Agregar una página vacía al informe

// 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

Devoluciones

Promise<Page>

heredado de Report.addPage

applyTheme(IReportTheme)

Aplicar un tema al informe

report.applyTheme(theme);
function applyTheme(theme: IReportTheme): Promise<void>

Parámetros

theme
IReportTheme

Devoluciones

Promise<void>

heredado dereport.applyTheme

arePersistentFiltersApplied()

Devuelve si hay filtros, segmentaciones de datos u otros cambios de vista de datos aplicados en el informe. Si los filtros persistentes están deshabilitados, devuelve false.

report.arePersistentFiltersApplied();
function arePersistentFiltersApplied(): Promise<boolean>

Devoluciones

Promise<boolean>

Heredado deReport.arePersistentFiltersApplied

clearSelectedVisuals(boolean)

Borra los objetos visuales seleccionados no extraídos, si se pasa la marca, se borrarán todas las selecciones de objetos visuales.

report.clearSelectedVisuals()
 .then(() => {
     ...
 });
function clearSelectedVisuals(clearPopOutState?: boolean): Promise<void>

Parámetros

clearPopOutState

boolean

Si la selección de objetos visuales false/no definidos no se borrará si uno de los objetos visuales está en estado emergente (en el foco, mostrar como tabla, contenido destacado...)

Devoluciones

Promise<void>

Heredado deReport.clearSelectedVisuals

closeAllOverlays()

Cierra todos los menús contextuales abiertos y la información sobre herramientas.

report.closeAllOverlays()
 .then(() => {
     ...
 });
function closeAllOverlays(): Promise<void>

Devoluciones

Promise<void>

heredado deReport.closeAllOverlays

configChanged(boolean)

Controle los cambios de configuración.

function configChanged(isBootstrap: boolean)

Parámetros

isBootstrap

boolean

heredado de Report.configChanged

deletePage(string)

Eliminar una página de un informe

// 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

Devoluciones

Promise<void>

heredado de Report.deletePage

exitFullscreen()

Solicita al explorador que salga del modo de pantalla completa.

function exitFullscreen()

heredado dereport.exitFullscreen

fullscreen()

Solicita al explorador que represente el iframe del componente en modo de pantalla completa.

function fullscreen()

heredado de report.fullscreen

getActivePage()

Obtiene la página del informe activo.

report.getActivePage()
 .then(activePage => {
     ...
 });
function getActivePage(): Promise<Page>

Devoluciones

Promise<Page>

heredado dereport.getActivePage

getCorrelationId()

Obtenga el correlationId para la sesión de inserción actual.

// Get the correlationId for the current embed session
report.getCorrelationId()
  .then(correlationId => {
    ...
  });
function getCorrelationId(): Promise<string>

Devoluciones

Promise<string>

heredado deReport.getCorrelationId

getId()

Obtiene el identificador de informe de la primera ubicación disponible: opciones, atributo, dirección URL de inserción.

function getId(): string

Devoluciones

string

heredado de Report.getId

getPageByName(string)

Obtiene una página de informe por su nombre.

report.getPageByName(pageName)
 .then(page => {
     ...
 });
function getPageByName(pageName: string): Promise<Page>

Parámetros

pageName

string

Devoluciones

Promise<Page>

Heredado deReport.getPageByName

getTheme()

obtener el tema del informe

report.getTheme();
function getTheme(): Promise<IReportTheme>

Devoluciones

Promise<IReportTheme>

Heredado deReport.getTheme

getZoom()

Devuelve el nivel de zoom actual del informe.

function getZoom(): Promise<number>

Devoluciones

Promise<number>

Heredado deReport.getZoom

isSaved()

comprueba si el informe se guarda.

report.isSaved()
function isSaved(): Promise<boolean>

Devoluciones

Promise<boolean>

Heredado deReport.isSaved

moveVisual(string, string, number, number, number)

Actualiza la posición de un objeto visual en una 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

Devoluciones

Promise<IHttpPostMessageResponse<void>>

heredado deReport.moveVisual

off<T>(string, IEventHandler<T>)

Quita uno o varios controladores de eventos de la lista de controladores. Si se especifica una referencia a la función de controlador existente, quite el controlador específico. Si no se especifica el controlador, quite todos los controladores para el nombre de 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>

heredado deReport.off

on<T>(string, IEventHandler<T>)

Agrega un controlador de eventos para un 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>

heredado deReport.on

print()

Imprime la página activa del informe invocando window.print() en el componente insertar iframe.

function print(): Promise<void>

Devoluciones

Promise<void>

heredado de Report.print

refresh()

Actualiza los orígenes de datos del informe.

report.refresh();
function refresh(): Promise<void>

Devoluciones

Promise<void>

heredado de Report.refresh

reload()

Vuelve a cargar la inserción mediante la configuración existente. Por ejemplo, para los informes, esto borra eficazmente todos los filtros y hace que la primera página esté activa que simula restablecer un informe de nuevo al estado cargado.

report.reload();
function reload(): Promise<void>

Devoluciones

Promise<void>

heredado de Report.reload

removeComponentTabIndex(number)

Quita el atributo tabindex del elemento.

function removeComponentTabIndex(_tabIndex?: number)

Parámetros

_tabIndex

number

heredado dereport.removeComponentTabIndex

removeContextMenuCommand(string, string)

Quite el comando de extensión del menú contextual.

report.removeContextMenuCommand(commandName, contextMenuTitle)
 .catch(error => {
     ...
 });
function removeContextMenuCommand(commandName: string, contextMenuTitle: string): Promise<IHttpPostMessageResponse<void>>

Parámetros

commandName

string

contextMenuTitle

string

Devoluciones

Promise<IHttpPostMessageResponse<void>>

Se hereda dereport.removeContextMenuCommand

removeOptionsMenuCommand(string, string)

Comando de extensión de menú Quitar opciones.

report.removeOptionsMenuCommand(commandName, optionsMenuTitle)
 .then({
     ...
 });
function removeOptionsMenuCommand(commandName: string, optionsMenuTitle: string): Promise<IHttpPostMessageResponse<void>>

Parámetros

commandName

string

optionsMenuTitle

string

Devoluciones

Promise<IHttpPostMessageResponse<void>>

Heredado deReport.removeOptionsMenuCommand

renamePage(string, string)

Cambiar el nombre de una página de un informe

// 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

Devoluciones

Promise<void>

Heredar dereport.renamePage

resetPersistentFilters()

Restablecer los filtros, segmentaciones de datos y otros cambios de vista de datos del usuario en el estado predeterminado del informe

report.resetPersistentFilters();
function resetPersistentFilters(): Promise<IHttpPostMessageResponse<void>>

Devoluciones

Promise<IHttpPostMessageResponse<void>>

Heredado deReport.resetPersistentFilters

resetTheme()

Restablecer y aplicar el tema predeterminado del informe

report.resetTheme();
function resetTheme(): Promise<void>

Devoluciones

Promise<void>

heredado dereport.resetTheme

resizeActivePage(PageSizeType, number, number)

Actualiza el tamaño de la página activa en el informe.

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

Devoluciones

Promise<IHttpPostMessageResponse<void>>

heredado dereport.resizeActivePage

resizeVisual(string, string, number, number)

Cambiar el tamaño de un objeto visual en una 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

Devoluciones

Promise<IHttpPostMessageResponse<void>>

Heredado deReport.resizeVisual

save()

Guarda informe.

function save(): Promise<void>

Devoluciones

Promise<void>

heredar de Report.save

saveAs(ISaveAsParameters)

SaveAs Report.

function saveAs(saveAsParameters: ISaveAsParameters): Promise<void>

Parámetros

saveAsParameters
ISaveAsParameters

Devoluciones

Promise<void>

heredado dereport.saveAs

savePersistentFilters()

Guardar los filtros, segmentaciones de datos y otros cambios en la vista de datos del informe

report.savePersistentFilters();
function savePersistentFilters(): Promise<IHttpPostMessageResponse<void>>

Devoluciones

Promise<IHttpPostMessageResponse<void>>

Heredado deReport.savePersistentFilters

setAccessToken(string)

Establezca accessToken.

function setAccessToken(accessToken: string): Promise<void>

Parámetros

accessToken

string

Devoluciones

Promise<void>

heredado dereport.setAccessToken

setComponentTabIndex(number)

Establece el atributo tabindex del elemento

function setComponentTabIndex(tabIndex?: number)

Parámetros

tabIndex

number

se hereda de Report.setComponentTabIndex

setComponentTitle(string)

Establezca el título del componente para accesibilidad. En el caso de iframes, este método cambiará el título del iframe.

function setComponentTitle(title: string)

Parámetros

title

string

heredado dereport.setComponentTitle

setVisualDisplayState(string, string, VisualContainerDisplayMode)

Actualiza el estado de visualización de un objeto visual en una 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

Devoluciones

Promise<IHttpPostMessageResponse<void>>

Heredado deReport.setVisualDisplayState

setZoom(number)

Establece el nivel de zoom del informe.

function setZoom(zoomLevel: number): Promise<void>

Parámetros

zoomLevel

number

nivel de zoom que se va a establecer

Devoluciones

Promise<void>

Heredado de Report.setZoom

switchLayout(LayoutType)

Actualiza el diseño del informe

report.switchLayout(layoutType);
function switchLayout(layoutType: LayoutType): Promise<IHttpPostMessageResponse<void>>

Parámetros

layoutType
LayoutType

Devoluciones

Promise<IHttpPostMessageResponse<void>>

heredado dereport.switchLayout

switchMode(string | ViewMode)

Cambie el modo de vista Informe.

function switchMode(viewMode: string | ViewMode): Promise<void>

Parámetros

viewMode

string | ViewMode

Devoluciones

Promise<void>

Heredado de Report.switchMode

updateSettings(ISettings)

Actualiza la configuración de visibilidad para el panel de filtro y el panel de navegación de páginas.

const newSettings = {
  panes: {
    filters: {
      visible: false
    }
  }
};

report.updateSettings(newSettings)
  .catch(error => { ... });
function updateSettings(settings: ISettings): Promise<IHttpPostMessageResponse<void>>

Parámetros

settings
ISettings

Devoluciones

Promise<IHttpPostMessageResponse<void>>

heredado de Report.updateSettings