如何使用数据库覆盖创建基本的CSV集成
概述
CSV 集成是一种最简单且最实用的集成方式之一。只需进行少量设置即可开始使用。这种集成类型会利用触发文件中的信息,覆盖与标签关联的数据库。请确保使用页面顶部的版本下拉菜单,因为不同 BarTender 版本的界面可能有所不同。
如果你在寻找类似的集成方式,可以参考以下其他实用教程:
- 使用打印命令脚本打印文档(视频 - 9:40) - 该集成在脚本头部设置打印机和标签信息,并包含一个 CSV 数据库
- 如何使用命名数据源创建 CSV 集成 - 该 CSV 集成会将 CSV 文件拆分并分配到标签上的命名数据源,也可用于设置打印机和标签信息。
适用范围
BarTender 2022 及更高版本
信息
设置标签
首先,设置标签文件并将其连接到数据库。你可以使用自己的 CSV 文件,或将以下简单示例数据库保存为文本或 CSV 文件:
Name,Food,ID
Seagull Kitty Snax,cat treats,12334668
BarTender Dog Bones,dog food,25346489
- 新建一个标签并连接到文本数据库。如果你不熟悉该流程,可以参考 数据库连接入门(视频 - 5:20)。
- 在工具箱中(默认位于界面左侧),点击“数据源”标签。
- 从工具箱中点击并拖动一个数据库字段到标签设计区域。你希望添加到标签的每个数据库字段都重复此操作。
- 保存标签。
创建集成
要进行集成,你需要一个触发文件。该文件必须与标签所用数据库格式一致。例如,CSV 触发文件必须对应 CSV 数据库,制表符分隔的数据库则需对应制表符分隔的触发文件。如果你使用了上面的示例,可以用如下触发文件:
Name,Food,ID
Seagull Seed Rings,bird food,1236468
- 打开 Integration Builder 并选择“创建新集成”。
- 在新建集成对话框中,选择“文件集成”,然后点击“确定”。
- 首先,通过设置扫描文件夹来配置集成如何检测文件。你的触发文件需要放在这里,集成会自动读取。以我的示例为例,我使用了 C 盘的一个文件夹。避免选择“我的文档”或桌面等位置,因为这些位置需要额外权限才能访问。
- 点击“位置”下拉菜单,选择“计算机/网络”
- 使用“浏览”按钮定位你的文件夹,或直接输入文件夹名称。
- 更改文件模式以匹配你的文件。我这里用的是默认的 .dat,你也可以用 .txt、.csv 或其他类型。
- 向下滚动到本节底部。如果你使用的是 *.txt 文件模式,请将“检测后”选项更改为其他文件扩展名,这样集成就不会反复读取同一个文件。
- 在左侧菜单中,点击“打印文档”操作。
- 在“文档”部分,选择集成触发时要打印的文档。
- 点击“打印选项”标签。在“数据库覆盖”部分,点击“添加数据库覆盖”按钮。将数据源更改为“变量”,在变量下拉列表中选择“EventData”。
-
如果你没有导入文档设置,默认会选中 (默认数据库) 选项。它表示将覆盖文档中第一个文档级数据库连接。它不包括表对象或数据录入控件的数据库连接。如果你想覆盖表对象或数据录入控件的数据库连接,或者你知道连接名称,可以在 要覆盖的数据库 列表中选择已有名称,或点击
添加 ,并在 要覆盖的数据库 文本框中输入名称以添加新连接。 - 保存你的集成。
- 点击顶部工具栏的“测试集成”按钮。
- 点击右上角的绿色“开始”按钮。
- 在文件资源管理器中,将 CSV 触发文件拖入扫描文件夹。集成会被触发并打印标签。
部署集成
测试完集成后,你可以将其部署到生产环境。
- 点击“部署”标签,然后点击顶部工具栏的“部署”按钮。如果有更改,系统会提示你先保存集成文件。
- 点击下拉列表,选择“本机”以本地部署。点击“下一步”。
- 保持“立即部署”选中,点击“完成”。
- 稍等片刻,管理控制台会自动打开,集成会显示为已部署并正在运行。
适用范围
BarTender 2021
信息
设置标签
首先,设置标签文件并将其连接到数据库。你可以使用自己的 CSV 文件,或将以下简单示例数据库保存为文本或 CSV 文件:
Name,Food,ID
Seagull Kitty Snax,cat treats,12334668
BarTender Dog Bones,dog food,25346489
- 新建一个标签并连接到文本数据库。如果你不熟悉该流程,可以参考 数据库连接入门(视频 - 5:20)。
- 在工具箱中(默认位于界面左侧),点击“数据源”标签。
- 从工具箱中点击并拖动一个数据库字段到标签设计区域。你希望添加到标签的每个数据库字段都重复此操作。
- 保存标签。
创建集成
要进行集成,你需要一个触发文件。该文件必须与标签所用数据库格式一致。例如,CSV 触发文件必须对应 CSV 数据库,制表符分隔的数据库则需对应制表符分隔的触发文件。如果你使用了上面的示例,可以用如下触发文件:
Name,Food,ID
Seagull Seed Rings,bird food,1236468
- 打开 Integration Builder 并选择“创建新集成”。
- 在新建集成对话框中,选择“文件集成”,然后点击“确定”。
- 首先,通过设置扫描文件夹来配置集成如何检测文件。你的触发文件需要放在这里,集成会自动读取。以我的示例为例,我使用了 C 盘的一个文件夹。可以输入文件夹名称或使用“浏览”按钮定位。避免选择“我的文档”或桌面等位置,因为这些位置需要额外权限才能访问。
- 更改文件模式以匹配你的文件。我这里用的是默认的 .dat,你也可以用 .txt、.csv 或其他类型。
- 向下滚动到本节底部。如果你使用的是 *.txt 文件模式,请将“检测后”选项更改为其他文件扩展名,这样集成就不会反复读取同一个文件。
- 在左侧菜单中,点击“打印文档”操作。
- 在“文档”部分,选择集成触发时要打印的文档
- 点击“打印选项”标签。在“数据库覆盖”部分,点击“添加数据库覆盖”按钮。将数据源更改为“变量”,在变量下拉列表中选择“EventData”。
-
如果你没有导入文档设置,默认会选中 (默认数据库) 选项。它表示将覆盖文档中第一个文档级数据库连接。它不包括表对象或数据录入控件的数据库连接。如果你想覆盖表对象或数据录入控件的数据库连接,或者你知道连接名称,可以在 要覆盖的数据库 列表中选择已有名称,或点击
添加 ,并在 要覆盖的数据库 文本框中输入名称以添加新连接。 - 保存你的集成。
- 点击顶部工具栏的“测试集成”按钮。
- 点击右上角的绿色“开始”按钮。
- 在文件资源管理器中,将 CSV 触发文件拖入扫描文件夹。集成会被触发并打印标签。
部署集成
测试完集成后,你可以将其部署到生产环境。
- 点击“部署”标签,然后点击顶部工具栏的“部署”按钮。如果有更改,系统会提示你先保存集成文件。
- 点击下拉列表,选择“本机”以本地部署。点击“下一步”。
- 保持“立即部署”选中,点击“完成”。
- 稍等片刻,管理控制台会自动打开,集成会显示为已部署并正在运行。
适用范围
BarTender 2019
信息
设置标签
首先,设置标签文件并将其连接到数据库。你可以使用自己的 CSV 文件,或将以下简单示例数据库保存为文本或 CSV 文件:
Name,Food,ID
Seagull Kitty Snax,cat treats,12334668
BarTender Dog Bones,dog food,25346489
- 新建一个标签并连接到文本数据库。如果你不熟悉该流程,可以参考 数据库连接入门(视频 - 5:20)。
- 在工具箱中(默认位于界面左侧),点击“数据源”标签。
- 从工具箱中点击并拖动一个数据库字段到标签设计区域。你希望添加到标签的每个数据库字段都重复此操作。
- 保存标签。
创建集成
要进行集成,你需要一个触发文件。该文件必须与标签所用数据库格式一致。例如,CSV 触发文件必须对应 CSV 数据库,制表符分隔的数据库则需对应制表符分隔的触发文件。如果你使用了上面的示例,可以用如下触发文件:
Name,Food,ID
Seagull Seed Rings,bird food,1236468
- 打开 Integration Builder 并选择“创建新集成”。
- 在新建集成对话框中,选择“文件集成”,然后点击“确定”。
- 首先,通过设置扫描文件夹来配置集成如何检测文件。你的触发文件需要放在这里,集成会自动读取。以我的示例为例,我使用了 C 盘的一个文件夹。可以输入文件夹名称或使用“浏览”按钮定位。避免选择“我的文档”或桌面等位置,因为这些位置需要额外权限才能访问。
- 更改文件模式以匹配你的文件。我这里用的是默认的 .dat,你也可以用 .txt、.csv 或其他类型。
- 向下滚动到本节底部。如果你使用的是 *.txt 文件模式,请将“检测后”选项更改为其他文件扩展名,这样集成就不会反复读取同一个文件。
- 在左侧菜单中,点击“打印文档”操作。
- 在“文档”部分,选择集成触发时要打印的文档
- 点击“打印选项”标签。在“数据库覆盖”部分,勾选复选框并保持默认选项“集成输入数据”
- 保存你的集成。
- 点击顶部工具栏的“测试集成”按钮。
- 点击右上角的绿色“开始”按钮。
- 在文件资源管理器中,将 CSV 触发文件拖入扫描文件夹。集成会被触发并打印标签。
部署集成
测试完集成后,你可以将其部署到生产环境。
- 点击“部署”标签,然后点击顶部工具栏的“部署”按钮。如果有更改,系统会提示你先保存集成文件。
- 点击下拉列表,选择“本机”以本地部署。点击“下一步”。
- 保持“立即部署”选中,点击“完成”。
- 稍等片刻,管理控制台会自动打开,集成会显示为已部署并正在运行。
其他资源