支持对计算字段类型的 ER 数据源执行参数化调用

2023-03-08

本文介绍如何使用计算字段类型设计电子报告 (ER) 数据源。此数据库中可以包含一个 ER 表达式，其在执行时由调用此数据源的绑定中配置的参数自变量的值控制。通过配置此类数据源的参数化调用，可以在大量绑定中重复使用一个数据源，从而减少必须在 ER 模型映射或 ER 格式中配置的数据源的总数。还可以简化配置的 ER 组件，从而降低维护成本和其他使用者的使用成本。

先决条件

要完成本文中的示例，您必须具有以下访问权限：

访问以下角色之一：
- 电子申报开发人员
- 电子申报功能顾问
- 系统管理员
对于下列角色之一，访问已为与财务和运营相同的租户配置的 Regulatory Configuration Services (RCS)：
- 电子报告开发人员
- 电子申报功能顾问
- 系统管理员

还必须下载并在本地存储以下文件。

内容	文件名
示例 ER 数据模型配置	用于了解参数化调用的模型.版本.1.xml
示例 ER 元数据配置	用于了解参数化调用的元数据.版本.1.xml
示例 ER 模型映射配置	用于了解参数化调用的映射.版本.1.1.xml
示例 ER 格式配置	用于了解参数化调用的格式.版本.1.1.xml

在此示例中，将为示例公司 Litware 公司创建一个配置。首先必须在 RCS 中完成创建配置提供程序并将其标记为有效过程中的步骤：

在默认仪表板中，选择电子申报。
选择申报配置。
按照以下顺序将下载的配置导入到 RCS 中：数据模型、元数据、模型映射、格式。为每个 ER 配置完成以下步骤：
1. 选择交换。
2. 选择从 XML 文件加载。
3. 选择浏览，然后选择 XML 格式的所需 ER 配置。
4. 选择确定。

查看提供的 ER 解决方案

查看模型映射

在配置树中，展开用于了解参数化调用的模型项的内容。
选择用于了解参数化调用的映射。
选择设计器。
选择设计器。

此 ER 模型映射用于执行以下操作：
- 提取 TaxTable 表中的税码（税数据源）的列表。
- 提取 TaxTrans 表中的税务交易记录（交易记录数据源）的列表：
  - 按税码为提取的交易记录（组数据源）列表分组。
  - 按税码计算分组的交易记录的以下聚合值：
    - 税金基数值的和。
    - 税金值的和。
    - 采用的税率的最小值。
此配置中的模型映射实施为此模型创建并在财务和运营中执行的任何 ER 格式的基本数据模型。结果，Tax和 Gr 数据源的内容将对抽象数据源之类 ER 格式公开。
关闭模型映射设计器页。
关闭模型映射页。

查看格式

在配置树中，展开用于了解参数化调用的模型项的内容。
选择用于了解参数化调用的格式。
选择设计器。此 ER 格式用于执行以下操作：
- 生成 XML 格式的报税单。
- 在报税单中提供以下征税级别：正常、减税、免税。
- 在每个征税级别提供多项详细信息，从而每个级别包含不同数量的详细信息。
选择映射。
展开模型、数据和摘要项。

计算字段模型.数据.摘要.级别中包含表达式，用于将征税级别（正常、减税、免税或其他）的代码作为可在运行时从模型.数据.摘要数据源检索的任何税码的文本值返回。
展开模型.数据2 项。
展开模型.数据2.摘要2 项。

配置模型.数据2.摘要2 数据源是为了按（模型.数据.摘要.级别计算字段返回的）征税级别为模型.数据.摘要数据源交易记录详细信息分组和计算聚合。
查看计算字段 Model.Data2.Level1、Model.Data2.Level2 和 Model.Data2.Level3。这些计算字段用于筛选 Model.Data2.Summary2 记录列表，仅返回表示特定征税级别的记录。
关闭格式设计器页。

创建派生格式

可通过添加一个计算字段来筛选所需征税级别，而不是使用现有三个字段，改进提供的格式：模型.数据2.级别1、模型.数据2.级别2 和模型.数据2.级别3。可以在将调用这个新计算字段的位置中指定所需征税级别。

在配置树中，展开用于了解参数化调用的模型项的内容。
选择用于了解参数化调用的格式。
选择创建配置。
选择从以下名称派生: 用于了解参数化调用的格式, Microsoft。
在名称字段中，输入用于了解参数化调用的格式(自定义)。
选择创建配置。

配置用于返回记录列表的参数化计算字段

开始添加新的计算字段

选择设计器。
选择展开/折叠以展开所有格式项。
选择映射。
展开模型项。
选择模型.数据2 项。
选择添加。
选择函数\计算字段。
在名称字段中，输入级别。
选择编辑公式。

定义用于添加计算字段的参数

选择参数。
选择新建。
在名称字段中，输入征税级别。
在类型字段中，选择字符串。

只有原始数据类型才能用于指定参数的自变量类型。因此，记录列表、记录和枚举类型不能用于此用途。

为一个计算字段最多可以指定 8 个参数。
选择确定。

可以通过添加此参数来指定调用此计算字段所需条件。调用此计算字段时，需要将征税级别参数的自变量指定为字符串格式的值。

请确保仅为容器中包含的计算字段（记录列表、记录或容器）定义参数。

将在此计算字段的数据源列表中提供配置的参数。可通过选择添加数据源向配置的表达式添加参数。

数据源字段。

定义用于添加计算字段的表达式

在公式字段中，输入：

WHERE(@.Summary2, @.Summary2.grouped.Level =
在数据源列表中选择征税级别参数。
选择添加数据源。
在公式字段中，设置如下表达式：

WHERE(@.Summary2, @.Summary2.grouped.Level = 'Taxation Level')
选择保存。
关闭公式设计器页。

完成添加新的计算字段

选择确定。

在格式设计器页面中，配置的参数化计算字段级别需要一个字符串自变量。

展开的计算字段级别列表。

对绑定格式元素使用配置的计算字段

选择模型.数据2.级别以选择配置的计算字段。
选择报.税.正常格式元素。
选择绑定。
选择是以确认在所选格式元素的所有嵌套格式元素中，将当前使用的数据源级别1 替换为新数据源级别。

应用的绑定已构建为参数化计算字段的一个调用。在以下情况下，绑定格式元素的名称默认用作参数化计算字段的自变量：
- 计算字段配置为使用单个参数。
- 此参数的数据类型定义为字符串。
如果绑定格式元素的名称为空，则在应用的绑定中使用此元素的数据源名称。
选择报.税.减税格式元素。
选择绑定。
选择是以确认在所选格式元素下的所有嵌套格式元素中，将当前使用的数据源级别2 替换为新数据源级别。
选择报.税.免税格式元素。
选择绑定。
选择是以确认在所选格式元素下的所有嵌套格式元素中，将当前使用的数据源级别3 替换为新数据源级别。

为表示征税级别的 XML 元素指定参数化计算字段的自变量时（例如，模型.数据2.级别("减税") 作为文本值），则无需对嵌套的 XML 属性执行z相同操作 — 其绑定将自动继承在父级别（模型.数据2.级别.聚合.基数，而不是模型.数据2.级别("减税").聚合.基数）定义的自变量的值。

不支持重复调用任何参数化计算字段。

您在选择的绑定中，可以选择 编辑配方和更改将参数化的计算字段的应用由默认参数。如果缺少此自变量，可能导致运行时出错 — 在验证当前格式时通知用户此类情况。

验证警告通知。