建立 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 標籤後，點選 下一步。
- 接下來的畫面可讓您取消勾選不需要的欄位。本範例中，三個欄位都保留勾選。點選精靈上的 完成，然後在對話框上點選 確定。
- 資料庫連線完成後，若工具箱尚未選取 資料來源 分頁，請點選它。
- 將三個欄位全部拖曳到您的標籤上。
提示：如果 TAGLINE 太寬，您可以在文字屬性框的自動換行區段開啟換行功能。 - 儲存您的標籤。現在已經可以使用了！
建立整合
- 打開 Integration Builder。
- 在開始畫面選擇 建立新整合。
- 在對話框中選擇 檔案，然後點選 確定。
- 在 檔案偵測 下，選擇您的掃描資料夾位置。這是整合會去抓取檔案的地方。
注意：建議選擇像 C 槽這樣的常用位置。若選擇「我的文件」或桌面，可能需要額外權限才能存取。 - 將檔案篩選條件改為 *.xml，因為我們要掃描 xml 檔案。
- 點選 列印文件 動作。
- 在 文件 分頁，使用 瀏覽 按鈕找到您在前一節建立的文件。和掃描資料夾一樣，建議將文件放在集中管理的資料夾，而非「我的文件」。
- 設定 資料庫覆寫 選項。
BarTender 2019： 在 列印選項 分頁的 資料庫覆寫 下，勾選 使用資料來源，並將下拉選單保持為「整合輸入資料」。
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，因為整合會依此尋找檔案。
- 在整合開啟狀態下，點選 測試 分頁。
- 點選上方功能區的綠色 開始 按鈕。
- 將檔案放入您在前一節設定的掃描資料夾。
- 整合訊息會開始出現，確認已偵測到檔案。
- 當您成功列印後，就可以進行部署。
- 點選 部署 分頁，然後點選綠色 部署 按鈕。
- 如果尚未儲存檔案，系統會提示您儲存。
- 點選下拉選單，從清單中選擇 本機電腦，然後點選 下一步。
- 選擇 立即部署，然後點選 完成。
- 您的整合已經部署完成。