Visual class

Inbäddningskomponenten för visuella Power BI-objekt

Extends

Ärvda egenskaper

bookmarksManager

Metoder

getFilters(FiltersLevel)

Hämtar filter som tillämpas på filternivån. Standardfilternivån är visuell nivå.

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

Hämtar listan över sidor i rapporten – stöds inte i visuella objekt

getVisualDescriptor()

Hämtar det inbäddade visuella deskriptorobjektet som innehåller det visuella namnet, typen osv.

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

Tar bort alla filter från den aktuella filternivån. Standardfilternivån är visuell nivå.

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

Anger filter på filternivå. Standardfilternivån är visuell nivå.

const filters: [
   ...
];

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

Anger den aktiva sidan i rapporten – stöds inte i visuella objekt

updateFilters(FiltersOperations, IFilter[], FiltersLevel)

Uppdaterar filter på filternivå. Standardfilternivån är visuell nivå.

const filters: [
   ...
];

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

Ärvda metoder

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

Lägg till snabbmenytilläggskommando.

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

Lägg till menytilläggskommando för alternativ.

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

Lägg till en tom sida i rapporten

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

Använda ett tema i rapporten

report.applyTheme(theme);
arePersistentFiltersApplied()

Returnerar om det finns användarens filter, utsnitt eller andra ändringar i datavyn som tillämpas på rapporten. Om beständiga filter är inaktiverade returneras false.

report.arePersistentFiltersApplied();
clearSelectedVisuals(boolean)

Avmarkerar markerade visuella objekt som inte har poppats ut. Om flaggan skickas rensas alla visuella objektval.

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

Stänger alla öppna snabbmenyer och knappbeskrivningar.

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

Hantera konfigurationsändringar.

deletePage(string)

Ta bort en sida från en rapport

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

Begär att webbläsaren avslutar fullskärmsläget.

fullscreen()

Begär att webbläsaren ska återge komponentens iframe i fullskärmsläge.

getActivePage()

Hämtar den aktiva rapportsidan.

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

Hämta correlationId för den aktuella inbäddningssessionen.

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

Hämtar rapport-ID:t från den första tillgängliga platsen: alternativ, attribut, inbäddnings-URL.

getPageByName(string)

Hämtar en rapportsida med dess namn.

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

hämta rapportens tema

report.getTheme();
getZoom()

Returnera rapportens aktuella zoomnivå.

isSaved()

kontrollerar om rapporten sparas.

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

Uppdaterar positionen för ett visuellt objekt på en sida.

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

Tar bort en eller flera händelsehanterare från listan över hanterare. Om en referens till den befintliga referensfunktionen har angetts tar du bort den specifika hanteraren. Om hanteraren inte har angetts tar du bort alla hanterare för det angivna händelsenamnet.

report.off('pageChanged')

or

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

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

Lägger till en händelsehanterare för en viss händelse.

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

Skriver ut den aktiva sidan i rapporten genom att anropa window.print() på komponenten embed iframe.

refresh()

Uppdaterar datakällor för rapporten.

report.refresh();
reload()

Läser in inbäddningen igen med hjälp av befintlig konfiguration. T.ex. För rapporter rensar detta effektivt alla filter och gör den första sidan aktiv som simulerar återställning av en rapport tillbaka till inläst tillstånd.

report.reload();
removeComponentTabIndex(number)

Tar bort elementets tabindexattribut

removeContextMenuCommand(string, string)

Ta bort kommandot för snabbmenytillägg.

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

Kommandot Ta bort alternativ för menytillägg.

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

Byt namn på en sida från en rapport

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

Återställa användarens filter, utsnitt och andra datavyändringar till standardtillståndet för rapporten

report.resetPersistentFilters();
resetTheme()

Återställa och tillämpa standardtemat i rapporten

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

Uppdaterar storleken på den aktiva sidan i rapporten.

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

Ändra storlek på ett visuellt objekt på en sida.

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

Sparar rapport.

saveAs(ISaveAsParameters)

SaveAs-rapport.

savePersistentFilters()

Spara användarens filter, utsnitt och andra ändringar i datavyn i rapporten

report.savePersistentFilters();
setAccessToken(string)

Ange accessToken.

setComponentTabIndex(number)

Anger elementets tabindexattribut

setComponentTitle(string)

