アクション バーを使用してユーザー エクスペリエンスを向上させる
組織のレポートを埋め込む場合、埋め込みコンテンツを表示するには、アプリケーション ユーザーが Power BI にサインインする必要があります。 ユーザーがサインインすると、ユーザーは自分が所有するレポート、または自分または他の組織のメンバーが共有するレポートにアクセスできるようになります。
組織用に埋め込むレポートのコンシューマーは、 クライアント API を使用して、アクション バー、個人用ブックマーク、永続的なフィルターなどのセルフサービス機能を利用できます。
アクション バー
組織の Power BI レポートを埋め込むと、レポート コンシューマーはレポート アクション バー を使用して、ビューのエクスポート、共有、変更、またはその他のいくつかのアクションを実行できます。
アクション バーの完全な機能を有効にすると、ユーザーは次のことができます。
- レポートをお気に入りに追加する
- 永続的なフィルターを使用する
- 個人用ブックマークを使用する
重要
完全なアクション バー機能を提供するには、Azure Active Directory (Azure AD) でアプリケーションの UserState.ReadWrite.All アクセス許可をユーザーに付与する必要があります。
アクション バーをレポート コンシューマーに表示するには、埋め込み構成にbars
設定を追加し、表示設定を にtrue
actionBar
設定します。
let embedConfig = {
...
settings: {
bars: {
actionBar: {
visible: true
}
}
}
};
アクション バーを表示すると、Power BI サービスと同じエクスペリエンスで、レポート ページの垂直方向の一覧が表示されます。 ユーザーはページ ナビゲーション ウィンドウを折りたたんで、レポートにさらに余裕を持たせることができます。
固定フィルター
永続的なフィルター は、セッションに対してレポート コンシューマーのフィルター、スライサー、およびその他のレポートの状態を保持します。 レポートコンシューマーは、レポートに戻るたびに同じフィルター処理手順を繰り返すことなく、すばやく分析情報にアクセスできます。 ユーザーは、Power BI サービス、モバイル、埋め込みシナリオで同じ永続的なレポートの状態を共有できます。
組織の埋め込みレポートで永続的なフィルターを有効にするには:
Power BI サービスまたはデスクトップ レポート設定で永続的なフィルターを有効にします。
アプリで Azure AD でのアクセス許可が許可
UserState.ReadWrite.All
されていることを確認します。persistentFiltersEnabled
埋め込み loadConfiguration 設定のプロパティを次の値にtrue
設定します。let config = { type: 'report', ... settings: { persistentFiltersEnabled: true } };
レポートは、ユーザーの最新のレポート状態 (存在する場合) と共に読み込まれます。 埋め込みレポートでは、コンシューマーはアクション バーの [既定にリセット ] ボタンを使用して永続的なフィルターを適用できます。
永続的なフィルターと関連する API の詳細については、「 永続的なフィルター」を参照してください。
個人用ブックマーク
組織用に埋め込むレポートでは、レポート コンシューマーは、フィルター、スライサー、ビジュアル状態などのレポート ページの状態をキャプチャし、わかりやすい名前を付けることで、 個人用ブックマーク を作成できます。 その後、ユーザーはブックマークを選択することで、これらの状態にすばやく戻ることができます。 個人用ブックマークは作成者のみが使用でき、作成にはレポートの書き込みアクセス許可は必要ありません。
レポート コンシューマーは、埋め込みレポートとPower BI サービスで同じ個人用ブックマークを使用できます。 ユーザーは、個人用ブックマークを既定のビューにして、レポートを開くたびにお気に入りのビューを表示できます。
組織の埋め込みレポートで個人用ブックマークを有効にするには:
アプリで Azure AD でのアクセス許可が許可
UserState.ReadWrite.All
されていることを確認します。personalBookmarksEnabled
埋め込み loadConfiguration 設定のプロパティを次の値にtrue
設定します。let config = { type: 'report', ... settings: { personalBookmarksEnabled: true } };
ブックマーク ウィンドウをレポートに表示します。
ブックマーク ウィンドウをレポートに表示するには、2 つの方法があります。 1 つ目のオプションは、ユーザーがブックマーク ウィンドウを開いたり閉じるための [ブックマーク] ボタンがあるレポート アクション バーを表示することです。
2 つ目のオプションは、レポート設定のウィンドウ オブジェクトを使用して、プログラムによってブックマーク ウィンドウ を表示および非表示にすることです。
let embedConfig = {
...
settings: {
panes: {
bookmarks: {
visible: true
}
}
}
};
実行時にレポート設定を更新するには、メソッドを使用します。実行時のレポート設定のupdateSettings
更新に関する記事を参照してください。
個人用ブックマークの詳細については、「 個人用ブックマーク」を参照してください。
制限事項
Power BI 埋め込み分析では、永続的なフィルターと個人用ブックマーク機能は既定で無効になっています。 これらの機能は、組織のレポートを埋め込む場合にのみサポートされます。顧客用に埋め込む場合はサポートされません。
アクション バーを表示すると、ページ ナビゲーションを左側のウィンドウとして表示するか、下部のタブとして表示するかをプログラムで制御できなくなります。 レポート ページリストの場所の変更は、Power BI サービスレポート設定でのみ使用でき、オブジェクト経由
panes
では使用できません。個人用ブックマーク アクションは、API ではサポートされていません。 レポート ブックマークの詳細については、「 レポート ブックマーク」を参照してください。