使用 Power BI Embedded 即可將分析新增至工作區

發行項
07/27/2022

注意

Finance and Operations (7.2 版及更高版本) 支援此函數。

簡介

本主題展示如何在工作區的分析索引標籤上嵌入 Microsoft Power BI 報告。對於此處給出的範例，我們將展開 Fleet Management 應用程式中的 保留管理 工作區，將分析工作區嵌入到分析索引標籤上。

先決條件

存取執行 Platform update 8 或更高版本的開發人員環境。
使用 Microsoft Power BI Desktop 建立的分析報告 (.pbix 檔案)，並且具有來自實體儲存資料庫的資料模型。

概觀

無論您是展開現有的應用程式工作區還是引入自己的新工作區，您都可以使用嵌入式分析檢視來提供具有深入解析和互動式的業務資料檢視。新增分析工作區索引標籤的流程有四個步驟。

將 .pbix 檔案新增為 Dynamics 365 資源。
定義分析工作區索引標籤。
在工作區索引標籤上嵌入 .pbix 資源。
選用：新增擴充函數以自訂檢視。

注意

如需如何建立分析報告的相關資訊，請參閱Power BI Desktop 使用者入門。此頁面是獲取深入解析的重要來源，可幫助您建立引人注目的分析報告解決方案。

將 .pbix 檔案新增為資源

在開始之前，您必須建立或獲取您將嵌入至工作區的 Power BI 報告。如需如何建立分析報告的相關資訊，請參閱Power BI Desktop 使用者入門。

按照以下步驟將 .pbix 檔案新增為 Visual Studio 專案成品。

在適當的模型中建立一個新專案。
在解決方案 Explorer 中，選取專案、按按右鍵點選，然後選取新增>新項目。
在 新增項目 對話方塊中，在 營運成品 下，選取資源範本。
在 X++ 中繼資料中輸入將用於參考報告的名稱，然後點選新增。
找到包含分析報告定義的 .pbix 檔案，然後點選開啟。

現在您已將 .pbix 檔案新增為 Dynamics 365 資源，您可以將報告嵌入工作區並使用選單項目新增直接連結。

將索引標籤控制項新增到應用程式工作區

在這個範例中，我們將展開 Fleet Management 模型中的 保留管理，方法是將分析索引標籤新增到 FMClarkWorkspace 表單的定義。

下圖顯示了 FMClarkWorkspace 表單看起來像 Microsoft Visual Studio 的設計工具。

更改前的 FMClarkWorkspace 表單。

按照以下步驟展開 保留管理 工作區的表單定義。

打開表單設計工具以展開設計定義。
在設計定義中，選取標記為 設計 | 模式：工作區營運 的首要元素。
按右鍵點選，然後選取新增>索引標籤 來新增一個名為 FormTabControl1 的新控制項。
在表單設計工具中，選取 FormTabControl1。
按右鍵點選，然後選取 新分頁 來新增一個新的分頁。
將分頁重新命名為有意義的名稱，例如 工作區。
在表單設計工具中，選取 FormTabControl1。
按右鍵點選，然後選取 新分頁。
將分頁重新命名為有意義的名稱，例如分析。
在表單設計工具中，選取 分析 (索引標籤頁)。
將字幕屬性設定為分析，並將 自動申報 屬性設定為是的。
按右鍵點選控制項，然後選取新增>群組以新增表單組控制項。
將表單組重新命名為有意義的名稱，例如 powerBIReportGroup。
在表單設計工具中，選取 PanoramaBody (索引標籤)，然後將控制項拖曳到 工作區 索引標籤。
在設計定義中，選取標記為 設計 | 模式：工作區營運 的首要元素。
按右鍵點選，然後選取 移除模式。
再次按右鍵點選，然後選取 新增模式>工作區 Tab 鍵。
執行組建以驗證您的更改。

下圖顯示了套用這些更改後設計的外觀。

更改後的 FMClarkWorkspace。

現在您已經新增了將用於嵌入工作區報告的表單控制項，您必須定義父代控制項的大小以使其適應配置。在預設情況下，篩選條件窗格 頁面和 索引標籤 頁面將在報告中顯示。但是，您可以根據報告的目標消費者更改這些控制項的可見性。

注意

對於內嵌式工作區，我們建議您使用擴充函數來隱藏 篩選條件窗格 和 索引標籤 頁面，以保持一致性。

您現在已經完成了展開申請表定義的任務。如需如何使用擴充函數自訂的相關資訊，請參閱透過擴充函數和疊加自訂。

新增 X++ 業務邏輯以嵌入檢視器控制項

按照以下步驟新增業務邏輯，用於初始化嵌入在 保留管理 工作區的 Report Viewer 控制項。

打開 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();
    }
}

執行組建以驗證您的更改。

您現在已經完成了新增業務邏輯以初始化嵌入式 Report Viewer 控制項的任務。下圖顯示了套用這些更改後工作區的外觀。

嵌入至工作區的報告。

注意

您可以使用頁面標題下方的工作區索引標籤存取現有的營運檢視。

參考

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 報告的預設篩選條件。

共用方式為