概述

本範例的目標是使用網路服務整合來列印 BarTender 文件。網路服務是一種設計用於支援機器與機器之間透過網路互通的軟體系統。任何能夠發送網路服務請求的應用程式都可以觸發此整合。

這個範例讓網路服務可以透過 Web Service 整合發送 GET 請求給 BarTender Integration Service。網路服務會傳遞數值，整合會將這些數值用於 BarTender 文件中的命名資料來源。

情境說明

某公司擁有外部 ERP 系統，需要透過網路請求將文字欄位和條碼值填入 BarTender 文件。為達成此目的，網路請求的資料會傳遞給整合，然後再傳遞到指定 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. 在內嵌資料欄位輸入任意四位數字。
27. 點擊關閉以關閉條碼屬性對話框。
28. 將檔案儲存為 GETSampleDocument.btw。
29. 關閉 BarTender。

建立整合檔案

1. 開啟 Integration Builder。
2. 點擊建立新整合以開啟新整合對話框。
3. 點擊Web Service，然後點擊確定。
4. 在Web Service 整合窗格中，確認已選取服務。
5. 在Web Service 整合窗格中，選擇整合。
6. 在屬性窗格中，為你的整合命名，並可選擇輸入描述。
7. 在啟動整合下拉選單中，選擇自動。
8. 在Web Service 整合窗格中，選擇回應。
9. 在屬性窗格的回應下，於Content-type下拉選單中選擇application/json。
10. 在來源下拉選單中，選擇動作摘要，這樣整合執行後會收到摘要。
8. 在Web Service 整合窗格中，選擇變數。
8. 捲動到屬性窗格底部，點擊 ，在名稱欄位輸入「Company」（不含引號）。
8. 點擊 新增另一個變數。在名稱欄位輸入「IDNumber」（不含引號）。
11. 在Web Service 整合窗格的動作下，選擇列印文件。
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 Integration Service 正在監控所選的網路服務。請用你偏好的方式透過網址發送網路請求。網址格式大致如下：http://<host>/Integration/WebRequestPrint/Execute。

2. 整合服務會讀取網路請求並將數值傳遞給 BarTender。
3. BarTender 文件的命名資料來源現在會由網路請求中的數值填入。
4. BarTender 文件開始列印。