创建使用 Excel 文档作为触发文件的集成
概述
从 BarTender 2019 的第 5 个修订版开始,可以在集成中使用 Excel 文档作为触发文件。触发文件是指放置在预定文件夹中时,会触发集成运行的文档。
本教程将为您介绍以下内容:
- 将 Excel 文件用作数据库
- 设置文件集成
- 测试和部署您的集成
本教程将带您完成设置此类集成的基本流程。体验过后,您可以按照相同的步骤,使用您自己的数据进行操作。
适用范围
BarTender 2019 R5 及更高版本。
信息
注意:如果您使用的是 R4 或更早版本,此方法将无法使用。请参阅这篇关于检查修订版本和更新的文章:如何更新到当前版本的 BarTender
创建标签文件
- 下载 database.xlsx 作为您的数据库文件。
- 打开 BarTender Designer 并创建一个新文档。
- 完成新建文档向导后,点击数据库图标。
- 在列表中选择“Microsoft Excel”,然后点击下一步:
- 点击“浏览”按钮,找到 database.xlsx 文件。选择后点击下一步。
- 在此页面,保持所有设置为默认。您可以查看文件预览,了解数据库在这些设置下的显示效果。
- 我们的数据都在 Sheet1 上,这是 Excel 文档中的唯一工作表
- 第一行包含了字段名称
- 点击下一步,然后点击完成。点击确定关闭数据库对话框。
- 现在数据库已连接,如果工具箱中的“数据源”标签还未选中,请点击它。
- 将两个字段都拖拽到您的标签上
- 保存您的标签。现在可以使用了!
创建集成
- 打开 Integration Builder
- 在开始界面选择“创建新集成”
- 在对话框中选择“文件”,然后点击确定:
- 在文件检测下,选择您的扫描文件夹位置。集成将在这里获取文件。
注意:建议选择如 C 盘等常用位置的文件夹。文档或桌面中的文件夹可能需要特殊权限才能访问。
- 将文件模式更改为 *.xlsx,因为我们要扫描 Excel 文件:
- 点击“打印文档”操作。
- 在“文档”标签页,点击“浏览”按钮,找到您在上一步创建的文档。和扫描文件夹一样,建议将该文档放在一个集中的文件夹中,而不是文档或桌面:
在 BarTender 2022 中,您可以指定相对于集成文件本身的路径。如果要使用浏览按钮并指定绝对路径,必须在位置下拉菜单中选择“计算机/网络”。关于相对路径的更多信息,请参阅以下文章:如何将同一文件夹中的 Excel 和 BarTender 文件移动到其他位置? - 在“打印选项”标签页,勾选“使用数据源”旁的复选框,并在下拉列表中选择“文件”。
- 在“文件名”框中输入“%FilePath%”(不带引号)。
- 保存您的文件。
测试和部署集成
在部署集成之前,我们需要先进行测试,并创建一些示例触发文件。触发文件的结构必须与标签文件所连接的数据库一致。以下是用于测试的示例数据。数据内容与标签数据库不同,但结构相同:
请下载 trigger.xlsx 进行测试。
- 在集成界面中,点击“测试”标签。
- 点击顶部功能区的绿色“开始”按钮。
- 将 trigger.xlsx 拖入您在上一步设置的扫描文件夹中。
- 集成消息会开始出现,确认集成已检测到该文件。
- 当您成功打印后,就可以进行部署了。
- 点击“部署”标签,然后点击绿色“部署”按钮:
- 如果您还没有保存文件,系统会提示您保存。
- 点击下拉菜单,从列表中选择“本机计算机”。点击下一步。
- 选择“立即部署”,然后点击完成。
- 您的集成现在已经部署完成。