Ange komponentrubriken för hjälpmedel. Om det gäller iframes ändrar den här metoden iframe-rubriken.

setVisualDisplayState(string, string, VisualContainerDisplayMode)

Uppdaterar visningstillståndet för ett visuellt objekt på en sida.

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

Anger rapportens zoomnivå.

switchLayout(LayoutType)

Uppdaterar rapportlayouten

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

Växla rapportvyläge.

updateSettings(ISettings)

Uppdaterar synlighetsinställningarna för filterfönstret och sidnavigeringsfönstret.

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

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

Information om ärvda egenskaper

bookmarksManager

bookmarksManager: BookmarksManager

Egenskapsvärde

ärvd frånReport.bookmarksManager

Metodinformation

getFilters(FiltersLevel)

Hämtar filter som tillämpas på filternivån. Standardfilternivån är visuell nivå.

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

Parametrar

filtersLevel
FiltersLevel

Returer

Promise<IFilter[]>

getPages()

Hämtar listan över sidor i rapporten – stöds inte i visuella objekt

function getPages(): Promise<Page[]>

Returer

Promise<Page[]>

getVisualDescriptor()

Hämtar det inbäddade visuella deskriptorobjektet som innehåller det visuella namnet, typen osv.

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

Returer

Promise<VisualDescriptor>

removeFilters(FiltersLevel)

Tar bort alla filter från den aktuella filternivån. Standardfilternivån är visuell nivå.

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

Parametrar

filtersLevel
FiltersLevel

Returer

Promise<IHttpPostMessageResponse<void>>

setFilters(IFilter[], FiltersLevel)

Anger filter på filternivå. Standardfilternivån är visuell nivå.

const filters: [
   ...
];

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

Parametrar

filters

IFilter[]

filtersLevel
FiltersLevel

Returer

Promise<IHttpPostMessageResponse<void>>

setPage(string)

Anger den aktiva sidan i rapporten – stöds inte i visuella objekt

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

Parametrar

_pageName

string

Returer

Promise<IHttpPostMessageResponse<void>>

updateFilters(FiltersOperations, IFilter[], FiltersLevel)

Uppdaterar filter på filternivå. Standardfilternivån är visuell nivå.

const filters: [
   ...
];

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

Parametrar

operation
FiltersOperations
filters

IFilter[]

filtersLevel
FiltersLevel

Returer

Promise<IHttpPostMessageResponse<void>>

Ärvd metodinformation

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

Lägg till snabbmenytilläggskommando.

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

Parametrar

commandName

string

commandTitle

string

contextMenuTitle

string

menuLocation
MenuLocation
visualName

string

visualType

string

groupName

string

Returer

Promise<IHttpPostMessageResponse<void>>

ärvd frånReport.addContextMenuCommand

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

Lägg till menytilläggskommando för alternativ.

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

Parametrar

commandName

string

commandTitle

string

optionsMenuTitle

string

menuLocation
MenuLocation
visualName

string

visualType

string

groupName

string

commandIcon

string

Returer

Promise<IHttpPostMessageResponse<void>>

ärvd frånReport.addOptionsMenuCommand

addPage(string)

Lägg till en tom sida i rapporten

// Add a page to the report with "Sales" as the page display name
report.addPage("Sales");
function addPage(displayName?: string): Promise<Page>

Parametrar

displayName

string

Returer

Promise<Page>

ärvd frånReport.addPage

applyTheme(IReportTheme)

Använda ett tema i rapporten

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

Parametrar

theme
IReportTheme

Returer

Promise<void>

ärvd frånReport.applyTheme

arePersistentFiltersApplied()

Returnerar om det finns användarens filter, utsnitt eller andra ändringar i datavyn som tillämpas på rapporten. Om beständiga filter är inaktiverade returneras false.

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

Returer

Promise<boolean>

ärvd frånReport.arePersistentFiltersApplied

clearSelectedVisuals(boolean)

Avmarkerar markerade visuella objekt som inte har poppats ut. Om flaggan skickas rensas alla visuella objektval.

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

Parametrar

clearPopOutState

boolean

Om valet av falska/odefinierade visuella objekt inte rensas om ett av de visuella objekten är i utspänd tillstånd (i fokus, visa som tabell, spotlight...)

Returer

Promise<void>

ärvd frånReport.clearSelectedVisuals

closeAllOverlays()

