Power BI Embedded を使用したワークスペースへの分析の追加

[アーティクル]
03/21/2023

メモ

この機能は、財務と運用 (バージョン 7.2 以降) でサポートされています。

概要

この記事では、ワークスペースの分析タブで Microsoft Power BI レポートを組み込む方法を説明します。ここで示した例では、フリート管理アプリケーションの 予約管理 ワークスペースを拡張して、分析ワークスペースを分析タブに埋め込みます。

前提条件

プラットフォーム更新プログラム 8 以降を実行する開発環境へのアクセス。
Microsoft Power BI Desktop を使用して作成され、エンティティ格納データベースから取得されたデータモデルを持つ分析レポート (.pbix ファイル) です。

概要

既存のアプリケーションワークスペースを拡張する場合でも、自分の新しいワークスペースを導入する場合でも、埋め込み分析ビューを使用して、ビジネスデータの洞察的でインタラクティブなビューを提供できます。分析ワークスペースタブを追加するプロセスには、4 つのステップがあります。

Dynamics 365 リソースとして .pbix ファイルを追加します。
分析ワークスペースタブを定義します。
ワークスペースタブに .pbix リソースを埋め込みます。
オプション: 表示をカスタマイズする拡張機能を追加します。

メモ

分析レポートを作成する方法の詳細については、Power BI Desktop の使い方を参照してください。このページは、魅力的な分析レポート作成ソリューションの作成に役立つ素晴らしいソースです。

リソースとして .pbix ファイルを追加します。

開始する前に、ワークスペースに埋め込む Power BI レポートを作成または取得する必要があります。分析レポートを作成する方法の詳細については、Power BI Desktop の使い方を参照してください。

.pbix ファイルを Visual Studio プロジェクトコンポーネントとして追加するには、次の手順を実行します。

該当するモデルで新しいプロジェクトを作成します。
ソリューションエクスプローラーで、プロジェクトを選択し、右クリックした後に、追加>新しい品目の順に選択します。
新しい項目の追加ダイアログボックスの工程コンポーネントでリソーステンプレートを選択します。
X++ メタデータのレポートを参照するために使用する名前を入力し、追加をクリックします。
分析のレポートの定義を含む .pbix ファイルを見つけて、未処理をクリックします。

Dynamics 365 リソースとして .pbix ファイルを追加したため、ワークスペースにレポートを埋め込み、メニュー項目を使用して直接リンクを追加できるようになりました。

アプリケーションワークスペースへのタブコントロールの追加

この例では、FMClerkWorkspace フォームの定義に分析タブを追加することで、フリート管理モデルの 引当管理 ワークスペースを拡張します。

次の図は、FMClerkWorkspace フォームが Microsoft Visual Studio のデザイナーにどのように表示されるかを示しています。

変更する前の FMClerkWorkspace フォーム。

次の手順に従って、引当管理ワークスペースの定義を拡張します。

デザイン定義を拡張するフォームデザイナーを開きます。
設計の定義では、デザイン | パターン: 操作ワークスペースというラベルが付いた最上位の要素を選択します。
右クリックし、新規>タブの順に選択して、FormTabControl1 という名前の新しいコントロールを追加します。
フォームデザイナーで FormTabControl1 を選択します。
、新しいタブページを右クリックし、選択し、新しいタブページを追加します。
ワークスペースなど、タブページをわかりやすい名前に変更します。
フォームデザイナーで FormTabControl1 を選択します。
新しいタブページを右クリックし、選択します。
分析など、タブページをわかりやすい名前に変更します。
フォームデザイナーで、分析 (タブページ) を選択します。
キャプション プロパティを Analytics に、自動申告 プロパティをはいに設定します。
コントロールを右クリックし、新規>グループの順に選択して、新しいフォームグループコントロールを追加します。
powerBIReportGroup など、フォームグループをわかりやすい名前に変更します。
フォームデザイナーで、PanoramaBody (タブ) を選択し、コントロールをワークスペースタブの上にドラッグします。
設計の定義では、デザイン | パターン: 操作ワークスペースというラベルが付いた最上位の要素を選択します。
パターンの削除を右クリックし、選択します。
もう一度右クリックし、パターンの追加>ワークスペースタブの順に選択します。
変更を確認するビルドを実行します。

次の図は、これらの変更が適用された後に設計がどのように表示されるかを示します。

変更後の FMClerkWorkspace。

ワークスペースレポートの埋め込みに使用するフォームコントロールを追加したため、親コントロールのサイズがレイアウトに対応できるように、それを定義する必要があります。既定では、フィルタウィンドウページとタブページの両方がレポートに表示されます。ただし、これらのコントロールの表示/非表示を、レポートの対象となる消費者の必要に応じて変更することができます。

メモ

埋め込みのワークスペースについては、ページの一貫性を保つため、拡張機能を使用して、フィルタウィンドウおよびタブページを非表示にすることをお勧めします。

これでアプリケーションフォームの定義を拡張するためのタスクが完了しました。カスタマイズを行うために拡張機能を使用する方法に関する詳細については、拡張機能およびオーバーレイによるカスタマイズを参照してください。

ビューアーコントロールを埋め込むための X++ ビジネスロジックの追加

これらの手順に従い、引当管理 ワークスペースに埋め込まれているレポートビューアーコントロールを初期化するビジネスロジックを追加します。

FMClerkWorkspace フォームデザイナーを開き、デザイン定義を拡張します。
F7 キーを押し、コードの定義の背後にあるコードにアクセスします。

次の X++ コードを追加します。

[Form] 
public class FMClerkWorkspace extends FormRun
{
    private boolean initReportControl = true;
    protected void initAnalyticalReport()
    {
        if (!initReportControl)
        {
            return;
        }
        // Note: secure entry point into the Workspace's Analytics report
        if (Global::hasMenuItemAccess(menuItemDisplayStr(FMClerkWorkspace), MenuItemType::Display))
        {
            // initialize the PBI report control using shared helper
            PBIReportHelper::initializeReportControl('FMPBIWorkspaces', powerBIReportGroup);
        }
        initReportControl = false;
    }
    /// <summary>
    /// Initializes the form.
    /// </summary>
    public void init()
    {
        super();
        this.initAnalyticalReport();
    }
}

変更を確認するビルドを実行します。

これで、埋め込みレポートビューアーコントロールを初期化するビジネスロジックを追加するタスクを完了しました。次の図は、これらの変更が適用された後にワークスペースがどのように表示されるかを示します。

ワークスペースに埋め込まれているレポート。

メモ

既存の操作ビューは、ページのタイトルの下のワークスペースタブを使用してアクセスできます。

参照

PBIReportHelper.initializeReportControl 方法

このセクションでは、フォームグループコントロールで Power BI レポート (.pbix リソース) の埋め込みに使用されるヘルパークラスに関する情報を提供します。

構文

public static void initializeReportControl(
    str                 _resourceName,
    FormGroupControl    _formGroupControl,
    str                 _defaultPageName = '',
    boolean             _showFilterPane = false,
    boolean             _showNavPane = false,
    List                _defaultFilters = new List(Types::Class))

パラメーター

氏名	説明
resourceName	.pbix リソースの名前。
formGroupControl	Power BI レポートのコントロール適用先のフォームグループコントロール。
defaultPageName	既定のページの名前
showFilterPane	フィルタウィンドウを表示 (true) または非表示 (false) するかを示すブール値。
showNavPane	ナビゲーションウィンドウを表示 (true) または非表示 (false) するかを示すブール値。
defaultFilters	Power BI レポートの既定のフィルター。