Udostępnij za pośrednictwem


Report class

Składnik osadzania raportu usługi Power BI

Rozszerzenie

Embed

Właściwości

bookmarksManager

Metody

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

Dodaj polecenie rozszerzenia menu kontekstowego.

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

Dodaj polecenie rozszerzenia menu opcje.

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

Dodawanie pustej strony do raportu

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

Stosowanie motywu do raportu

report.applyTheme(theme);
arePersistentFiltersApplied()

Zwraca wartość, jeśli istnieją filtry, fragmentatory lub inne zmiany widoku danych zastosowane w raporcie. Jeśli filtry trwałe są wyłączone, zwraca wartość false.

report.arePersistentFiltersApplied();
clearSelectedVisuals(boolean)

Czyści zaznaczone wizualizacje niezmapowane, jeśli flaga zostanie przekazana, wszystkie wybrane wizualizacje zostaną wyczyszczone.

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

Zamyka wszystkie otwarte menu kontekstowe i etykietki narzędzi.

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

Obsługa zmian konfiguracji.

deletePage(string)

Usuwanie strony z raportu

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

Pobiera aktywną stronę raportu.

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

Pobiera filtry, które są stosowane na poziomie raportu.

// Get filters applied at report level
report.getFilters()
  .then(filters => {
    ...
  });
getId()

Pobiera identyfikator raportu z pierwszej dostępnej lokalizacji: opcje, atrybut, adres URL osadzania.

getPageByName(string)

Pobiera stronę raportu według jego nazwy.

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

Pobiera listę stron w raporcie.

report.getPages()
 .then(pages => {
     ...
 });
getTheme()

pobieranie motywu raportu

report.getTheme();
getZoom()

Zwróć bieżący poziom powiększenia raportu.

isSaved()

sprawdza, czy raport jest zapisany.

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

Aktualizuje położenie wizualizacji na stronie.

report.moveVisual(pageName, visualName, x, y, z)
  .catch(error => { ... });
print()

Drukuje aktywną stronę raportu, wywołując window.print() w składniku osadzania elementu iframe.

refresh()

Odświeża źródła danych dla raportu.

report.refresh();
removeContextMenuCommand(string, string)

Usuń polecenie rozszerzenia menu kontekstowego.

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

Usuwa wszystkie filtry na poziomie raportu.

report.removeFilters();
removeOptionsMenuCommand(string, string)

Usuń polecenie rozszerzenia menu opcji.

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

Zmienianie nazwy strony z raportu

// 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");
render(IReportEmbedConfiguration | IReportLoadConfiguration)

Renderowanie wstępnie załadowanego raportu przy użyciu interfejsu API osadzania etapowego

// Load report
var report = powerbi.load(element, config);

...

// Render report
report.render()
resetPersistentFilters()

Resetowanie filtrów, fragmentatorów i innych widoków danych użytkownika zmienia się na domyślny stan raportu

report.resetPersistentFilters();
resetTheme()

Resetowanie i stosowanie motywu domyślnego raportu

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

Aktualizuje rozmiar aktywnej strony w raporcie.

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

Zmienianie rozmiaru wizualizacji na stronie.

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

Zapisywanie filtrów, fragmentatorów i innych zmian widoku danych raportu

report.savePersistentFilters();
setFilters(IFilter[])

Ustawia filtry na poziomie raportu.

const filters: [
   ...
];

report.setFilters(filters)
 .catch(errors => {
   ...
 });
setPage(string)

Ustawia aktywną stronę raportu.

report.setPage("page2")
 .catch(error => { ... });
setVisualDisplayState(string, string, VisualContainerDisplayMode)

Aktualizuje stan wyświetlania wizualizacji na stronie.

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

Ustawia poziom powiększenia raportu.

switchLayout(LayoutType)

Aktualizuje układ raportu

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

Przełącz tryb widoku raportu.

updateFilters(FiltersOperations, IFilter[])

Zaktualizuj filtry na poziomie raportu zgodnie z operacją: Dodaj, zastąp wszystkie, zastąp elementem docelowym lub usuń.

report.updateFilters(FiltersOperations.Add, filters)
  .catch(errors => { ... });
updateSettings(ISettings)