Stänger alla öppna snabbmenyer och knappbeskrivningar.

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

Returer

Promise<void>

ärvs frånReport.closeAllOverlays

configChanged(boolean)

Hantera konfigurationsändringar.

function configChanged(isBootstrap: boolean)

Parametrar

isBootstrap

boolean

ärvd frånReport.configChanged

deletePage(string)

Ta bort en sida från en rapport

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

Parametrar

pageName

string

Returer

Promise<void>

ärvd frånReport.deletePage

exitFullscreen()

Begär att webbläsaren avslutar fullskärmsläget.

function exitFullscreen()

ärvd frånReport.exitFullscreen

fullscreen()

Begär att webbläsaren ska återge komponentens iframe i fullskärmsläge.

function fullscreen()

ärvd frånReport.fullscreen

getActivePage()

Hämtar den aktiva rapportsidan.

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

Returer

Promise<Page>

ärvd frånReport.getActivePage

getCorrelationId()

Hämta correlationId för den aktuella inbäddningssessionen.

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

Returer

Promise<string>

ärvd frånReport.getCorrelationId

getId()

Hämtar rapport-ID:t från den första tillgängliga platsen: alternativ, attribut, inbäddnings-URL.

function getId(): string

Returer

string

ärvd frånReport.getId

getPageByName(string)

Hämtar en rapportsida med dess namn.

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

Parametrar

pageName

string

Returer

Promise<Page>

ärvd frånReport.getPageByName

getTheme()

hämta rapportens tema

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

Returer

Promise<IReportTheme>

ärvd frånReport.getTheme

getZoom()

Returnera rapportens aktuella zoomnivå.

function getZoom(): Promise<number>

Returer

Promise<number>

ärvd frånReport.getZoom

isSaved()

kontrollerar om rapporten sparas.

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

Returer

Promise<boolean>

ärvs frånReport.isSaved

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

Uppdaterar positionen för ett visuellt objekt på en sida.

report.moveVisual(pageName, visualName, x, y, z)
  .catch(error => { ... });
function moveVisual(pageName: string, visualName: string, x: number, y: number, z?: number): Promise<IHttpPostMessageResponse<void>>

Parametrar

pageName

string

visualName

string

x

number

y

number

z

number

Returer

Promise<IHttpPostMessageResponse<void>>

ärvs frånReport.moveVisual

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

Tar bort en eller flera händelsehanterare från listan över hanterare. Om en referens till den befintliga referensfunktionen har angetts tar du bort den specifika hanteraren. Om hanteraren inte har angetts tar du bort alla hanterare för det angivna händelsenamnet.

report.off('pageChanged')

or

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

report.off('pageChanged', logHandler);
function off<T>(eventName: string, handler?: IEventHandler<T>)

Parametrar

eventName

string

handler

IEventHandler<T>

ärvd frånReport.off

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

Lägger till en händelsehanterare för en viss händelse.

report.on('pageChanged', (event) => {
  console.log('PageChanged: ', event.page.name);
});
function on<T>(eventName: string, handler: IEventHandler<T>)

Parametrar

eventName

string

handler

IEventHandler<T>

ärvd frånReport.on

print()

Skriver ut den aktiva sidan i rapporten genom att anropa window.print() på komponenten embed iframe.

function print(): Promise<void>

Returer

Promise<void>

ärvd frånReport.print

refresh()

Uppdaterar datakällor för rapporten.

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

Returer

Promise<void>

ärvs frånReport.refresh

reload()

Läser in inbäddningen igen med hjälp av befintlig konfiguration. T.ex. För rapporter rensar detta effektivt alla filter och gör den första sidan aktiv som simulerar återställning av en rapport tillbaka till inläst tillstånd.

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

Returer

Promise<void>

ärvs frånReport.reload

removeComponentTabIndex(number)

Tar bort elementets tabindexattribut

function removeComponentTabIndex(_tabIndex?: number)

Parametrar

_tabIndex

number

ärvd frånReport.removeComponentTabIndex

removeContextMenuCommand(string, string)

Ta bort kommandot för snabbmenytillägg.

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

Parametrar

commandName

string

contextMenuTitle

string

Returer

Promise<IHttpPostMessageResponse<void>>

ärvd frånReport.removeContextMenuCommand

removeOptionsMenuCommand(string, string)

