概述

本範例的目標是建立一個包含 BTXML Script 動作的網路 Socket 整合。BarTender XML Script（BTXML Script）讓您可以輕鬆自動化 BarTender，同時也讓第三方開發人員能簡單地將 BarTender 整合到他們的應用程式中。

執行 BTXML Script 後會產生一個 XML 回應。這個 XML 回應會提供有關列印工作的寶貴資訊，例如完成列印所使用的印表機、BarTender 在列印時的設定，以及已列印標籤的完整細節。

情境說明

某公司需要將包含 100 個序號項目的列印工作，送到他們的 HP LaserJet 印表機的第 1 紙匣。當資料（在此為 BTXML Script）透過網路 Socket 傳送並由 BarTender Integration Service 讀取時，列印工作就會執行。

實作步驟

以下步驟說明如何針對上述情境設定、部署並驗證整合。

建立 BarTender 文件

1. 開啟 BarTender。
2. 在檔案選單中，選擇新增以開啟新文件精靈。
3. 選擇空白範本，然後點擊完成以關閉新文件精靈。BarTender 會顯示一個新文件。
4. 在檔案選單中，選擇列印以開啟列印對話框。
5. 在名稱下拉選單中，選擇您要使用的印表機。請務必將 BTXML Script 中的印表機名稱改為您在這裡選擇的印表機。
6. 點擊關閉以關閉列印對話框。
7. 在檔案選單中，選擇版面設定以開啟版面設定對話框，並依需求設定頁面。
8. 設定完成後，點擊確定以關閉版面設定對話框。
9. 在建立選單中，選擇範本物件並依需求設定您的 BarTender 文件。
10. 在檔案選單中，選擇另存新檔，並將 BarTender 文件儲存為 Scriptdoc.btw。
11. 關閉 BarTender。

建立 BTXML Script 觸發文件

<?xml version="1.0" encoding="utf-8"?>		
<XMLScript Version="2.0">
	<Command Name="Job1">
		<Print>
			<Format>c:\BarTender\Scriptdoc.btw</Format>
			<PrintSetup>
			        <NumberSerializedLabels>100</NumberSerializedLabels>
				<Printer>HP LaserJet</Printer>
				<PaperTray>Tray 1</PaperTray>
			</PrintSetup>
		</Print>
	</Command>
</XMLScript>

<?xml version="1.0" encoding="utf-8"?> 

將 BTXML Script 貼到文字檔中，並以 BTXMLScript.txt 為檔名儲存。

建立整合檔案：選擇網路 Socket 整合

1. 開啟 Integration Builder。
2. 點擊建立新整合以開啟新整合對話框。
3. 點擊網路 Socket，然後點擊確定。
4. 在網路 Socket 整合窗格中，選擇整合。
5. 在內容窗格中，將您的整合名稱輸入為「Print 100」。
6. 在啟動整合下拉選單中，選擇自動。
7. 在使用者帳戶下，指定使用者憑證。詳情請參閱 使用空檔案列印文件。
8. 在網路 Socket 整合窗格中，選擇Socket。
9. 在內容窗格中，設定您的通訊協定與連接埠資訊。
10. 在網路位址下，選擇監聽所有網路介面。或者，選擇監聽特定 IP 位址，並從下拉選單選擇或手動輸入 IP 位址。
11. 如有需要，設定您的通訊設定與連線協定。
12. 在網路 Socket 整合窗格中，選擇輸入資料。
13. 在內容窗格中，將編碼屬性設為Unicode (UTF-8)。
14. 在停止讀取時機，選擇收到特定字元序列。
15. 在字元欄位中，輸入</XMLScript>。
16. 啟用將序列包含在輸入資料內容中。
17. 在輸入資料格式中，選擇BTXML Script。
18. 在網路 Socket 整合窗格中，選擇回應。
19. 在內容窗格中，選擇您的回應選項。

建立整合檔案：新增動作到網路 Socket 整合

1. 在網路 Socket 整合窗格中，選擇動作。
2. 在內容窗格中，於執行動作選擇依序。
3. 在重複動作中，指定「1」。
4. 在網路 Socket 整合窗格的動作下，點擊 於列印文件右側以移除預設動作。
5. 選擇動作並點擊 新增以開啟新增動作對話框。
6. 在左側導覽窗格的動作類型清單中選擇列印，然後選擇列印 BTXML Script
7. 點擊確定以關閉新增動作對話框。
8. 列印 BTXML Script 動作會出現在網路 Socket 整合窗格的動作下。
9. 如果尚未選取，請在網路 Socket 整合窗格中點擊列印 BTXML Script。
10. 在內容窗格的動作下，輸入列印 BTXML Script動作的名稱與描述。
11. 在腳本下，於腳本來源下拉選單選擇變數。
12. 如果尚未選取，請在變數下拉選單中選擇EventData。
13. 點擊 於 Integration Builder 左上角，將整合檔案儲存為 BTXML_Integration.btin。

測試「列印 BTXML Script」動作（非整個整合）

若要測試「列印 BTXML Script」動作，您必須先更改部分設定進行測試，測試後再將設定恢復原狀。

1. 在網路 Socket 整合窗格的動作下，選擇列印 BTXML Script。
2. 在內容窗格的腳本下，於腳本來源下拉選單選擇內嵌腳本。
3. 點擊匯入按鈕以匯入您的 BTXML 檔案，或直接將檔案內容貼到提供的視窗中。
4. 點擊腳本視窗右側的測試按鈕。
5. 如果您的「列印 BTXML Script」動作測試通過，請在網路 Socket 整合窗格的動作下再次選擇列印 BTXML Script。
6. 在內容窗格中，將腳本類型設回變數，並將變數類型設回%EventData%。

測試並部署整合檔案

1. 點擊 測試整合，於 Integration Builder 工具列中。
2. 如果您的整合測試通過，點擊 部署整合，以開啟新部署對話框。
3. 輸入部署的名稱與描述。
4. 確認整合檔案設定為 BTXML_Integration.btin。否則，請點擊瀏覽並選擇 BTXML_Integration.btin。
5. 在目標伺服器中，新增您要部署整合檔案的伺服器。
6. 指定所需的錯誤處理設定。
7. 點擊確定以關閉對話框並部署整合檔案。
8. 管理主控台會自動開啟在整合節點，顯示您的整合。

執行情境並檢視整合處理

1. BarTender Integration Service 會監控所選的網路 Socket。請使用您偏好的方式，將 BTXMLScript.txt 的內容透過網路 Socket 傳送。
2. Integration Service 會將 BTXML Script 傳送給 BarTender。
3. BarTender 會依據 BTXML Script 指定的動作，使用指定印表機的第 1 紙匣列印 Scriptdoc.btw 文件 100 份。