如何使用命名数据源创建CSV集成
概述
CSV 集成是最简单且最实用的集成方式之一。与其他类型的集成不同，这种集成会将包含在触发文件中的 CSV 数据库拆分为变量，然后传递给标签文件。请确保使用顶部的版本下拉菜单，因为不同 BarTender 版本的界面可能有所不同。
如果你在寻找类似的集成方式，可以参考以下实用教程：
- 使用打印命令脚本打印文档（视频 - 9:40） - 该集成在脚本头部设置打印机和标签信息，并包含一个 CSV 数据库
- 如何创建基础的 CSV 集成 - 该 CSV 集成通过数据库覆盖将数据发送到标签。
- 构建数据库集成（视频 - 33:42） - 该集成与此类 CSV 集成非常相似，并在标签上使用命名数据源。
适用范围
BarTender 2022 及更高版本
信息
设置标签
这种类型的标签不使用数据库，而是通过命名数据源来处理所有数据。下面将介绍如何设置这种标签的基本步骤。更多信息请参见帮助文件中的命名数据源。
- 新建一个标签。
- 在标签设计区域创建一个文本对象。
- 右键点击标签，选择属性。
- 从列表中选择数据源，通常会显示“示例文本”。
- 点击名称字段旁边的方框。
- 在弹出的对话框中输入一个唯一名称并点击确定。本例中使用 ProductName。
- 确保类型设置为嵌入数据。
- 当你创建更多文本对象时，命名数据源对话框会有所不同。点击名称字段旁边的方框时，选择第一个选项以创建新名称。例如，可以使用 ProductType。
- 创建好所有需要的命名数据源后，保存标签。
创建集成
在集成过程中，你需要一个触发文件。CSV 字段名不需要与命名数据源名称一致，因为你将在集成中将字段与命名数据源进行匹配。这些 CSV 字段名会自动成为集成中的变量。请确保字段名中不要包含空格。
本例还包含了打印机信息。在测试自己的集成前，请修改标签名称和打印机名称。示例如下：
Name,Food,ID,btw,printer
Seagull Seed Rings,bird food,1236468,Test.btw,Zebra 105
- 打开 Integration Builder，选择“创建新集成”。
- 在新建集成对话框中，选择文件集成，然后点击确定。
- 首先，设置集成如何检测文件，即设置扫描文件夹。这里是你放置触发文件的地方，集成会自动检测并处理这些文件。示例中使用了 C 盘的一个文件夹。避免使用“我的文档”或桌面等位置，因为这些位置需要额外权限。
- 点击位置旁边的下拉菜单，选择“计算机/网络”
- 输入文件夹名称或使用浏览按钮定位文件夹。
- 将文件模式更改为与你的文件匹配。我这里使用默认的 .dat，你也可以用 .txt、.csv 或其他类型。
- 向下滚动到本节底部。如果你使用 *.txt 文件模式，请将“检测后”选项更改为其他文件扩展名，以避免集成反复检测同一个文件。
- 在左侧菜单中，点击 Actions 旁边的 + 按钮。
- 在弹出的对话框中，点击“转换”类别，然后选择“将文本转换为记录集”，点击确定。
- 点击“数据库连接设置”按钮，按照向导步骤连接到包含你打印所需数据库字段的 CSV 格式文件。
- 将“文本来源”更改为“变量”，并确保变量设置为“%EventData%”。
- 点击“数据库连接设置”按钮，按照向导步骤连接到包含你打印所需数据库字段的 CSV 格式文件。
- 再次点击 Actions 旁边的 + 按钮。
- 点击“数据库”类别，然后选择“针对每个数据库记录”，点击确定。
- 在 Actions 列表中点击“打印文档”操作，并将其拖动到“针对每个数据库记录”操作下方，直到出现缩进。这样“打印文档”操作就成为其子操作。
- 在文档部分，选择你在前面步骤中制作的文档。稍后我们会让它使用变量名。
- 将位置更改为“计算机/网络”
- 输入文件夹名称或使用浏览按钮定位。
- 点击【导入文档设置...】按钮
- 在弹出的对话框中点击确定。
- 点击“命名数据源”标签页，可以看到已为你导入并填写的信息。
你需要在“值”字段中填写的变量名，就是 CSV 文件中的字段名。变量用 % 包裹字段名。例如字段名为 Name，则变量为 %Name%。
- 在对应的列中输入变量。以示例数据库为例，填写如下：
- 如果你想覆盖打印机和标签信息，也可以在这里使用变量。
- 点击“打印选项”标签页
- 在打印机框中输入 %printer%，与 csv 触发文件中的 printer 字段对应
- 点击“文档”标签页。
- 在文档字段中，删除你的 btw 文件名，只保留路径。将文档名替换为 %btw%，与触发文件中的字段名一致。文档字段会像下面这样包含路径和变量：
注意：当路径中包含变量时，预览无法生成，这是正常现象。
- 保存你的集成。
- 点击顶部工具栏的“测试集成”按钮。
- 点击右上角的绿色开始按钮。
- 在文件资源管理器中，将 CSV 触发文件拖入扫描文件夹。集成会被触发并打印标签。
部署集成
测试完集成后，你可以将其部署到生产环境。
- 点击“部署”标签页，然后点击顶部工具栏的“部署”按钮。如果有更改，系统会提示你先保存集成文件。
- 点击下拉列表，选择“本机”以在本地部署。点击下一步。
- 保持“立即部署”选项，点击完成。
- 稍等片刻，管理控制台会自动打开，集成会显示为已部署并正在运行。
适用范围
BarTender 2019 和 BarTender 2021
信息
设置标签
这种类型的标签不使用数据库，而是通过命名数据源来管理所有数据。下面将介绍如何设置这种标签的基本步骤。更多信息请参见帮助文件中的命名数据源。
- 新建一个标签。
- 在标签设计区域创建一个文本对象。
- 右键点击标签，选择属性。
- 从列表中选择数据源。此处会显示“示例文本”。
- 点击名称字段旁边的方框。
- 在弹出的对话框中输入一个唯一名称并点击确定。本例中使用 ProductName。
- 确保类型设置为嵌入数据。
- 当你创建更多文本对象时，命名数据源对话框会有所不同。点击名称字段旁边的方框，选择第一个选项以创建新名称。例如，使用 ProductType。
- 创建好所需数量的命名数据源后，保存标签。
创建集成
在集成过程中，你需要一个触发文件。CSV 字段名不需要与你的命名数据源名称一致，因为你将在集成中将字段与命名数据源进行匹配。这些 CSV 字段名会自动成为集成中的变量。请确保字段名中不要有空格。
本例还包含了打印机信息。在你自己的集成中测试前，请修改标签名称和打印机名称。示例如下：
Name,Food,ID,btw,printer
Seagull Seed Rings,bird food,1236468,Test.btw,Zebra 105
- 打开 Integration Builder，选择“创建新集成”。
- 在新建集成对话框中，选择文件集成，然后点击确定。
- 首先，通过设置扫描文件夹来配置集成如何检测文件。这里是你放置触发文件的地方，集成会自动读取这些文件。比如本例中使用了 C 盘的一个文件夹。输入文件夹名称或点击浏览按钮定位。避免使用“我的文档”或桌面等位置，因为这些位置需要额外权限。
- 将文件模式更改为与你的文件匹配。我这里用的是默认的 .dat，你也可以用 .txt、.csv 或其他类型。
- 向下滚动到本节底部。如果你使用 *.txt 文件模式，请将“检测后”选项更改为其他文件扩展名，这样集成不会反复读取同一个文件。
- 在左侧菜单中，点击 Actions 旁的 + 按钮。
- 在对话框中，点击“转换”类别，然后选择“将文本转换为记录集”，点击确定。
- 点击“数据库连接设置”按钮，按照向导步骤连接到包含你打印时所需数据库字段的 CSV 格式文件。
- 将“文本来源”更改为“变量”，然后确保变量设置为“%EventData%”。
- 点击“数据库连接设置”按钮，按照向导步骤连接到包含你打印时所需数据库字段的 CSV 格式文件。
- 再次点击 Action 旁的 + 按钮。
- 点击“数据库”类别，然后选择“针对每个数据库记录”，点击确定。
- 在 Actions 列表中点击“打印文档”操作，并将其拖到“针对每个数据库记录”操作下方，直到出现缩进。这样“打印文档”操作就成为该操作的子操作。
- 在文档部分，选择你在前面步骤中制作的文档。稍后我们会让它使用变量名。
- 点击 [导入文档设置...] 按钮
- 在弹出的对话框中点击确定。
- 点击“命名数据源”标签页，可以看到已为你导入并填写的信息。
你需要在“值”字段中填写的变量名，就是你 CSV 文件中的字段名。变量用 % 包裹字段名。例如我们的字段名是 Name，那么变量就是 %Name%。
- 在对应的列中输入变量。以示例数据库为例，值如下：
- 如果你想覆盖打印机和标签信息，也可以在这里使用变量。
- 点击“打印选项”标签页
- 在打印机框中输入 %printer%，这与 csv 触发文件中的 printer 字段对应
- 点击“文档”标签页。
- 在文档字段中，删除你的 btw 文件名但保留路径。将文档名替换为 %btw%，这与触发文件中的字段名一致。文档字段会像下面这样包含路径和变量：
注意：当路径中包含变量时，预览无法生成，这是正常现象。
- 保存你的集成。
- 点击顶部工具栏的“测试集成”按钮。
- 点击右上角的绿色“开始”按钮。
- 在文件资源管理器中，将 CSV 触发文件拖入扫描文件夹。集成会被触发并打印标签。
部署集成
测试完集成后，你可以将其部署到生产环境。
- 点击“部署”标签页，然后点击顶部工具栏的“部署”按钮。如果有更改，系统会提示你先保存集成文件。
- 点击下拉列表，选择“本机”以在本地部署。点击下一步。
- 保持“立即部署”选项，点击完成。
- 稍等片刻，管理控制台会自动打开，集成会显示为已部署并正在运行。