在 Dynamics 365 Business Central 中安裝與設定 BarTender 列印連接器
概覽
BarTender Print Connector for Dynamics 365 Business Central 是一款專為 Business Central 設計的外掛程式,
可讓您自訂並輕鬆將 BarTender 世界級的列印引擎直接整合到 Business Central 中。
本指南將教您如何安裝 BarTender Print Connector for Dynamics 365 Business Central,連接至 BarTender Cloud,並設定所有必要的選項,讓您可以順利開始列印。
適用對象
BarTender Cloud
Microsoft Dynamics 365 Business Central
相關資訊
要使用 BarTender Print Connector for Dynamics 365 Business Central,您必須安裝下列應用程式:
- BarTender Cloud(需訂閱 Automation 方案)
- Dynamics 365 Business Central 雲端版
安裝外掛程式
您可以透過以下任一方式安裝 BarTender Print Connector for Dynamics 365 Business Central:
- 在 Microsoft AppSource 商店搜尋 BarTender,然後點擊下載並
安裝外掛程式。 - 在 Business Central 中,於搜尋框輸入 BarTender,點選
BarTender Connector(來自 Microsoft AppSource),然後點擊下載並安裝外掛程式。
準備 BarTender Cloud
在連接 BarTender Print Connector 之前,您需要在 BarTender Cloud 內完成以下步驟:
- 建立一個專門用於 BarTender Print Connector 的 BarTender Cloud 帳戶。這個帳戶不應是現有的使用者帳戶,而是專為此用途新建的帳戶。
- 將您建立的帳戶設定為密碼登入,並將 BarTender Print Connector 註冊到 BarTender Cloud。這樣 Business Central 才能存取您的 BarTender Cloud 租戶空間。詳細操作請參考 BarTender Cloud REST API 使用密碼型 OAuth 驗證。
連接 BarTender Cloud
要將 Business Central 連接到 BarTender Cloud 並同步資料庫,請依照下列步驟操作:
- 在 Business Central 中,點擊右上角的搜尋圖示,於搜尋框輸入 BarTender。
- 在「前往頁面與工作」下,點選 BarTender 設定。
- 在 BarTender 設定頁面,請設定以下選項:
-
Root URL:如果尚未指定,請輸入您的 BarTender Cloud 租戶的基本網址。您可以登入 BarTender Cloud,從瀏覽器網址列複製該網址。基本網址格式如下:
https://YourOrganizationDomainID.Datacenter.bartendercloud.com
如果需要協助查找您的組織網域 ID 或資料中心,請參閱 如何管理 BarTender Cloud 組織的「開始使用」章節。 - Application ID 和 Client Secret:請在對應欄位輸入您的 BarTender Cloud Application ID 和 Client Secret。您可以在 管理雲端帳戶 > BarTender Cloud API,點擊已註冊的 BarTender Print Connector 右側的垂直省略號,然後選擇 檢視 ID & Secret 查詢。
- Username:輸入您的 BarTender Cloud 使用者名稱。
- Password:輸入您的 BarTender Cloud 密碼。
- Print Timeout:可選,設定 BarTender 列印工作逾時前的秒數。如果發現某些列印工作需要較長時間完成,可以適當延長逾時時間。
-
Root URL:如果尚未指定,請輸入您的 BarTender Cloud 租戶的基本網址。您可以登入 BarTender Cloud,從瀏覽器網址列複製該網址。基本網址格式如下:
- 點擊 測試連線,確認連線資訊正確。如果連接 BarTender Cloud 時遇到問題,請參考 這篇文章。
- 點擊 同步資料庫,將您的 BarTender Cloud 印表機、標籤範本及範本資料欄位同步到 Business Central。您想要使用的標籤必須已經在 BarTender Cloud 中建立並設定好,Business Central 才能匯入。詳情請參閱 使用 BarTender Cloud 範本小幫手建立 BarTender 文件。
- 點擊 返回 按鈕離開 BarTender 設定頁面。
BarTender 設定疑難排解
如果在 BarTender 設定過程中出現錯誤,或找不到 Client Secret 欄位,您可能需要更新 BarTender Print Connector for Dynamics 365 Business Central 應用程式。
- 請先點擊 Dynamics 365 右上角的 設定 圖示,選擇管理中心。
- 點選您想要更新的環境。
- 在畫面上方點選 應用程式。
- 在 BarTender Print Connector 項目右側選擇「安裝更新」。
更新完成後,您可能需要重新啟動 Dynamics 365。
設定範本對應
在您能從 Business Central 列印到 BarTender Cloud 之前,必須先設定範本對應,
將 Business Central 的來源資料表與資料庫欄位連結到 BarTender 標籤範本中的目標欄位。
請依照下列步驟操作:
- 在 Business Central 中,點擊右上角的搜尋圖示,於搜尋框輸入 BarTender。
- 在「前往頁面與工作」下,點選 BarTender 範本對應。
- 點擊 新增。
- 在「一般」區塊,設定以下選項:
- 來源資料表 ID:使用下拉選單選擇您想要的 Business Central 資料表 ID,選擇後會自動帶入來源資料表名稱欄位。
- 範本名稱:選擇您想要的 BarTender 文件範本名稱。
-
印表機:選擇您要發送列印工作的印表機。如果選擇 PDF,
還需設定以下額外選項:
- PDF 列印檔案名稱:輸入儲存的 PDF 檔案名稱。
- 描述:輸入對應的描述。請注意,這個描述會在列印時顯示給使用者。
在「印表機設定」區塊還有兩個可選項目,說明如下:
- 列印後關閉文件
- 列印後儲存
欄位對應
- 在 BarTender 範本對應頁面的「欄位對應」區塊,將選定來源資料表的欄位對應到 BarTender 範本欄位,設定如下:
- 來源欄位編號:輸入要對應的來源欄位 ID。點擊省略號可開啟欄位查詢頁面,然後選擇您要的欄位。
- 目標欄位名稱:選擇要對應的目標欄位名稱。
如需新增更多對應,請點選下一行,重複上述步驟設定其他來源與目標欄位。
- 點擊 返回 按鈕關閉 BarTender 範本對應頁面。您的範本現在會出現在可列印標籤清單中。
其他資源
使用 BarTender Print Connector for Dynamics 365 Business Central 進行列印