使用数据文件集成打印文档(视频 - 6:00)
适用于:BarTender 2019 及更高版本。
概述
在本示例中,您将设计一个集成方案:当检测到触发文件后,打印指定的 BarTender 文档,并且该触发文件本身包含用于填充文档模板对象的数据。这里涉及的技术同样适用于后续的其他示例。
场景
一家邮购公司需要在每次打包订单时,打印包含销售信息的物品。销售应用程序会生成一个以逗号分隔的文本文件,并将其保存在 Integration Service 监控的目录中。当检测到该文件时,Integration Service 会删除触发文件,将文件内容发送给 BarTender 以填充文档模板对象,并打印该文档。
实施步骤
以下步骤将介绍如何为上述场景设置、部署并验证集成。
设置数据文件
- 创建一个用于保存数据文件的网络文件夹。该文件夹将由 Integration Service 进行监控。本例中,文件夹命名为
\\ShippingServer\NewOrders. - 创建一个包含逗号分隔数据的文本文件(如下所示)。您可以复制并粘贴以下数据到文本文件中。
-
BusinessName,ContactName,Position,Address1,City,State,Zip,Country,Phone1,Phone2Around the Town,Jerome Davis,Buyer,1220 Governor Sq.,Atlanta,GA,31002,USA,(706) 555-7788,(706) 555-6750
- 将文本文件保存到第 1 步创建的目录
\\ShippingServer\NewOrders,文件名为 "order.txt"。
创建 BarTender 文档
- 打开 BarTender。
- 在文件菜单中,选择新建,打开新建文档向导。
- 选择空白模板,然后点击完成关闭新建文档向导。
- 在文件菜单中,选择打印,打开打印对话框。
- 在名称下拉列表中,选择您要使用的打印机,然后点击关闭关闭打印对话框。
- 在文件菜单中,选择页面设置,打开页面设置对话框,根据需要配置页面。
- 页面配置完成后,点击确定关闭页面设置对话框。
- 在文件菜单中,选择数据库连接设置,打开数据库设置向导。
- 点击文本文件,指定所需的数据库类型,然后点击下一步。
- 在向导的选择文件页面,点击选择文件按钮。
- 浏览到
\\ShippingServer\NewOrders并双击 order.txt 进行选择。 - 在选择文件页面点击下一步。
- 在文件格式页面,确保字段分隔符下拉列表中选择了逗号,然后点击下一步。
- 在字段名称页面,确保选择了自动分配顺序字段名称,然后点击完成。
- 点击确定关闭数据库设置对话框。
- 在创建菜单中,选择文本。
- 在文本对象下拉列表中,选择单行。
- 在模板上任意位置点击以添加文本对象。
- 右键点击文本对象,在右键菜单中选择属性,打开文本属性对话框。
- 在左侧导航栏中,点击文本对象的数据源。
- 在数据源选项卡中,点击
位于类型字段右侧,打开更改数据源类型向导。 - 在下拉列表中选择数据库字段,然后点击下一步。
- 在字段名称下拉列表中选择字段 2(在文本文件中,第二个字段为买家姓名)。
- 在示例字段数据中输入“买家姓名”作为示例数据。
- 点击完成关闭向导。
- 点击关闭关闭文本属性对话框。
- 如果您希望在模板中包含更多数据库字段,只需返回第 16 步,每次将文本对象分配到数据库中的相应字段。否则,请继续第 28 步。
- 在文件菜单中,选择保存,将 BarTender 文档保存为 NewOrderAddress.btw。
- 将示例数据库文件 order.txt 从 Integration Service 扫描的文件夹移到其他文件夹。
- 关闭 BarTender。
创建并部署集成文件
- 打开 Integration Builder。
- 点击创建新集成,打开新建集成对话框。
- 点击文件,然后点击确定。
- 在文件集成面板中,选择集成。
- 在属性面板中,将集成名称填写为“Each Order”。
- 在启动集成下拉列表中,选择自动。
- 在用户账户下,指定用户凭据。详情请参见 使用空文件打印文档。
- 在文件集成面板中,选择文件检测。
- 在属性面板的检测选项下,从位置下拉列表中选择“计算机/网络”。
- 在扫描文件夹选项中,输入路径或浏览到您希望 Integration Service 监控的文件夹。本例中,指定为您在“设置数据文件”部分创建的 \\ShippingServer\NewOrders 文件夹。
- 在文件模式字段中输入 "*.txt"(不包含引号)。
- 向下滚动到检测后操作部分。在操作下拉列表中选择删除文件。当 Integration Service 检测到文件时,会自动读取文件中的所有数据并存入变量;随后,该文件已不再需要。
- 在文件集成面板中,点击打印文档。(这是默认操作。)
- 在属性面板的文档下,点击浏览按钮,选择您之前创建的 BarTender 文档 NewOrderAddress.btw,点击打开。
- 向下滚动到数据库覆盖。在数据源下拉列表中选择集成输入数据。
- 点击
位于 Integration Builder 左上角,将集成文件保存为 NewOrderAddress.btin。 - 点击
部署集成,打开新建部署对话框。 - 输入部署的名称和描述。
- 确保集成文件设置为 NewOrderAddress.btin。如果不是,请点击浏览,选择 NewOrderAddress.btin。
- 在目标服务器中,添加您希望部署集成文件的服务器。
- 在计划中,选择立即。
- 根据需要指定错误处理设置。
- 点击确定关闭对话框并部署集成文件。
- 管理控制台会自动打开集成节点,显示您的集成。
运行场景并查看集成处理过程
- 在管理控制台中,点击集成名称“Each Order”,打开该集成的详细视图。
- 在下一步运行示例场景时,您可以在该视图的输出部分观察集成的处理步骤。
- 使用 Windows 资源管理器,将文本文件 order.txt 复制到文件夹
\\ShippingServer\NewOrders。 - 集成会几乎立即开始,删除 NewOrders 文件夹中的文本文件,并发送 BarTender 文档进行打印。