Aktualizuje ustawienia widoczności okienka filtru i okienka nawigacji strony.

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

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

Metody dziedziczone

exitFullscreen()

Żąda, aby przeglądarka zakończyła tryb pełnoekranowy.

fullscreen()

Żąda przeglądarki renderowania elementu iframe składnika w trybie pełnoekranowym.

getCorrelationId()

Pobierz identyfikator correlationId dla bieżącej sesji osadzania.

// Get the correlationId for the current embed session
report.getCorrelationId()
  .then(correlationId => {
    ...
  });
off<T>(string, IEventHandler<T>)

Usuwa co najmniej jeden program obsługi zdarzeń z listy procedur obsługi. Jeśli określono odwołanie do istniejącej funkcji dojścia, usuń określoną procedurę obsługi. Jeśli program obsługi nie zostanie określony, usuń wszystkie programy obsługi dla określonej nazwy zdarzenia.

report.off('pageChanged')

or

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

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

Dodaje procedurę obsługi zdarzeń dla określonego zdarzenia.

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

Ponownie ładuje osadzanie przy użyciu istniejącej konfiguracji. Na przykład w przypadku raportów skutecznie usuwa wszystkie filtry i uaktywnia pierwszą stronę, która symuluje zresetowanie raportu z powrotem do stanu załadowanego.

report.reload();
removeComponentTabIndex(number)

Usuwa atrybut tabindex elementu

save()

Zapisuje raport.

saveAs(ISaveAsParameters)

ZapiszAs raport.

setAccessToken(string)

Ustaw wartość accessToken.

setComponentTabIndex(number)

Ustawia atrybut tabindex elementu

setComponentTitle(string)

Ustaw tytuł składnika pod kątem ułatwień dostępu. W przypadku elementów iframe ta metoda zmieni tytuł elementu iframe.

Szczegóły właściwości

bookmarksManager

bookmarksManager: BookmarksManager

Wartość właściwości

Szczegóły metody

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

Dodaj polecenie rozszerzenia menu kontekstowego.

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

Parametry

commandName

string

commandTitle

string

contextMenuTitle

string

menuLocation
MenuLocation
visualName

string

visualType

string

groupName

string

Zwraca

Promise<IHttpPostMessageResponse<void>>

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

Dodaj polecenie rozszerzenia menu opcje.

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

Parametry

commandName

string

commandTitle

string

optionsMenuTitle

string

menuLocation
MenuLocation
visualName

string

visualType

string

groupName

string

commandIcon

string

Zwraca

Promise<IHttpPostMessageResponse<void>>

addPage(string)

Dodawanie pustej strony do raportu

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

Parametry

displayName

string

Zwraca

Promise<Page>

applyTheme(IReportTheme)

Stosowanie motywu do raportu

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

Parametry

theme
IReportTheme

Zwraca

Promise<void>

arePersistentFiltersApplied()

Zwraca wartość, jeśli istnieją filtry, fragmentatory lub inne zmiany widoku danych zastosowane w raporcie. Jeśli filtry trwałe są wyłączone, zwraca wartość false.

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

Zwraca

Promise<boolean>

clearSelectedVisuals(boolean)

Czyści zaznaczone wizualizacje niezmapowane, jeśli flaga zostanie przekazana, wszystkie wybrane wizualizacje zostaną wyczyszczone.

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

Parametry

clearPopOutState

boolean

Jeśli zaznaczenie wartości false/niezdefiniowanych wizualizacji nie zostanie wyczyszczone, jeśli jedna z wizualizacji jest w stanie wyskakowanym (w fokusie pokaż jako tabelę, w centrum uwagi...)

Zwraca

Promise<void>

closeAllOverlays()

Zamyka wszystkie otwarte menu kontekstowe i etykietki narzędzi.

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

Zwraca

Promise<void>

configChanged(boolean)

Obsługa zmian konfiguracji.

function configChanged(isBootstrap: boolean)

Parametry

isBootstrap

boolean

deletePage(string)

Usuwanie strony z raportu

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

Parametry

pageName

string

Zwraca

Promise<void>

getActivePage()

Pobiera aktywną stronę raportu.

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

Zwraca

Promise<Page>

getFilters()

Pobiera filtry, które są stosowane na poziomie raportu.