Kommandot Ta bort alternativ för menytillägg.

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

Parametrar

commandName

string

optionsMenuTitle

string

Returer

Promise<IHttpPostMessageResponse<void>>

ärvd frånReport.removeOptionsMenuCommand

renamePage(string, string)

Byt namn på en sida från en rapport

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

Parametrar

pageName

string

displayName

string

Returer

Promise<void>

ärvd frånReport.renamePage

resetPersistentFilters()

Återställa användarens filter, utsnitt och andra datavyändringar till standardtillståndet för rapporten

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

Returer

Promise<IHttpPostMessageResponse<void>>

ärvs frånReport.resetPersistentFilters

resetTheme()

Återställa och tillämpa standardtemat i rapporten

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

Returer

Promise<void>

ärvs frånReport.resetTheme

resizeActivePage(PageSizeType, number, number)

Uppdaterar storleken på den aktiva sidan i rapporten.

report.resizeActivePage(pageSizeType, width, height)
  .catch(error => { ... });
function resizeActivePage(pageSizeType: PageSizeType, width?: number, height?: number): Promise<IHttpPostMessageResponse<void>>

Parametrar

pageSizeType
PageSizeType
width

number

height

number

Returer

Promise<IHttpPostMessageResponse<void>>

ärvs frånReport.resizeActivePage

resizeVisual(string, string, number, number)

Ändra storlek på ett visuellt objekt på en sida.

report.resizeVisual(pageName, visualName, width, height)
  .catch(error => { ... });
function resizeVisual(pageName: string, visualName: string, width: number, height: number): Promise<IHttpPostMessageResponse<void>>

Parametrar

pageName

string

visualName

string

width

number

height

number

Returer

Promise<IHttpPostMessageResponse<void>>

ärvs frånReport.resizeVisual

save()

Sparar rapport.

function save(): Promise<void>

Returer

Promise<void>

ärvs frånReport.save

saveAs(ISaveAsParameters)

SaveAs-rapport.

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

Parametrar

saveAsParameters
ISaveAsParameters

Returer

Promise<void>

ärvs frånReport.saveAs

savePersistentFilters()

Spara användarens filter, utsnitt och andra ändringar i datavyn i rapporten

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

Returer

Promise<IHttpPostMessageResponse<void>>

ärvs frånReport.savePersistentFilters

setAccessToken(string)

Ange accessToken.

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

Parametrar

accessToken

string

Returer

Promise<void>

ärvd frånReport.setAccessToken

setComponentTabIndex(number)

Anger elementets tabindexattribut

function setComponentTabIndex(tabIndex?: number)

Parametrar

tabIndex

number

ärvd frånReport.setComponentTabIndex

setComponentTitle(string)

Ange komponentrubriken för hjälpmedel. Om det gäller iframes ändrar den här metoden iframe-rubriken.

function setComponentTitle(title: string)

Parametrar

title

string

Ärvd frånReport.setComponentTitle

setVisualDisplayState(string, string, VisualContainerDisplayMode)

Uppdaterar visningstillståndet för ett visuellt objekt på en sida.

report.setVisualDisplayState(pageName, visualName, displayState)
  .catch(error => { ... });
function setVisualDisplayState(pageName: string, visualName: string, displayState: VisualContainerDisplayMode): Promise<IHttpPostMessageResponse<void>>

Parametrar

pageName

string

visualName

string

Returer

Promise<IHttpPostMessageResponse<void>>

Ärvd frånReport.setVisualDisplayState

setZoom(number)

Anger rapportens zoomnivå.

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

Parametrar

zoomLevel

number

zoomnivå som ska ställas in

Returer

Promise<void>

ärvd frånReport.setZoom

switchLayout(LayoutType)

Uppdaterar rapportlayouten

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

Parametrar

layoutType
LayoutType

Returer

Promise<IHttpPostMessageResponse<void>>

ärvs frånReport.switchLayout

switchMode(string | ViewMode)

Växla rapportvyläge.

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

Parametrar

viewMode

string | ViewMode

Returer

Promise<void>

ärvd frånReport.switchMode

updateSettings(ISettings)

Uppdaterar synlighetsinställningarna för filterfönstret och sidnavigeringsfönstret.

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

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

Parametrar

settings
ISettings

Returer

Promise<IHttpPostMessageResponse<void>>

ärvs frånReport.updateInställningar