Report class
Power BI レポート埋め込みコンポーネント
- Extends
-
Embed
プロパティ
bookmarks |
メソッド
add |
コンテキスト メニュー拡張機能コマンドを追加します。
|
add |
オプション メニュー拡張機能コマンドを追加します。
|
add |
空のページをレポートに追加する
|
apply |
レポートにテーマを適用する
|
are |
レポートにユーザーのフィルター、スライサー、またはその他のデータ ビューの変更が適用されている場合に返します。 永続的なフィルターが無効な場合は、false を返します。
|
clear |
選択したビジュアルがポップアウトされていない場合はクリアします。フラグが渡されると、すべてのビジュアルの選択がクリアされます。
|
close |
開いているすべてのコンテキスト メニューとツールヒントを閉じます。
|
config |
構成の変更を処理します。 |
delete |
レポートからページを削除する
|
get |
アクティブなレポート ページを取得します。
|
get |
レポート レベルで適用されるフィルターを取得します。
|
get |
使用可能な最初の場所 (オプション、属性、埋め込み URL) からレポート ID を取得します。 |
get |
レポート ページを名前で取得します。
|
get |
レポート内のページの一覧を取得します。
|
get |
レポートのテーマを取得する
|
get |
レポートの現在のズーム レベルを返します。 |
is |
は、レポートが保存されているかどうかを確認します。
|
move |
ページ内のビジュアルの位置を更新します。
|
print() | 埋め込み iframe コンポーネントで |
refresh() | レポートのデータ ソースを更新します。
|
remove |
コンテキスト メニュー拡張機能コマンドを削除します。
|
remove |
レポート レベルのすべてのフィルターを削除します。
|
remove |
オプション メニュー拡張機能コマンドを削除します。
|
rename |
レポートからページの名前を変更する
|
render(IReport |
フェーズ埋め込み API を使用して事前に読み込まれたレポートを表示する
|
reset |
ユーザーのフィルター、スライサー、およびその他のデータ ビューの変更をレポートの既定の状態にリセットする
|
reset |
レポートの既定のテーマをリセットして適用する
|
resize |
レポート内のアクティブなページのサイズを更新します。
|
resize |
ページ内のビジュアルのサイズを変更します。
|
save |
レポートのユーザーのフィルター、スライサー、およびその他のデータ ビューの変更を保存する
|
set |
レポート レベルでフィルターを設定します。
|
set |
レポートのアクティブなページを設定します。
|
set |
ページ内のビジュアルの表示状態を更新します。
|
set |
レポートのズーム レベルを設定します。 |
switch |
レポート レイアウトを更新します
|
switch |
レポート ビュー モードを切り替えます。 |
update |
操作に従って、レポート レベルでフィルターを更新します。追加、すべて置換、ターゲットで置き換えるか、削除します。
|
update |
フィルター ウィンドウとページ ナビゲーション ウィンドウの表示設定を更新します。
|
継承されたメソッド
exit |
全画面表示モードを終了するようにブラウザーに要求します。 |
fullscreen() | コンポーネントの iframe を全画面表示モードでレンダリングするようにブラウザーに要求します。 |
get |
現在の埋め込みセッションの correlationId を取得します。
|
off<T>(string, IEvent |
ハンドラーの一覧から 1 つ以上のイベント ハンドラーを削除します。 既存のハンドル関数への参照が指定されている場合は、特定のハンドラーを削除します。 ハンドラーが指定されていない場合は、指定されたイベント名のすべてのハンドラーを削除します。
|
on<T>(string, IEvent |
特定のイベントのイベント ハンドラーを追加します。
|
reload() | 既存の構成を使用して埋め込みを再読み込みします。 たとえば、レポートの場合、これは効果的にすべてのフィルターをクリアし、レポートを読み込まれた状態にリセットすることをシミュレートする最初のページをアクティブにします。
|
remove |
要素の tabindex 属性を削除します。 |
save() | レポートを保存します。 |
save |
SaveAs レポート。 |
set |
accessToken を設定します。 |
set |
要素の tabindex 属性を設定します。 |
set |
アクセシビリティのコンポーネント タイトルを設定します。 iframe の場合、このメソッドは iframe タイトルを変更します。 |
プロパティの詳細
bookmarksManager
メソッドの詳細
addContextMenuCommand(string, string, string, MenuLocation, string, string, string)
コンテキスト メニュー拡張機能コマンドを追加します。
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>>
パラメーター
- commandName
-
string
- commandTitle
-
string
- contextMenuTitle
-
string
- menuLocation
- MenuLocation
- visualName
-
string
- visualType
-
string
- groupName
-
string
戻り値
Promise<IHttpPostMessageResponse<void>>
addOptionsMenuCommand(string, string, string, MenuLocation, string, string, string, string)
オプション メニュー拡張機能コマンドを追加します。
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>>
パラメーター
- commandName
-
string
- commandTitle
-
string
- optionsMenuTitle
-
string
- menuLocation
- MenuLocation
- visualName
-
string
- visualType
-
string
- groupName
-
string
- commandIcon
-
string
戻り値
Promise<IHttpPostMessageResponse<void>>
addPage(string)
空のページをレポートに追加する
// Add a page to the report with "Sales" as the page display name
report.addPage("Sales");
function addPage(displayName?: string): Promise<Page>
パラメーター
- displayName
-
string
戻り値
Promise<Page>
applyTheme(IReportTheme)
レポートにテーマを適用する
report.applyTheme(theme);
function applyTheme(theme: IReportTheme): Promise<void>
パラメーター
- theme
- IReportTheme
戻り値
Promise<void>
arePersistentFiltersApplied()
レポートにユーザーのフィルター、スライサー、またはその他のデータ ビューの変更が適用されている場合に返します。 永続的なフィルターが無効な場合は、false を返します。
report.arePersistentFiltersApplied();
function arePersistentFiltersApplied(): Promise<boolean>
戻り値
Promise<boolean>
clearSelectedVisuals(boolean)
選択したビジュアルがポップアウトされていない場合はクリアします。フラグが渡されると、すべてのビジュアルの選択がクリアされます。
report.clearSelectedVisuals()
.then(() => {
...
});
function clearSelectedVisuals(clearPopOutState?: boolean): Promise<void>
パラメーター
- clearPopOutState
-
boolean
ビジュアルの 1 つがポップ アウト状態の場合、false または未定義のビジュアルの選択がクリアされない場合 (フォーカス、テーブル、スポットライトとして表示)。)
戻り値
Promise<void>
closeAllOverlays()
開いているすべてのコンテキスト メニューとツールヒントを閉じます。
report.closeAllOverlays()
.then(() => {
...
});
function closeAllOverlays(): Promise<void>
戻り値
Promise<void>
configChanged(boolean)
構成の変更を処理します。
function configChanged(isBootstrap: boolean)
パラメーター
- isBootstrap
-
boolean
deletePage(string)
レポートからページを削除する
// 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>
パラメーター
- pageName
-
string
戻り値
Promise<void>
getActivePage()
アクティブなレポート ページを取得します。
report.getActivePage()
.then(activePage => {
...
});
function getActivePage(): Promise<Page>
戻り値
Promise<Page>
getFilters()
レポート レベルで適用されるフィルターを取得します。
// Get filters applied at report level
report.getFilters()
.then(filters => {
...
});
function getFilters(): Promise<IFilter[]>
戻り値
Promise<IFilter[]>
getId()
使用可能な最初の場所 (オプション、属性、埋め込み URL) からレポート ID を取得します。
function getId(): string
戻り値
string
getPageByName(string)
レポート ページを名前で取得します。
report.getPageByName(pageName)
.then(page => {
...
});
function getPageByName(pageName: string): Promise<Page>
パラメーター
- pageName
-
string
戻り値
Promise<Page>
getPages()
レポート内のページの一覧を取得します。
report.getPages()
.then(pages => {
...
});
function getPages(): Promise<Page[]>
戻り値
Promise<Page[]>
getTheme()
レポートのテーマを取得する
report.getTheme();
function getTheme(): Promise<IReportTheme>
戻り値
Promise<IReportTheme>
getZoom()
レポートの現在のズーム レベルを返します。
function getZoom(): Promise<number>
戻り値
Promise<number>
isSaved()
は、レポートが保存されているかどうかを確認します。
report.isSaved()
function isSaved(): Promise<boolean>
戻り値
Promise<boolean>
moveVisual(string, string, number, number, number)
ページ内のビジュアルの位置を更新します。
report.moveVisual(pageName, visualName, x, y, z)
.catch(error => { ... });
function moveVisual(pageName: string, visualName: string, x: number, y: number, z?: number): Promise<IHttpPostMessageResponse<void>>
パラメーター
- pageName
-
string
- visualName
-
string
- x
-
number
- y
-
number
- z
-
number
戻り値
Promise<IHttpPostMessageResponse<void>>
print()
埋め込み iframe コンポーネントで window.print()
を呼び出して、レポートのアクティブなページを出力します。
function print(): Promise<void>
戻り値
Promise<void>
refresh()
レポートのデータ ソースを更新します。
report.refresh();
function refresh(): Promise<void>
戻り値
Promise<void>
removeContextMenuCommand(string, string)
コンテキスト メニュー拡張機能コマンドを削除します。
report.removeContextMenuCommand(commandName, contextMenuTitle)
.catch(error => {
...
});
function removeContextMenuCommand(commandName: string, contextMenuTitle: string): Promise<IHttpPostMessageResponse<void>>
パラメーター
- commandName
-
string
- contextMenuTitle
-
string
戻り値
Promise<IHttpPostMessageResponse<void>>
removeFilters()
レポート レベルのすべてのフィルターを削除します。
report.removeFilters();
function removeFilters(): Promise<IHttpPostMessageResponse<void>>
戻り値
Promise<IHttpPostMessageResponse<void>>
removeOptionsMenuCommand(string, string)
オプション メニュー拡張機能コマンドを削除します。
report.removeOptionsMenuCommand(commandName, optionsMenuTitle)
.then({
...
});
function removeOptionsMenuCommand(commandName: string, optionsMenuTitle: string): Promise<IHttpPostMessageResponse<void>>
パラメーター
- commandName
-
string
- optionsMenuTitle
-
string
戻り値
Promise<IHttpPostMessageResponse<void>>
renamePage(string, string)
レポートからページの名前を変更する
// 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>
パラメーター
- pageName
-
string
- displayName
-
string
戻り値
Promise<void>
render(IReportEmbedConfiguration | IReportLoadConfiguration)
フェーズ埋め込み API を使用して事前に読み込まれたレポートを表示する
// Load report
var report = powerbi.load(element, config);
...
// Render report
report.render()
function render(config?: IReportEmbedConfiguration | IReportLoadConfiguration): Promise<void>
パラメーター
戻り値
Promise<void>
resetPersistentFilters()
ユーザーのフィルター、スライサー、およびその他のデータ ビューの変更をレポートの既定の状態にリセットする
report.resetPersistentFilters();
function resetPersistentFilters(): Promise<IHttpPostMessageResponse<void>>
戻り値
Promise<IHttpPostMessageResponse<void>>
resetTheme()
レポートの既定のテーマをリセットして適用する
report.resetTheme();
function resetTheme(): Promise<void>
戻り値
Promise<void>
resizeActivePage(PageSizeType, number, number)
レポート内のアクティブなページのサイズを更新します。
report.resizeActivePage(pageSizeType, width, height)
.catch(error => { ... });
function resizeActivePage(pageSizeType: PageSizeType, width?: number, height?: number): Promise<IHttpPostMessageResponse<void>>
パラメーター
- pageSizeType
- PageSizeType
- width
-
number
- height
-
number
戻り値
Promise<IHttpPostMessageResponse<void>>
resizeVisual(string, string, number, number)
ページ内のビジュアルのサイズを変更します。
report.resizeVisual(pageName, visualName, width, height)
.catch(error => { ... });
function resizeVisual(pageName: string, visualName: string, width: number, height: number): Promise<IHttpPostMessageResponse<void>>
パラメーター
- pageName
-
string
- visualName
-
string
- width
-
number
- height
-
number
戻り値
Promise<IHttpPostMessageResponse<void>>
savePersistentFilters()
レポートのユーザーのフィルター、スライサー、およびその他のデータ ビューの変更を保存する
report.savePersistentFilters();
function savePersistentFilters(): Promise<IHttpPostMessageResponse<void>>
戻り値
Promise<IHttpPostMessageResponse<void>>
setFilters(IFilter[])
レポート レベルでフィルターを設定します。
const filters: [
...
];
report.setFilters(filters)
.catch(errors => {
...
});
function setFilters(filters: IFilter[]): Promise<IHttpPostMessageResponse<void>>
パラメーター
- filters
-
IFilter[]
戻り値
Promise<IHttpPostMessageResponse<void>>
setPage(string)
レポートのアクティブなページを設定します。
report.setPage("page2")
.catch(error => { ... });
function setPage(pageName: string): Promise<IHttpPostMessageResponse<void>>
パラメーター
- pageName
-
string
戻り値
Promise<IHttpPostMessageResponse<void>>
setVisualDisplayState(string, string, VisualContainerDisplayMode)
ページ内のビジュアルの表示状態を更新します。
report.setVisualDisplayState(pageName, visualName, displayState)
.catch(error => { ... });
function setVisualDisplayState(pageName: string, visualName: string, displayState: VisualContainerDisplayMode): Promise<IHttpPostMessageResponse<void>>
パラメーター
- pageName
-
string
- visualName
-
string
- displayState
- VisualContainerDisplayMode
戻り値
Promise<IHttpPostMessageResponse<void>>
setZoom(number)
レポートのズーム レベルを設定します。
function setZoom(zoomLevel: number): Promise<void>
パラメーター
- zoomLevel
-
number
設定するズーム レベル
戻り値
Promise<void>
switchLayout(LayoutType)
レポート レイアウトを更新します
report.switchLayout(layoutType);
function switchLayout(layoutType: LayoutType): Promise<IHttpPostMessageResponse<void>>
パラメーター
- layoutType
- LayoutType
戻り値
Promise<IHttpPostMessageResponse<void>>
switchMode(string | ViewMode)
レポート ビュー モードを切り替えます。
function switchMode(viewMode: string | ViewMode): Promise<void>
パラメーター
- viewMode
-
string | ViewMode
戻り値
Promise<void>
updateFilters(FiltersOperations, IFilter[])
操作に従って、レポート レベルでフィルターを更新します。追加、すべて置換、ターゲットで置き換えるか、削除します。
report.updateFilters(FiltersOperations.Add, filters)
.catch(errors => { ... });
function updateFilters(operation: FiltersOperations, filters?: IFilter[]): Promise<IHttpPostMessageResponse<void>>
パラメーター
- operation
- FiltersOperations
- filters
-
IFilter[]
戻り値
Promise<IHttpPostMessageResponse<void>>
updateSettings(ISettings)
フィルター ウィンドウとページ ナビゲーション ウィンドウの表示設定を更新します。
const newSettings = {
panes: {
filters: {
visible: false
}
}
};
report.updateSettings(newSettings)
.catch(error => { ... });
function updateSettings(settings: ISettings): Promise<IHttpPostMessageResponse<void>>
パラメーター
- settings
- ISettings
戻り値
Promise<IHttpPostMessageResponse<void>>
継承済みメソッドの詳細
exitFullscreen()
全画面表示モードを終了するようにブラウザーに要求します。
function exitFullscreen()
Embed.exitFullscreen から継承された
fullscreen()
コンポーネントの iframe を全画面表示モードでレンダリングするようにブラウザーに要求します。
function fullscreen()
Embed.fullscreen から継承された
getCorrelationId()
現在の埋め込みセッションの correlationId を取得します。
// Get the correlationId for the current embed session
report.getCorrelationId()
.then(correlationId => {
...
});
function getCorrelationId(): Promise<string>
戻り値
Promise<string>
Embed.getCorrelationId から継承された
off<T>(string, IEventHandler<T>)
ハンドラーの一覧から 1 つ以上のイベント ハンドラーを削除します。 既存のハンドル関数への参照が指定されている場合は、特定のハンドラーを削除します。 ハンドラーが指定されていない場合は、指定されたイベント名のすべてのハンドラーを削除します。
report.off('pageChanged')
or
const logHandler = function (event) {
console.log(event);
};
report.off('pageChanged', logHandler);
function off<T>(eventName: string, handler?: IEventHandler<T>)
パラメーター
- eventName
-
string
- handler
-
IEventHandler<T>
Embed.off から継承された
on<T>(string, IEventHandler<T>)
特定のイベントのイベント ハンドラーを追加します。
report.on('pageChanged', (event) => {
console.log('PageChanged: ', event.page.name);
});
function on<T>(eventName: string, handler: IEventHandler<T>)
パラメーター
- eventName
-
string
- handler
-
IEventHandler<T>
Embed.on から継承された
reload()
既存の構成を使用して埋め込みを再読み込みします。 たとえば、レポートの場合、これは効果的にすべてのフィルターをクリアし、レポートを読み込まれた状態にリセットすることをシミュレートする最初のページをアクティブにします。
report.reload();
function reload(): Promise<void>
戻り値
Promise<void>
Embed.reload から継承された
removeComponentTabIndex(number)
要素の tabindex 属性を削除します。
function removeComponentTabIndex(_tabIndex?: number)
パラメーター
- _tabIndex
-
number
Embed.removeComponentTabIndex から継承された
save()
レポートを保存します。
function save(): Promise<void>
戻り値
Promise<void>
Embed.save から継承された
saveAs(ISaveAsParameters)
SaveAs レポート。
function saveAs(saveAsParameters: ISaveAsParameters): Promise<void>
パラメーター
- saveAsParameters
- ISaveAsParameters
戻り値
Promise<void>
Embed.saveAs から継承された
setAccessToken(string)
accessToken を設定します。
function setAccessToken(accessToken: string): Promise<void>
パラメーター
- accessToken
-
string
戻り値
Promise<void>
Embed.setAccessToken から継承された
setComponentTabIndex(number)
要素の tabindex 属性を設定します。
function setComponentTabIndex(tabIndex?: number)
パラメーター
- tabIndex
-
number
Embed.setComponentTabIndex から継承された
setComponentTitle(string)
アクセシビリティのコンポーネント タイトルを設定します。 iframe の場合、このメソッドは iframe タイトルを変更します。
function setComponentTitle(title: string)
パラメーター
- title
-
string
Embed.setComponentTitle から継承された