创建 XML 集成
概述
BarTender 2019 引入了新的文本数据库类型，包括 XML 数据库。Designer 现在可以原生读取这些类型的数据库，因此您也可以将它们用作触发文件，无需 XLST 转换。
提示：有关文本连接器的更多信息，请参阅 BarTender 2019 的文本数据库连接选项（视频）
本教程将为您介绍以下内容：
- 将 XML 文件用作数据库
- 设置 XML 文件集成
- 测试和部署您的集成
教程中为您提供了示例数据。熟悉流程后，您可以使用自己的数据和标签，按照相同的步骤创建适合您需求的 XML 集成。
适用范围
BarTender 2019 及更高版本
信息
创建 XML 数据库
以下是一个虚构宠物食品公司 Seagull Pet Snacks 的 XML 数据库示例。该数据库包含一个简单的头部部分 <HEADER>，数据主体包含在 <DETAILS> 中。
<?xml version="1.0"?>
<LABEL>
<HEADER>
<BRAND>Seagull Pet Snacks</BRAND>
<PACKAGE>Bag</PACKAGE>
<LOCATION>Seattle</LOCATION>
<DETAILS>
<NAME>Kitty Kibble</NAME>
<TAGLINE>Delicious snacks for kitty</TAGLINE>
<FLAVOR>Salmon</FLAVOR>
</DETAILS>
</HEADER>
</LABEL>
创建 XML 数据库的方法如下：
- 打开记事本等文本编辑器。
- 将上面的文本粘贴到编辑器中。
- 点击 文件 > 另存为，将保存类型更改为 所有文件。
- 将文件命名为 Database.xml（例如），然后点击 保存。
创建标签文件
- 打开 BarTender Designer 并新建一个文档。
- 完成新建文档向导后，进入 文件 > 数据库连接设置。
- 选择 创建新的数据库连接，点击 下一步。
- 从列表中选择 XML 文件，点击 下一步。
- 点击 浏览 按钮，找到 database.xml 文件，选择后点击 下一步。
- 本教程中，选择第一个选项 自动从 XML 文件检测架构，点击 下一步。
- 接下来的界面可以让您告诉 BarTender 数据实际存储在 XML 文件的哪个位置。
在上面的数据库中，我们有一个名为 <HEADER> 的头部和一个标记为 <DETAILS> 的详细信息部分。由于我们只想使用 DETAILS 部分的信息作为数据库，请在上方列表中选择它，如下图所示：
请注意，选择不同标签时文件预览会发生变化。下方窗格会以表格形式显示您的数据。如果预览仍显示为标签，请点击右侧的 字段 选项卡切换为表格格式。 - 在上方窗格选择 DETAILS 标签后，点击 下一步。
- 接下来可以取消选中不需要的字段。本例中我们保留全部 3 个字段，点击向导中的 完成，然后在对话框中点击 确定。
- 数据库连接完成后，点击工具箱中的 数据源 选项卡（如果尚未选中）。
- 将这三个字段全部拖拽到您的标签上。
提示：如果 TAGLINE 字段在标签上太宽，可以在文本属性的换行设置中开启自动换行。 - 保存您的标签。现在可以使用了！
创建集成
- 打开 Integration Builder。
- 在开始界面选择 创建新集成。
- 在对话框中选择 文件，点击 确定。
- 在 文件检测 下，选择您的扫描文件夹位置。集成将在此文件夹中查找文件。
注意：建议选择如 C 盘等常用位置的文件夹。文档或桌面中的文件夹可能需要特殊权限才能访问。 - 将文件模式更改为 *.xml，因为我们要扫描 xml 文件。
- 点击 打印文档 操作。
- 在 文档 选项卡，点击 浏览 按钮，找到您在上一步创建的文档。和扫描文件夹一样，建议将该文档放在公共文件夹中，而不是文档或桌面。
- 配置 数据库覆盖 选项。
BarTender 2019： 在 打印选项 选项卡的 数据库覆盖 下，勾选 使用数据源，下拉选项保持为 Integration Input Data。
BarTender 2021： 在 打印选项 选项卡的 数据库覆盖 下，点击蓝色加号添加数据库覆盖选项。将 数据源 设置为变量，变量 字段填写为“%EventData%”。
- 保存您的文件。
测试和部署集成
在部署集成前，我们需要先进行测试并创建一些示例触发文件。触发文件的结构必须与标签文件所连接的数据库结构一致。以下是用于测试的示例数据。数据内容与标签数据库不同，但结构相同：
<?xml version="1.0"?>
<LABEL>
<HEADER>
<BRAND>Seagull Pet Snacks</BRAND>
<PACKAGE>Box</PACKAGE>
<LOCATION>Seattle</LOCATION>
<DETAILS>
<NAME>Dog Crunchies</NAME>
<TAGLINE>Crunchy snacks for your best friend!</TAGLINE>
<FLAVOR>Duck</FLAVOR>
</DETAILS>
</HEADER>
</LABEL>
- 使用上述数据创建一个示例触发文件。请确保文件扩展名为 .XML，因为集成只会识别该类型文件。
- 在集成界面中，点击 测试 选项卡。
- 点击顶部功能区的绿色 开始 按钮。
- 将文件放入您在前面设置的扫描文件夹中。
- 集成消息会开始出现，确认集成已检测到该文件。
- 成功打印后，就可以进行部署了。
- 点击 部署 选项卡，然后点击绿色 部署 按钮。
- 如果尚未保存文件，系统会提示您保存。
- 点击下拉菜单，从列表中选择 本机，点击 下一步。
- 选择 立即部署，然后点击 完成。
- 您的集成现已部署完成。