核心功能
- 支持通过基于模板的字段映射，从 XML 输入生成 PDF 表单
- 支持多页输出、选择性页面生成以及条形码字段集成
- 支持 Code39、Code128、GS1-128 和 QR 码等条形码类型，并具备高级配置选项
概述
PDF 端口将 XML 输入转换为 PDF 输出。XML 元素名称与 PDF 模板中的表单字段名称匹配。每个 XML 元素的值会填入相应的表单字段，以生成 PDF 输出文件。端口配置
本节包含所有可配置的端口属性。设置选项卡
配置
_与端口核心操作相关的设置。其他设置
高级选项卡
其他设置
消息
日志
其他设置
自动化选项卡
自动化设置
_与端口自动处理文件相关的设置。性能
告警选项卡
SLA 选项卡
生成 PDF 文档
PDF 端口读取 XML 输入文件，并使用这些 XML 文件中的数据生成与设置选项卡中指定的模板文件 PDF 文档匹配的 PDF 文档。这些 XML 输入文件的结构应与下面描述的结构或下一节中描述的旧结构匹配。XML 格式
下面是一个 XML 输入文件示例：- 根目录下有一个 Items 元素
- 一个 PDF 子元素代表一个 PDF 文档
- 在 PDF 元素内，每个元素与要动态填充数据的表单字段名称匹配
多页输出
如果模板文件 PDF 包含多个页面，则端口在处理 XML 输入文件时会自动生成适当数量的页面。此外，也可以从单个 XML 文件生成模板文件的多个副本，此时附加副本会作为同一输出文件的多个 PDF 页面追加。 要将模板文件的多个副本生成到多页输出中，只需重复根 Items 元素的直接子元素 PDF。此位置的每个 PDF 元素都被视为模板文件的单独实例，因此应包含填写模板所需的所有命名表单字段值。输出页面子集
如果模板文件 PDF 包含多个页面，则端口支持通过在 XML 输入文件中指定相应页面来生成这些模板页面的子集。输入文档根目录中的 Items 元素接受 pages 属性，该属性包含逗号分隔的页码列表（从零开始计数），用于指定输出中应包含的页面。 例如，如果模板文件包含 4 页，并且输出中只应包含第一页和最后一页，则 XML 输入文件如下所示：条形码
条形码字段（应包含条形码数据的表单字段）的处理方式与其他表单字段相同：条形码字段在 PDF 模板中有一个标签，该标签应作为输入 XML 中的元素名称。此外，条形码字段应具有 type 属性，用于确定要生成的条形码类型。端口支持四种条形码类型：- code39
- code128
- gs1128
- qrcode
高级条形码配置
除了在 XML 输入文件中指定条形码类型外，还可以直接在 PDF 模板文件中配置条形码。创建和编辑用于保存条形码的表单字段时，可以将配置信息添加到字段工具提示中，以影响生成的条形码。此配置信息应始终采用以下格式：$$parameter1:value,parameter2:value$$
条形码支持以下参数：
- barcode：条形码类型（使用上一节所述的 type 属性时冗余）
- qrcodeversion：当条形码类型设置为 qrcode 时 QR 码的版本
- eclevel：使用 QR 码时的纠错级别。可接受的值为 L（低）、M（中）、Q（四分位）和 H（高）
- quietzone：条形码周围的空白缓冲区。该值应为整数，表示最小条形尺寸的倍数（建议值为 10 或更高）
- heightnarrowratio：最窄条相对于条形码高度的宽度；必须指定为高度为 1 的比率（例如 ‘0.05’ 表示 1/20）
- widenarrowratio：最窄条相对于最宽条宽度的宽度；必须指定为最宽条为 1 的比率（例如 ‘0.2’ 表示 1/5）
- spacebarratio：条形码中空白相对于条形宽度的宽度；必须指定为条形宽度为 1 的比率（默认值为 1）
示例
下面是一个示例 XML 输入文件、PDF 模板文件 以及生成的 PDF 输出。下面的模板文件图像来自 Adobe Pro 表单编辑器，其中显示每个表单字段的名称。请记住，模板文件中的字段名称必须与 XML 中的元素标签匹配。
输入 XML
模板文件
输出