// Get filters applied at report level
report.getFilters()
  .then(filters => {
    ...
  });
function getFilters(): Promise<IFilter[]>

Zwraca

Promise<IFilter[]>

getId()

Pobiera identyfikator raportu z pierwszej dostępnej lokalizacji: opcje, atrybut, adres URL osadzania.

function getId(): string

Zwraca

string

getPageByName(string)

Pobiera stronę raportu według jego nazwy.

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

Parametry

pageName

string

Zwraca

Promise<Page>

getPages()

Pobiera listę stron w raporcie.

report.getPages()
 .then(pages => {
     ...
 });
function getPages(): Promise<Page[]>

Zwraca

Promise<Page[]>

getTheme()

pobieranie motywu raportu

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

Zwraca

Promise<IReportTheme>

getZoom()

Zwróć bieżący poziom powiększenia raportu.

function getZoom(): Promise<number>

Zwraca

Promise<number>

isSaved()

sprawdza, czy raport jest zapisany.

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

Zwraca

Promise<boolean>

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

Aktualizuje położenie wizualizacji na stronie.

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

Parametry

pageName

string

visualName

string

x

number

y

number

z

number

Zwraca

Promise<IHttpPostMessageResponse<void>>

print()

Drukuje aktywną stronę raportu, wywołując window.print() w składniku osadzania elementu iframe.

function print(): Promise<void>

Zwraca

Promise<void>

refresh()

Odświeża źródła danych dla raportu.

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

Zwraca

Promise<void>

removeContextMenuCommand(string, string)

Usuń polecenie rozszerzenia menu kontekstowego.

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

Parametry

commandName

string

contextMenuTitle

string

Zwraca

Promise<IHttpPostMessageResponse<void>>

removeFilters()

Usuwa wszystkie filtry na poziomie raportu.

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

Zwraca

Promise<IHttpPostMessageResponse<void>>

removeOptionsMenuCommand(string, string)

Usuń polecenie rozszerzenia menu opcji.

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

Parametry

commandName

string

optionsMenuTitle

string

Zwraca

Promise<IHttpPostMessageResponse<void>>

renamePage(string, string)

Zmienianie nazwy strony z raportu

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

Parametry

pageName

string

displayName

string

Zwraca

Promise<void>

render(IReportEmbedConfiguration | IReportLoadConfiguration)

Renderowanie wstępnie załadowanego raportu przy użyciu interfejsu API osadzania etapowego

// Load report
var report = powerbi.load(element, config);

...

// Render report
report.render()
function render(config?: IReportEmbedConfiguration | IReportLoadConfiguration): Promise<void>

Parametry

Zwraca

Promise<void>

resetPersistentFilters()

Resetowanie filtrów, fragmentatorów i innych widoków danych użytkownika zmienia się na domyślny stan raportu

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

Zwraca

Promise<IHttpPostMessageResponse<void>>

resetTheme()

Resetowanie i stosowanie motywu domyślnego raportu

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

Zwraca

Promise<void>

resizeActivePage(PageSizeType, number, number)

Aktualizuje rozmiar aktywnej strony w raporcie.

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

Parametry

pageSizeType
PageSizeType
width

number

height

number

Zwraca

Promise<IHttpPostMessageResponse<void>>

resizeVisual(string, string, number, number)

Zmienianie rozmiaru wizualizacji na stronie.

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

Parametry

pageName

string

visualName

string

width

number

height

number

Zwraca

Promise<IHttpPostMessageResponse<void>>

savePersistentFilters()

Zapisywanie filtrów, fragmentatorów i innych zmian widoku danych raportu

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

Zwraca

Promise<IHttpPostMessageResponse<void>>

setFilters(IFilter[])

Ustawia filtry na poziomie raportu.

const filters: [
   ...
];

report.setFilters(filters)
 .catch(errors => {
   ...
 });
function setFilters(filters: IFilter[]): Promise<IHttpPostMessageResponse<void>>

Parametry

filters

IFilter[]

Zwraca

Promise<IHttpPostMessageResponse<void>>

setPage(string)

Ustawia aktywną stronę raportu.

report.setPage("page2")
 .catch(error => { ... });
function setPage(pageName: string): Promise<IHttpPostMessageResponse<void>>

Parametry

