Report class
Składnik osadzania raportu usługi Power BI
- Rozszerzenie
-
Embed
Właściwości
bookmarks |
Metody
add |
Dodaj polecenie rozszerzenia menu kontekstowego.
|
add |
Dodaj polecenie rozszerzenia menu opcje.
|
add |
Dodawanie pustej strony do raportu
|
apply |
Stosowanie motywu do raportu
|
are |
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.
|
clear |
Czyści zaznaczone wizualizacje niezmapowane, jeśli flaga zostanie przekazana, wszystkie wybrane wizualizacje zostaną wyczyszczone.
|
close |
Zamyka wszystkie otwarte menu kontekstowe i etykietki narzędzi.
|
config |
Obsługa zmian konfiguracji. |
delete |
Usuwanie strony z raportu
|
get |
Pobiera aktywną stronę raportu.
|
get |
Pobiera filtry, które są stosowane na poziomie raportu.
|
get |
Pobiera identyfikator raportu z pierwszej dostępnej lokalizacji: opcje, atrybut, adres URL osadzania. |
get |
Pobiera stronę raportu według jego nazwy.
|
get |
Pobiera listę stron w raporcie.
|
get |
pobieranie motywu raportu
|
get |
Zwróć bieżący poziom powiększenia raportu. |
is |
sprawdza, czy raport jest zapisany.
|
move |
Aktualizuje położenie wizualizacji na stronie.
|
print() | Drukuje aktywną stronę raportu, wywołując |
refresh() | Odświeża źródła danych dla raportu.
|
remove |
Usuń polecenie rozszerzenia menu kontekstowego.
|
remove |
Usuwa wszystkie filtry na poziomie raportu.
|
remove |
Usuń polecenie rozszerzenia menu opcji.
|
rename |
Zmienianie nazwy strony z raportu
|
render(IReport |
Renderowanie wstępnie załadowanego raportu przy użyciu interfejsu API osadzania etapowego
|
reset |
Resetowanie filtrów, fragmentatorów i innych widoków danych użytkownika zmienia się na domyślny stan raportu
|
reset |
Resetowanie i stosowanie motywu domyślnego raportu
|
resize |
Aktualizuje rozmiar aktywnej strony w raporcie.
|
resize |
Zmienianie rozmiaru wizualizacji na stronie.
|
save |
Zapisywanie filtrów, fragmentatorów i innych zmian widoku danych raportu
|
set |
Ustawia filtry na poziomie raportu.
|
set |
Ustawia aktywną stronę raportu.
|
set |
Aktualizuje stan wyświetlania wizualizacji na stronie.
|
set |
Ustawia poziom powiększenia raportu. |
switch |
Aktualizuje układ raportu
|
switch |
Przełącz tryb widoku raportu. |
update |
Zaktualizuj filtry na poziomie raportu zgodnie z operacją: Dodaj, zastąp wszystkie, zastąp elementem docelowym lub usuń.
|
update |
Aktualizuje ustawienia widoczności okienka filtru i okienka nawigacji strony.
|
Metody dziedziczone
exit |
Żąda, aby przeglądarka zakończyła tryb pełnoekranowy. |
fullscreen() | Żąda przeglądarki renderowania elementu iframe składnika w trybie pełnoekranowym. |
get |
Pobierz identyfikator correlationId dla bieżącej sesji osadzania.
|
off<T>(string, IEvent |
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.
|
on<T>(string, IEvent |
Dodaje procedurę obsługi zdarzeń dla określonego zdarzenia.
|
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.
|
remove |
Usuwa atrybut tabindex elementu |
save() | Zapisuje raport. |
save |
ZapiszAs raport. |
set |
Ustaw wartość accessToken. |
set |
Ustawia atrybut tabindex elementu |
set |
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
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
- displayState
- VisualContainerDisplayMode
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