通过

设计 ER 配置以填写 PDF 模板

  • 项目

本文中的过程为示例，用于演示系统管理员角色或电子报告开发人员角色的用户如何通过将可填写 PDF 文档用作报表模板来配置用于生成 PDF 文件格式报表的电子报告 (ER) 格式。 Dynamics 365 Finance 或 Regulatory Configuration Services (RCS) 的任何公司都可以执行这些步骤。

先决条件

首先，您必须具有下列访问权限类型之一，具体取决于您用于完成本文中的过程的服务。

  • 访问 Finance 的以下其中一个角色：

    • 电子报告开发人员
    • 电子申报功能顾问
    • 系统管理员

  • 访问 RCS 的以下其中一个角色：

    • 电子申报开发人员
    • 电子申报功能顾问
    • 系统管理员

还必须完成创建配置提供程序并将其标记为有效过程。

最后，下载以下文件。

内容描述 文件名
报表第一页的模板 IntrastatReportTemplate1.pdf
报表其他页的模板 IntrastatReportTemplate2.pdf
示例 ER 格式 - PDF Intrastat report (PDF).version.1.1.xml
示例 ER 格式 - Excel Intrastat (import from Excel).version.1.1.xml
示例数据集 Intrastat sample data.xlsx

设计 ER 格式配置

访问 Microsoft 提供的配置列表

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

  2. 确保提供商 Litware 公司可用且标记为有效。

  3. 在 Microsoft 提供商的磁贴中，选择存储库。

    注释

    如果已存在类型为 LCS 的存储库，请跳过此过程的其余步骤。

  4. 选择添加。

  5. 在下拉对话框中的配置存储库类型字段组中，选择 LCS 选项。

  6. 选择创建存储库。

  7. 选择确定。

获取 Microsoft 提供的模型配置

  1. 在配置存储库页左侧，选择显示筛选器按钮（漏洞符号）。

  2. 在类型字段中添加 LCS 值的筛选器，然后使用开头为运算符。

  3. 选择应用。

  4. 选择打开。

  5. 在树中，选择内部统计模型。

  6. 在版本快速选项卡中，选择版本 1。

    注释

    如果版本快速选项卡上的导入按钮不可用，请跳过此过程中的其余步骤。

  7. 选择导入。

  8. 选择是确认导入所选版本的内部统计模型模型配置。

创建新的格式配置

  1. 在电子申报工作区中，选择报告配置磁贴。

  2. 在树中，选择内部统计模型。

  3. 选择创建配置。

    注释

    如果创建配置按钮不可用，必须在可从电子申报工作区打开的电子申报参数页中开启设计模式。

  4. 在下拉对话框中的新建字段组中，选择基于数据模型内部统计的格式选项。

  5. 在名称 字段中，输入 Intrastat report (PDF)。

  6. 在说明字段中，输入 PDF 格式的内部统计报表。

    注释

    将自动输入有效配置提供商。 此提供商可以维护此配置。 尽管其他提供商可以使用此配置，但不能对其进行维护。

  7. 可选：在格式类型字段中，可选择电子文档的具体格式。 如果选择 PDF，设计时，ER Operations 设计器将仅提供仅适用于以 PDF 格式生成的文档的格式元素（PDF\文件、PDF\PDF 合并器等）。 如果将此字段留空，将在设计时添加第一个格式元素期间在 ER Operations 设计器中指定电子文档的格式。 例如，如果添加 Excel\File 作为第一个格式元素，ER Operations 设计器将仅提供仅适用于以 Excel 格式生成的文档的格式元素（Excel\单元格、Excel\区域等）。 格式。

  8. 选择创建配置。

将创建新的 ER 格式配置。 可使用此配置的草稿版本来存储为了生成 PDF 格式的电子文档而设计的 ER 格式组件。

设计电子单据的格式

接下来，在创建的 ER 格式配置中，将设计用于生成 PDF 格式的内部统计控件报表的 ER 格式。 此报表第一页显示报表摘要和报告的外贸交易记录的详细信息。 其他页必须仅显示报告的外贸交易记录的详细信息。 由于生成的报表页必须采用不同布局，所以将在 ER 格式中使用 PDF 格式的两个不同模板。

在任何 PDF 查看器中，打开下载的 PDF 模板。 请注意，每个模板中包含多个必须填写的字段。 在每个模板中，外贸交易记录的详细信息表示为 42 行，每行九个字段。 行号在每个字段名称的默认显示（如日期 1…日期 42 和 商品 1…商品 42）。

下图显示报表第一页的 PDF 模板。

模板 1.

