概述

本示例的目标是创建一个数据库集成，通过对 SQL Server 数据库表的更新来触发 BarTender 文档的打印。集成服务会将表中的数据传递到文档中已命名的数据源，然后打印每一条记录。

场景

某公司有一个后端数据库，里面存有他们希望打印到标签上的数据。可以生成一个表或视图，当有新记录或数据添加时，就会触发标签的打印。这样就无需使用中间件应用程序在数据库和 BarTender 之间进行对接。

实施步骤

以下步骤介绍了如何为上述场景设置、部署和验证集成。

设置数据文件

1. 创建一个 SQL Server 数据库表，内容如下：
2. 
2. 将数据库命名为“TestDb”，表命名为“Table_1”。

创建 BarTender 文档

1. 打开 BarTender。
2. 在文件菜单中，选择新建，打开新建文档向导。
3. 选择空白模板，然后点击完成关闭新建文档向导。BarTender 中会出现一个新文档。
4. 在文件菜单中，选择打印，打开打印对话框。
5. 在名称下拉列表中，选择你要使用的打印机，然后点击关闭关闭打印对话框。
6. 创建两个命名数据源：
1. 在工具箱的数据源选项卡中，选择命名数据源。
2. 在命名数据源的右键菜单中，选择创建命名数据源，打开创建命名数据源向导。
3. 在名称字段中输入 CompanyName。
4. 点击完成。
5. 点击关闭，关闭命名数据源对话框。
6. 在工具箱中再次选择命名数据源，重复上述操作。这次创建一个名为 IDNumber 的命名数据源。
7. 在创建菜单中，向文档添加一个单行文本对象。
8. 在创建菜单中，向文档添加一个 Code 128 类型的条形码。
9. 在文本对象的右键菜单中，选择属性，打开文本属性对话框。
10. 在左侧导航栏的数据源下，选择你刚创建的数据源，目前名为 Sample Text。
11. 如果还未打开，点击数据源选项卡。
12. 在名称右侧，点击以打开更改数据源名称向导。
13. 在向导中，选择链接到现有命名数据源。
14. 在命名数据源列表中，选择 CompanyName。
15. 点击确定关闭更改数据源名称向导。
16. 点击关闭关闭文本属性对话框。
17. 在条形码对象的右键菜单中，选择属性，打开条形码属性对话框。
18. 在左侧导航栏中，选择你刚创建的数据源，目前名为 12345678。
19. 重复第 11-16 步，这次将条形码对象连接到 IDNumber 命名数据源。
20. 在文件菜单中，选择另存为，将 BarTender 文档保存为 CompanyList.btw。

创建集成

1. 打开 Integration Builder。
2. 点击创建新集成，打开新建集成对话框。
3. 选择数据库，点击确定关闭新建集成对话框。
4. 在数据库集成面板中，选择集成。
5. 在属性面板中，将集成的名称填写为“CompanyList”。
6. 在启动集成下拉列表中，选择自动。
7. 在用户帐户下，填写用户凭据。详情请参见 使用空文件打印文档。
8. 在数据库集成面板中，选择新记录检测。
9. 在属性面板中，点击数据库连接设置，打开数据库设置向导。
10. 选择Microsoft SQL Server，点击下一步。
11. 在服务器右侧，输入服务器名称。
12. 选择指定用户名和密码（数据库身份验证），并输入你要使用的用户名和密码。
13. 在数据库下拉列表中，选择你创建表“TestDb”的 SQL Server 数据库名称，点击下一步。
14. 选择使用向导生成 SQL 语句。
15. 将“TestDB”从可用表列表添加到要使用的表列表，点击下一步。
16. 选择记录浏览器，以验证数据是否正确加载。点击确定完成连接。
17. 在属性面板的新记录检测方法下，选择字段值递增。
18. 在字段下拉列表中，选择ID。将最后值保持为 0。这样会对指定最后值和数据库字段之后的所有数据库记录执行集成。
19. 在数据库集成面板中，展开操作节点，然后进一步展开针对每个数据库记录节点。
20. 选择打印文档操作。
21. 在属性面板中，向下滚动到文档部分。
22. 在文档右侧，浏览并选择你之前创建的 BarTender 文档 CompanyList.btw。
23. 在命名数据源下，使用变量数据库字段名为命名数据源分配值。
    
    • 名称列指的是 BarTender 文档中设置的命名数据源，值列指的是实际传递给命名数据源的值。在本例中，就是你在集成中使用的数据库的变量字段名。

    

24. 点击 Integration Builder 左上角的 ，将集成文件保存为 DatabaseIntegration.btin。

测试集成

1. 在 Integration Builder 窗口底部，点击测试选项卡。
2. 在测试窗口右上角，点击开始按钮。
3. 由于数据库表中有 7 条新记录，应打印出 7 份文档。
4. 如果集成运行正常，点击 Integration Builder 左上角的 ，保存集成文件。现在可以将集成部署到管理控制台。

部署集成

1. 在 Integration Builder 工具栏中，点击  部署集成，打开新建部署对话框。
2. 在新建部署对话框中，输入部署的名称和描述。
3. 确保集成文件设置为 DatabaseIntegration.btin。如果不是，点击浏览，找到并选择 DatabaseIntegration.btin.
4. 在目标服务器中，添加你要部署集成文件的服务器。
5. 设置所需的错误处理选项。
6. 点击确定关闭对话框并部署集成文件。
7. 管理控制台会自动打开集成节点，显示你的集成。