如何在套接字或 Web 服务 POST 集成中使用多条记录
概述
在通过套接字发送数据或进行 Web 服务集成时，您可以选择发送多条记录，就像文件集成中的表结构一样。这样，您就可以在一个触发文件中发送更多信息。
当您创建新的集成时，默认只会读取和处理一条记录。不过，通过一些额外的操作，您可以让集成处理多条记录。
注意：在使用 Web 服务集成时，这只适用于 POST 方法，因为它要求数据通过消息体发送。
适用范围
BarTender 2019 及以上版本
自动化版及更高版本
信息
可以通过 TCP 或 POST 发送已经具有“表格结构”的数据，例如下面的示例：
为了能够将“平面”文件的内容作为变量使用，首先需要两个额外的操作：“针对每条数据库记录”和“将文本转换为记录集”：
这两个操作可以“无论集成类型如何”都使用，因为它们会基于 %EventData% 变量的值来处理。%EventData% 变量会保存所有集成接收到的数据。
“将文本转换为记录集”操作只支持基于文本的数据库，如 CSV、制表符分隔或其他类似分隔的数据库。更复杂的基于文本的数据库，如 XML 或 JSON，将无法正常使用。
设置“将文本转换为记录集”操作
首先需要定义的操作是“将文本转换为记录集”（此操作会将数据转换为类似数据库的结构）：
- 首先，您需要准备一个“示例”文件，用于定义接收数据的结构。例如，使用一个结构相同的示例文档，后续通过 TCP 或 POST 发送的数据也会采用该结构。
- 点击“数据库连接设置...”按钮，然后使用向导将“示例”数据库文件关联到集成中。连接数据库后，关闭对话框。
- 在“文本来源”选项中，确保“变量”设置为“%EventData%”，输出也设置为“%EventData%”。
这意味着该操作将使用变量“%EventData%”中的数据，而集成会自动将所有接收到的数据保存到该变量中。
设置“针对每条数据库记录”操作
在数据被拆分为多条记录后，集成需要知道如何处理这些记录。将“针对每条数据库记录”操作与“打印文档”操作嵌套在一起，可以确保每条记录在打印时单独打印：
“针对每条数据库记录”操作无需额外设置，但您需要在“打印文档”操作中定义数据如何映射到标签上。
- 首先，您的标签需要设置好所有命名数据源的值。
- 点击“导入文档设置”按钮，导入并填写命名数据源名称。
- 接下来，将标签的命名数据源与示例数据库中的字段名进行匹配。如果您没有指定字段名，系统会自动生成 Field1、Field2 等名称。
- 在命名数据源表格中选择变量图标，从对话框中插入字段名称。字段名称会显示在如下所示的“操作”部分：
如果您知道字段名称，也可以直接手动输入，格式为 %FIELDNAME%。