下图显示报表其他页的 PDF 模板。

模板 2.

  1. 在配置页上，选择设计器。

  2. 选择添加根。

  3. 在下拉对话框中的树中，选择 PDF > PDF 合并器。

    如果格式的根元素选择 PDF 合并器元素，则在运行时生成的所有 PDF 文档都将合并为一个最终的 PDF 文档。 如果仅需要一个 PDF 模板来使用您设计的 ER 格式生成需要的所有文档，根元素可选择 PDF 文件。

  4. 在名称字段中，输入输出。

  5. 在语言首选项字段中，选择用户首选项。 将使用运行报表的用户的首选语言生成报表。

  6. 在区域性首选项字段中，选择用户首选项。 将根据运行报表的用户的首选区域设置来设置报表页中显示的值和日期。

  7. 选择确定。

  8. 在操作窗格上的导入选项卡上，选择从 PDF 导入。

    将可填写 PDF 文档作为此 ER 格式的模板导入时，将根据导入的 PDF 文档的结构以设计的格式自动创建所有必需的 ER 格式元素（PDF 文件、字段组和字段元素）。

  9. 选择浏览。 导航到并选择之前作为先决条件下载的 IntrastatReportTemplate1.pdf 文件。

  10. 选择确定。

    将加载所选文件，并填写从 PDF 导入对话框中的模板字段。

  11. 将组字段选项设置为是。 如果所选 PDF 文档中包含任何字段组，将使用这些字段组来为创建的 ER 格式元素分组。 将为此目的创建一个字段组格式元素。

    如果此选项设置为否，将把所需 ER 格式元素创建为创建的 PDF 文件格式元素下嵌套的元素的简单列表。

  12. 选择确定。

    “从 PDF 导入”对话框。

  13. 在树中，展开输出。

    请注意，已自动创建了 PDF 文件组件来管理运行时生成的报表的第一页的创建。

  14. 在树中，展开输出 > PDF 文件。

    请注意，已根据前面导入的可填写 PDF 文档的结构使用此 Er 格式自动创建了结构化的格式元素列表。

  15. 在树中，选择输出 > PDF 文件。

  16. 在名称字段中，输入第 1 页。

    此格式将用于生成内部统计控件报表的第一页。 此页将显示报表摘要和外贸交易记录的详细信息。

    如果使语言首选项字段留空，PDF 合并器父元素的语言首选项设置将决定通过使用此格式元素生成的报表的语言。 可选择其他值替换父元素的设置。

    如果使区域性首选项字段留空，PDF 合并器父元素的区域性首选项设置将决定通过使用此格式元素生成的报表的语言。 区域设置决定报表页中的值和日期的格式。 可选择其他值替换父元素的设置。

  17. 在操作窗格中，选择导入选项卡。请注意，从 PDF 更新按钮已变为可用于所选格式元素 PDF 文件。

    可使用此按钮将更新后的 PDF 模板导入到编辑后的格式。 导入更新后的 PDF 模板时，将相应更改格式元素列表：

    • 对于更新后的 PDF 模板中的任何新字段，将使用编辑后的 ER 格式创建新的格式元素。
    • 如果更新后的 PDF 模板中不再包含与编辑后的 ER 格式的任何现有格式元素对应的字段，将从 ER 格式删除这些格式元素。

  18. 在格式选项卡中，选择附件。

    请注意，导入的 PDF 文档已附加到编辑后的 ER 格式。

    PDF 附件预览。

  19. 继续设计此格式，方法是导入第二个 PDF 模板，向数据源添加必要的绑定等。

  20. 选择保存。

  21. 关闭该页面。

  22. 选择删除。

  23. 选择是。

若要了解如何使用 PDF 合并器、PDF 文件、字段组和字段格式元素生成 PDF 格式的文档，可导入和分析示例 ER 格式。

导入格式配置

接下来，将导入之前下载的示例 ER 格式以生成 PDF 格式的内部统计控件报表。 报表第一页显示报表摘要和报告的外贸交易记录的详细信息。 其他页必须仅显示报告的外贸交易记录的详细信息。

  1. 在配置页中，选择交换 > 从 XML 文件加载。
  2. 选择浏览。 导航到并选择之前作为先决条件下载的 Intrastat report (PDF).version.1.1.xml 文件。
  3. 选择确定。

分析格式配置

