概述

本示例的目标是通过 Web 服务集成来打印 BarTender 文档。Web 服务是一种旨在支持网络上机器与机器之间互操作的软件系统。任何能够发送 Web 服务请求的应用程序都可以触发该集成。

本示例允许 Web 服务通过 Web 服务集成向 BarTender 集成服务发送 GET 请求。Web 服务会传递一些值，这些值将被集成用于 BarTender 文档中的命名数据源。

场景

某公司拥有一个外部 ERP 系统，需要通过 Web 请求在 BarTender 文档上填写一个文本字段和一个条码值。为实现这一目标，Web 请求的数据将传递给集成，集成再将数据传递给指定 BarTender 文档的命名数据源。命名数据源会在打印时填充文档上的文本对象和条码对象。

实施步骤

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

创建 BarTender 文档

1. 打开 BarTender。
2. 在文件菜单中，选择新建，打开新建文档向导。
3. 选择空白模板，然后点击完成关闭新建文档向导。BarTender 中会出现一个新文档。
4. 在文件菜单中，选择打印，打开打印对话框。
5. 在名称下拉列表中，选择你要使用的打印机。
6. 点击关闭，关闭打印对话框。
7. 在文件菜单中，选择页面设置，打开页面设置对话框，根据需要配置页面。
8. 页面配置完成后，点击确定关闭页面设置对话框。
9. 在创建菜单中，选择文本，然后选择单行。
10. 在模板上点击，放置文本对象。
11. 在创建菜单中，选择条码，然后选择Code 128。
12. 在模板上点击，放置条码对象。
13. 双击文本对象的边框，打开文本属性对话框。
14. 在数据源选项卡中，在名称字段右侧，点击，打开更改数据源名称向导。
15. 在名称字段中输入“Company”（不带引号）。
16. 点击确定关闭更改数据源名称向导。
17. 保持类型为嵌入数据。
18. 在嵌入数据字段中输入你的公司名称。
19. 点击关闭关闭文本属性对话框。
20. 双击条码对象，打开条码属性对话框。
21. 在数据源选项卡中，在名称字段右侧，点击，打开更改数据源名称向导。
22. 选择命名数据源。
23. 在名称字段中输入“IDNumber”（不带引号）。
24. 点击确定关闭更改数据源名称向导。
25. 保持类型为嵌入数据。
26. 在嵌入数据字段中输入任意 4 位数字。
27. 点击关闭关闭条码属性对话框。
28. 将文件保存为 GETSampleDocument.btw。
29. 关闭 BarTender。

创建集成文件

1. 打开 Integration Builder。
2. 点击创建新集成，打开新建集成对话框。
3. 点击Web 服务，然后点击确定。
4. 在Web 服务集成面板中，确保已选择服务。
5. 在Web 服务集成面板中，选择集成。
6. 在属性面板中，为你的集成命名，并可填写描述。
7. 在启动集成下拉列表中，选择自动。
8. 在Web 服务集成面板中，选择响应。
9. 在属性面板的响应下，选择application/json作为Content-type。
10. 在来源下拉列表中，选择操作摘要，这样集成执行后会收到摘要信息。
8. 在Web 服务集成面板中，选择变量。
8. 滚动到属性面板底部，点击，在名称字段中输入“Company”（不带引号）。
8. 点击，创建另一个新变量。在名称字段中输入“IDNumber”（不带引号）。
11. 在Web 服务集成面板的操作下，选择打印文档。
12. 在属性面板的文档下，输入之前创建的 BarTender 文档 GETSampleDocument.btw 的路径和文件名。
12. 点击，将命名数据源和打印选项覆盖添加到集成中。
13. 向下滚动到命名数据源。如果尚未启用，请勾选为命名数据源指定值。
14. 在命名数据源列表中，删除Company命名数据源的当前值。
15. 在值列右侧，点击，选择变量。
16. 在插入变量对话框中，选择Company，点击确定。这样会将Company命名数据源的值设置为%Company%。
17. 在命名数据源列表中，删除IDNumber命名数据源的当前值。
18. 在值列右侧，点击，选择更多变量。
19. 在插入变量对话框中，选择IDNumber，点击确定。这样会将IDNumber命名数据源的值设置为%IDNumber%。
20. 点击 Integration Builder 左上角的，将集成文件保存为WebRequestPrint.btin。

现在集成已准备好部署。

部署集成

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

运行场景并查看集成处理过程

1. BarTender 集成服务正在监控所选的 Web 服务。通过你喜欢的方式使用 url 发送 Web 请求。url 类似于：http://<host>/Integration/WebRequestPrint/Execute。

2. 集成服务读取 Web 请求并将值传递给 BarTender。
3. BarTender 文档的命名数据源现在已由 Web 请求中的值填充。
4. BarTender 文档开始打印。