pageName

string

Zwraca

Promise<IHttpPostMessageResponse<void>>

setVisualDisplayState(string, string, VisualContainerDisplayMode)

Aktualizuje stan wyświetlania wizualizacji na stronie.

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

Parametry

pageName

string

visualName

string

Zwraca

Promise<IHttpPostMessageResponse<void>>

setZoom(number)

Ustawia poziom powiększenia raportu.

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

Parametry

zoomLevel

number

poziom powiększenia do ustawienia

Zwraca

Promise<void>

switchLayout(LayoutType)

Aktualizuje układ raportu

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

Parametry

layoutType
LayoutType

Zwraca

Promise<IHttpPostMessageResponse<void>>

switchMode(string | ViewMode)

Przełącz tryb widoku raportu.

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

Parametry

viewMode

string | ViewMode

Zwraca

Promise<void>

updateFilters(FiltersOperations, IFilter[])

Zaktualizuj filtry na poziomie raportu zgodnie z operacją: Dodaj, zastąp wszystkie, zastąp elementem docelowym lub usuń.

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

Parametry

operation
FiltersOperations
filters

IFilter[]

Zwraca

Promise<IHttpPostMessageResponse<void>>

updateSettings(ISettings)

Aktualizuje ustawienia widoczności okienka filtru i okienka nawigacji strony.

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

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

Parametry

settings
ISettings

Zwraca

Promise<IHttpPostMessageResponse<void>>

Szczegóły metody dziedziczonej

exitFullscreen()

Żąda, aby przeglądarka zakończyła tryb pełnoekranowy.

function exitFullscreen()

dziedziczone z Embed.exitFullscreen

fullscreen()

Żąda przeglądarki renderowania elementu iframe składnika w trybie pełnoekranowym.

function fullscreen()

dziedziczone z Embed.fullscreen

getCorrelationId()

Pobierz identyfikator correlationId dla bieżącej sesji osadzania.

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

Zwraca

Promise<string>

dziedziczone z Embed.getCorrelationId

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

Usuwa co najmniej jeden program obsługi zdarzeń z listy procedur obsługi. Jeśli określono odwołanie do istniejącej funkcji dojścia, usuń określoną procedurę obsługi. Jeśli program obsługi nie zostanie określony, usuń wszystkie programy obsługi dla określonej nazwy zdarzenia.

report.off('pageChanged')

or

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

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

Parametry

eventName

string

handler

IEventHandler<T>

dziedziczone z Embed.off

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

Dodaje procedurę obsługi zdarzeń dla określonego zdarzenia.

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

Parametry

eventName

string

handler

IEventHandler<T>

dziedziczone z Embed.on

reload()

Ponownie ładuje osadzanie przy użyciu istniejącej konfiguracji. Na przykład w przypadku raportów skutecznie usuwa wszystkie filtry i uaktywnia pierwszą stronę, która symuluje zresetowanie raportu z powrotem do stanu załadowanego.

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

Zwraca

Promise<void>

dziedziczone z Embed.reload

removeComponentTabIndex(number)

Usuwa atrybut tabindex elementu

function removeComponentTabIndex(_tabIndex?: number)

Parametry

_tabIndex

number

dziedziczone z Embed.removeComponentTabIndex

save()

Zapisuje raport.

function save(): Promise<void>

Zwraca

Promise<void>

dziedziczone z Embed.save

saveAs(ISaveAsParameters)

ZapiszAs raport.

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

Parametry

saveAsParameters
ISaveAsParameters

Zwraca

Promise<void>

dziedziczone z Embed.saveAs

setAccessToken(string)

Ustaw wartość accessToken.

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

Parametry

accessToken

string

Zwraca

Promise<void>

dziedziczone z Embed.setAccessToken

setComponentTabIndex(number)

Ustawia atrybut tabindex elementu

function setComponentTabIndex(tabIndex?: number)

Parametry

tabIndex

number

dziedziczone z Embed.setComponentTabIndex

setComponentTitle(string)

Ustaw tytuł składnika pod kątem ułatwień dostępu. W przypadku elementów iframe ta metoda zmieni tytuł elementu iframe.

function setComponentTitle(title: string)

Parametry

title

string

dziedziczone z Embed.setComponentTitle