格式布局

  1. 在配置页上的树中，选择内部统计模型 > 内部统计报表 (PDF)。

  2. 选择设计器。

  3. 选择显示详细信息。

  4. 在树中，展开输出：PDF 合并器。

    请注意，此 ER 格式中包含两个 PDF 文件元素，其中每个使用一个不同的 PDF 模板。 一个模板用于生成 PDF 格式的报表第一页，另一个模板用于生成其他页。

  5. 在树中，展开输出：PDF 合并器 > 第 1 页：PDF 文件 (IntrastatReportTemplate1)。

  6. 在树中，展开输出：PDF 合并器 > 第 N 页：PDF 文件 (IntrastatReportTemplate2)。

    请注意，由于这两个 PDF 模板的内容不同，所以这两个 PDF 文件元素的嵌套格式元素的结构也不同。

格式映射

  1. 在格式设计器页中，选择映射选项卡。

  2. 在树中，展开分页 > 页面。

    展开了模型树的公式设计器页面。

    注意以下详细信息：

    • PDF 文件类型的输出 > 第 1 页格式元素为绑定到任何数据源，并且此格式元素的 Enabled 表达式为空。 因此，运行时生成单个 PDF 文档期间，IntrastatReportTemplate1 PDF 模板仅填充一次。

    • PDF 文件类型的输出 > 第 N 页格式元素绑定到记录列表类型的 Paging.PageN 数据源，并且此格式元素的 Enabled 表达式为空。 因此，运行时生成单个 PDF 文档期间，将为绑定的记录列表中的每个记录填充 IntrastatReportTemplate2 PDF 模板。

    • 因为第 1 页：PDF 文件和第 N 页：PDF 文件格式元素是输出：PDF 合并器格式元素的子代，所以将把填写的所有 PDF 文档合并为一个最终的 PDF 文档。

    • Paging.Page1 和 Paging.PageN 数据源配置为 Paging.Pages 数据源中的记录的筛选器。 配置此数据源是为了将整组外贸交易记录拆分为批次。 每个批次最多包含 42 条记录。 下面的 ER 表达式用于将交易记录拆分为批次：

      SPLITLIST(Totals.CommodityRecord,42)

    • Paging.Pages 数据源中包含 Paging.Pages.Enumerated 元素，用于返回批次中包含的每个记录的详细信息。 这些详细信息中包含该记录在当前批次（Paging.Pages.Enumerated.Number 字段）中的序号。 Paging.Pages.Enumerated.Number 字段在 PDF 字段格式元素的 Name 表达式中用于动态生成基于批次中的交易记录号的字段名。 然后将生成的字段名用于填写所用 PDF 模板中的正确 PDF 字段。

    • PDF 组类型的输出 > 第 N 页 > 详细信息 2 格式元素绑定到记录列表类型的 Paging.PageN.Enumerated 数据源（如果使用的是相对路径视图模式，则为 @.Enumerated）。 因此，在运行时，将为绑定的记录列表中的每个记录填写此 PDF 组的嵌套元素。 这样，最终在为 Paging.PageN.Enumerated 列表的 42 个记录中的第 N 个填写以下 PDF 字段时，将生成单个 PDF 行：日期 N、方向 N、商品 N 等。因此，在这方面，此字段组格式元素的行为类似 XML > 序列和文本 > 序列格式元素的行为类似。

  3. 在树中，展开输出 > 第 N 页> 详细信息 2。

  4. 在树中，选择输出 > 第 N 页> 详细信息 2 > PageFooter。

    请注意，此格式元素的名称属性定义为 PageFooter。 另请注意，格式元素的 Name 表达式为空。

  5. 在树中，选择输出 > 第 N 页> 详细信息 2 > Correction 1。

    请注意，此格式元素的名称属性定义为 Correction 1。 另请注意，格式元素的 Name 表达式定义为 Paging.FldName("Correction",@.Number)。

选择了映射的格式设计器。

请注意，字段格式元素用于填写定义为 PDF 文件格式父元素的模板的可填写 PDF 文档的单个字段。 PDF 文件格式元素或其嵌套元素（如果有任何嵌套元素）的绑定指定在相应 PDF 字段中输入的值。 字段格式元素的不同属性可用于指定单个格式元素填充哪个 PDF 字段：

  • 格式选项卡上的格式元素的 Name 属性
  • 映射选项卡上的格式元素的 Name 表达式

因为这两个属性是字段格式元素的可选属性，所以将把下列规则应用于目标 PDF 字段：

  • 如果 Name 属性为空，而 Name 表达式在运行时返回空字符串，则在运行时引发异常以通知用户在正用于填写 PDF 文档的 PDF 模板中无法找到 PDF 字段。
  • 如果定义了 Name 属性，并且 Name 表达式为空，则将填写与格式元素的 Name 属性同名的 PDF 字段。
  • 如果定义了 Name 属性，并且配置了 Name 表达式，则将填写与格式元素的 Name 表达式返回的值同名的 PDF 字段。

