使用 Power BI Embedded 将分析添加到工作区

项目
03/21/2023

注释

此功能在财务和运营（版本 7.2 及更高版本）上受支持。

简介

本文说明如何在工作区的分析选项卡上嵌入 Microsoft Power BI 报表。对于此处提供的示例，我们将“车队管理”应用程序中的预订管理工作区扩展到在分析选项卡上嵌入分析工作区。

必备项

对运行平台更新 8 或更高版本的开发人员环境的访问权限。
使用 Microsoft Power BI Desktop 创建的分析报表（.pbix 文件），且具有从实体商店数据库采购的数据模型。

概览

无论你是扩展现有的应用程序工作区，还是引入你自己创建新的工作区，都可以使用嵌入的分析视图来提供对你的业务数据的具有见解和交互的视图。添加分析工作区选项卡的流程具有四个步骤。

将 .pbix 文件添加为 Dynamics 365 资源。
定义分析工作区选项卡。
在工作区选项卡上嵌入 .pbix 资源。
可选：添加扩展以自定义视图。

注释

有关如何创建分析报表的详细信息，请参阅 Power BI Desktop 入门。此页是提供帮助你创建出色的分析报告解决方案的见解的出色来源。

将 .pbix 文件添加为资源。

在开始之前，你必须创建或获得在工作区中将嵌入的 Power BI 报表。有关如何创建分析报表的详细信息，请参阅 Power BI Desktop 入门。

执行以下步骤以将 .pbix 文件添加为 Visual Studio 项目。

在相应的模型中创建新项目。
在“解决方案资源管理器”中，选择项目，右键单击，然后选择添加>新物料。
在添加新物料对话框中，在 Operations 项目下，选择资源模板。
输入将用于在 X++ 元数据中引用报表的名称，然后单击添加。
查找包含分析报表的定义的 .pbix 文件，然后单击打开。

既然你已将 .pbix 文件添加为 Dynamics 365 资源，你现在可以在工作区中嵌入报表并使用菜单项添加直接链接。

将选项卡控件添加到应用程序工作区

在此示例中，我们将通过将分析选项卡添加到 FMClerkWorkspace 窗体的定义中的方式扩展车队管理模型中的预订管理工作区。

下图显示 FMClerkWorkspace 窗体在 Microsoft Visual Studio 中的设计器中的外观。

进行更改前的 FMClerkWorkspace 窗体。

执行以下步骤扩展预订管理工作区中的窗体定义。

打开设计器窗体以扩展设计定义。
在设计定义中，请选择标记为设计|模式：工作区运营的顶部元素。
右键单击，然后选择新>选项卡以添加命名为 FormTabControl1 的新控件。
在窗体设计器中，选择 FormTabControl1。
右键单击，然后选择新选项卡页以添加新的选项卡页。
将选项卡页重命名为有意义的名称，例如工作区。
在窗体设计器中，选择 FormTabControl1。
右键单击，然后选择新选项卡页。
将选项卡页重命名为有意义的名称，例如分析。
在窗体设计器，选择分析（选项卡页）。
将字幕属性设置为分析，然后将自动声明属性设置为是。
右键单击控件，然后选择新>组以添加新的 form group 控件。
将窗体组重命名为有意义的名称，例如 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 报表的默认筛选器。

通过