管理单个模型根的多个派生映射

电子报告 (ER) 数据模型组件在每个配置的 ER 格式组件中用作生成传出文档的数据源。 要描述单个业务域,请配置具有多个根定义的数据模型组件。

每个根定义让您可以最适合特定报告目的的方式表示该域的数据。 对于每个根定义,您可以将一个 ER 模型映射组件配置为数据模型的 Microsoft Dynamics 365 Finance 特定实现。 通过这种方式,您将描述在运行时数据模型如何填充。

ER 模型映射组件可以放在 ER 数据模型配置和 ER 模型映射配置中。 单个 ER 配置可以包含多个映射组件,每个映射组件针对单个根定义进行配置。 或者,单个 ER 配置可以仅包含为单个根定义配置的一个映射组件。

多个配置提供程序可能会为同一个 ER 数据模型提供 ER 模型映射配置。 这些模型映射配置可能包含不同根定义的映射组件。 您可以对一个提供程序提供的一个根定义使用一个模型映射,对另一个提供程序提供的另一个根定义使用一个模型映射。

本文中的过程说明当 ER 模型映射配置包含为同一个根定义配置的不同模型映射组件时,如何管理 ER 数据模型的多个 ER 模型映射配置。

要完成本文中的过程,您必须被分配系统管理员或电子报告开发人员角色。

以下所有过程均可在 USMF 公司中完成。 无需进行编码。

配置 ER 框架

作为具有电子报告开发人员角色的用户,在使用 ER 框架生成业务文档之前,请先配置最小 ER 参数集

导入标准 ER 格式配置

若要向当前 Finance 实例添加标准 ER 配置,必须从为该实例配置的 ER 存储库中导入这些配置。 按照从配置服务的全局存储库下载 ER 配置中的步骤导入以下 ER 格式配置:

  • 普通发票 (Excel),版本 220.106
  • 项目发票 (Excel),版本 226.27

查看导入的 ER 配置

  1. 转到组织管理>工作区>电子申报

  2. 本地化配置页面的配置部分中,选择报告配置磁贴。

  3. 配置页的左侧窗格的配置树中,展开发票模型

    在“配置”页面上查看导入的配置。

  4. 查看普通发票 (Excel) 格式:

    1. 在左侧窗格的配置树中,选择普通发票 (Excel)

    2. 在操作窗格上,选择设计器

    3. 格式设计器页上的映射选项卡上,在数据源列表中,选择模型

    4. 选择查看

      当前 ER 格式配置为使用发票模型InvoiceCustomer 根定义。 当运行此格式并调用模型数据源时,为 InvoiceCustomer 根定义配置的模型映射用于访问应用程序数据和填充数据模型。

      在“格式设计器”页面上查看模型数据源。

    5. 关闭格式设计器页。

  5. 查看发票模型映射配置的内容:

    1. 在左侧窗格的配置树中,选择发票模型映射

    2. 在操作窗格上,选择设计器

    3. 模型到数据源映射页上,注意当前的 ER 模型映射配置包含几个模型映射组件:

      • 客户发票模型映射是为发票模型InvoiceCustomer 根定义配置的。 因此,当普通发票 (Excel) ER 格式运行时,可以选择此 ER 配置的客户发票模型映射来访问应用程序数据和填充数据模型。
      • 项目发票模型映射是为发票模型InvoiceProject 根定义配置的。 因此,当项目发票 (Excel) ER 格式运行时,可以选择此 ER 配置的项目发票模型映射来访问应用程序数据和填充数据模型。

      “模型到数据源映射”页面上的发票模型映射。

    4. 关闭模型到数据源映射页。

    5. 版本快速选项卡上,选择删除删除此 ER 配置所有晚于 240.175 版本的版本。

  6. 查看项目发票模型映射(RDP) 配置的内容:

    1. 在左侧窗格的配置树中,选择项目发票模型映射(RDP)

    2. 在操作窗格上,选择设计器

    3. 模型到数据源映射页上,注意当前的 ER 模型映射配置包含 InvoiceProject 模型映射,并且此模型映射是为发票模型InvoiceProject 根定义配置的。 当项目发票 (Excel) ER 格式运行时,选择此 ER 配置的 InvoiceProject 模型映射来访问应用程序数据和填充数据模型。

      “模型到数据源映射”页面上的项目发票模型映射。

    4. 关闭模型到数据源映射页。

    5. 版本快速选项卡上,选择删除删除此 ER 配置所有晚于 226.35 版本的版本。

自定义导入的 ER 配置

本节说明如何自定义 Microsoft 提供的模型映射。 例如,可能需要自定义来实现您的自定义逻辑或添加缺少的绑定。