注释

当 PDF 模板中的复选框不属于一组复选框时，它将以可编辑的电子报告格式显示为嵌套在 PDF 文件元素下面的字段元素。 这种类型的 PDF 复选框可以通过以下方式设置为选中：

  • 将对应的字段格式元素绑定到值为 True 的布尔数据类型的数据源字段。
  • 相应的字段格式元素中包含绑定到文本值为 1、True 或 Yes 的数据源字段的嵌套字符串格式元素。

您的模板可以包含一组复选框，但一次只能选中一个复选框。 这些复选框在 PDF 模板中显示为复选框类型的多个窗体字段。 每个字段都具有相同的名称，但具有不同的导出值。 当您将模板导入成可编辑的电子报告格式时，每个复选框都将以分层结构格式显示为嵌套在同一复选框组元素中的复选框组项元素。 复选框组元素的名称将等于 PDF 模板中复选框字段的名称。 每个复选框组项元素的名称将等于 PDF 模板中相应复选框字段的导出值。

您只能将复选框组项元素绑定到布尔数据类型的数据源字段。

运行格式配置

导入格式配置

接下来，将加载内部统计（从 Excel 导入）示例 ER 格式。 此格式用于解析用户选择来模拟外贸交易记录的 Microsoft Excel 工作簿。

  1. 在配置页中，选择交换 > 从 XML 文件加载。

  2. 选择浏览。 导航到并选择之前作为先决条件下载的 Intrastat (import from Excel).version.1.1.xml 文件。

  3. 选择确定。

  4. 在树中，选择内部统计模型 > 内部统计（从 Excel 导入）。

  5. 选择编辑。

  6. 将模型映射的默认值选项设置为是。

    注释

    如果之前将内部统计模型配置或内部统计模型配置下嵌套的另一个配置的模型映射的默认值选项设置为是，请将此选项设置为否。

    如果模型映射的默认值选项设置为是，则将导入的内部统计（从 Excel 导入）ER 格式指定为内部统计报表 (PDF) 格式配置的默认数据源。 然后，在运行内部统计报表 (PDF) 格式配置时，内部统计（从 Excel 导入）ER 格式解析的 Excel 工作簿的内容将模拟必须报告的外贸交易记录。 下图显示了一个 Excel 工作簿的示例。

    包含示例数据的 Excel 工作簿。

运行格式配置

  1. 在配置页上的树中，选择内部统计模型 > 内部统计报表 (PDF)。
  2. 选择运行。
  3. 选择浏览。 导航到并选择之前作为先决条件下载的 Intrastat sample data.xlsx 文件。
  4. 选择确定。
  5. 在报表方向字段中，选择双向以填写来自生成的 PDF 报表中导入的 Excel 工作簿内的所有交易记录。
  6. 选择确定。
  7. 查看生成的 PDF 文档。

下图显示生成的报表的第一页的示例。

生成报表的第一页。

下图显示生成的报表的另一页的示例。

生成报表的另一页。

限制

在您计划用作报表模板的 PDF 表单中，可填写字段的名称应该是唯一的。 对于每个此类字段，在导入 PDF 表单时，会以可编辑的 ER 格式创建具有相应名称的单个格式元素。 如果 PDF 表单包含多个同名字段，将会为不允许在运行时单独填写的字段创建单个格式元素。

常见问题解答

当我运行 ER 格式以生成 PDF 格式的报表时，为什么会收到以下错误：无法处理 iref 流。当前的 PDFSharp 实现无法处理 Acrobat 6 引入的这项 PDF 功能。和 PDF 名称必须以斜杠 (/) 开头。

ER 框架使用 PDFSharp 库的版本 1.5 生成这些 PDF 报表。 PDF 1.5 (Adobe Reader 6.0) 的某些功能尚未在此库中实现。 因此，PDFSharp 还无法打开一些标记为适用于 PDF 1.5 或更高版本的文件，并可能导致出现错误。 使用以下解决方案之一来解决此问题：

  • 当您使用自己的 PDF 模板时：将模板降级到较早的 Adobe 版本并开始使用您的 ER 格式的新模板。
  • 当您使用另一个配置提供程序与您共享的 ER 格式模板作为 ER 解决方案的一部分时：联系此 ER 解决方案的负责人并提供问题描述。
  • 当您使用包含早期版本的 PDFSharp 库的 ISV 解决方案时：联系解决方案的负责人并建议升级到较新的 PDFSharp 版本。

其他资源