自定义发票模型映射配置

  1. 配置页面上,在左侧窗格的配置树中,选择发票模型映射

  2. 在操作窗格中选择创建配置

  3. 创建配置下拉对话框的新建字段中,选择从名称派生: 发票模型映射, Microsoft

  4. 名称字段中,输入发票模型映射 Litware

  5. 选择创建配置

  6. 将派生映射的草稿版本标记为可以在运行时使用:

    1. 在操作窗格的配置选项卡上,在高级设置组中,选择用户参数
    2. 使用参数对话框中,将运行设置选项设置为,然后选择确定
    3. 根据需要,选择编辑使页面可供编辑。
    4. 对于配置树中当前选择的发票模型映射 Litware 配置,将运行草稿选项设置为
  7. 在操作窗格上,选择设计器查看此配置的模型映射。

    在“模型到数据源映射”页面上查看发票模型映射。

    提示

    现在,您可以在设计器中打开此 ER 配置的任何 ER 模型映射组件,来配置您的自定义逻辑。 有关详细信息,请参阅自定义模型映射配置

  8. 关闭模型到数据源映射页。

现在,您有发票模型映射发票模型映射 Litware 配置,每个配置都有为 InvoiceCustomer 根定义配置的模型映射。 明确指定其中一个模型映射作为任何 ER 格式所使用的默认模型映射,如包含具有 InvoiceCustomer 根定义的模型数据源的普通发票 (Excel) 格式。 否则,当您运行、编辑或验证其中一个 ER 格式时,将引发以下异常,通知您未明确分配默认模型映射:

<逗号分隔的配置名称> 配置中的“<模型名称>(<根描述符>)”数据模型存在多个模型映射。 将其中一个配置设置为默认配置。

在“配置”页面上打开格式进行编辑。

自定义项目发票模型映射 (RDP) 配置

  1. 配置页面上,在左侧窗格的配置树中,选择项目发票模型映射 (RDP)

  2. 在操作窗格中选择创建配置

  3. 创建配置对话框的新建字段中,选择从名称派生: 项目发票模型映射 (RDP), Microsoft

  4. 名称字段中,输入项目发票模型映射 Litware

  5. 选择创建配置

  6. 对于配置树中当前选择的项目发票模型映射 Litware 配置,将运行草稿选项设置为

  7. 在操作窗格上,选择设计器查看此配置的模型映射。

    在“模型到数据源映射”页面上查看自定义的项目发票模型映射。

  8. 关闭模型到数据源映射页。

您现在有发票模型映射项目发票模型映射 (RDP)项目发票模型映射 Litware 配置。 这些配置中的每一个都为 InvoiceProject 根定义配置了模型映射。 明确分配其中一个模型映射作为任何 ER 格式使用的默认模型映射。 例如,使用包含具有 InvoiceProject 根定义的模型数据源的项目发票 (Excel) 格式。 否则,当您运行或编辑其中一个 ER 格式时,将引发异常,通知您未明确分配默认模型映射。

选择派生的“发票模型映射 Litware”配置作为包含默认模型映射的配置

  1. 配置页面上,在左侧窗格的配置树中,选择发票模型映射 Litware

  2. 模型映射的默认值选项设置为

    在“配置”页面上将模型映射设置为默认模型映射。

    由于此设置,当您运行普通发票 (Excel) 或对其进行编辑或验证时,将使用客户发票副本模型映射。 发票模型映射配置中的客户发票模型映射将被忽略。

    您现在可以打开普通发票 (Excel) 格式来在格式设计器中查看。

选择派生的“项目发票模型映射 Litware”配置作为包含默认模型映射的配置

  1. 配置页面上,在左侧窗格的配置树中,选择项目发票模型映射 Litware

  2. 模型映射的默认值选项设置为

    在这种情况下,与上一节中介绍的发票模型映射 Litware 配置的情况不同,您无法从项目发票模型映射 Litware 配置开始使用 InvoiceProject 副本模型映射。 包含 InvoiceProject 根定义的模型映射的两个配置当前被标记为默认配置。 因此,它们具有相同的使用优先级。 要解决此问题,请完成此过程的其余步骤。

  3. 在左侧窗格的配置树中,选择发票模型映射 Litware

  4. 在操作窗格上,选择设计器

  5. 模型到数据源映射页上,根据需要选择编辑让页面可编辑。

  6. 选择项目发票副本模型映射,然后选择它对应的已删除复选框。

    在“模型到数据源映射”页面上将模型映射设置为虚拟删除。

    由于此设置,发票模型映射 Litware 配置被视为没有 InvoiceProject 根定义的模型映射。 将默认发布 InvoiceProject 副本模型映射。 包含此模型映射的配置项目发票模型映射 Litware 被标记为默认配置。 由于被标记为默认配置,它的优先级高于项目发票模型映射 (RDP) 配置中的 InvoiceProject 模型映射。

其他注意事项

项目发票模型映射 Litware 配置的 InvoiceProject 副本模型映射被设计为使用 ReportDataProvider 数据源。 此数据源是引用 PsaProjInvoiceDP 应用程序类的对象类型的一部分。 此类作为打印管理框架的项目发票 SQL Server Reporting Services (SSRS) 报表的数据提供程序实现。 选择此数据源作为 ER 集成点。 打印管理报表的当前 ER 实现会考虑此设置。 有关更多详细信息,请查看 ERPrintMgmtDataProviderReport 应用程序类的源代码。 在运行时,将 ReportDataProvider 数据源作为模型映射集成点分配,会强制 Finance 将此映射组件视为具有高于项目发票模型映射 (RDP) 配置中的 InvoiceProject 映射组件的优先级。

请参阅