概述

當您使用 BarTender REST API 自動化標籤列印時，可以利用文字檔案覆蓋標籤的資料庫連線，直接用自訂資料，而無需修改您的 BTW 檔案。

在 API 呼叫時使用 TransformTextToRecordSetAction 函數，會將您的文字檔案資料轉換成資料記錄，並在列印時填入標籤。

本文將示範如何使用 YAML 呼叫這個函數。

如果您想了解 REST API 的基本運作方式，可以參考這篇文章。

適用於

BarTender 2022 及以後版本

Automation 版本及以上

資訊

建立您的 BarTender 文件

1. 建立一個格式如下的資料庫文字檔案：

   Field 1, Field 2, Field 3
   Value 1, Value 2, Value 3
   Value 4, Value 5, Value 6

2. 將檔案儲存為 dbfile.txt。
3. 開啟 BarTender Designer 並建立新文件。
4. 為 dbfile.txt 新增一個文字資料庫連線。（更多資訊請參考這篇文章）
5. 請確認您的資料庫連線名稱為 dbfile：

1. 在標籤上新增 3 個文字物件，並連結到資料庫欄位。
2. 將檔案儲存於 C:\Docs\APITest.btw。

設定您的環境

1. 匯出您的資料庫連線設定：

1. 將檔案儲存於 C:\Docs\dbfolder\ConnectionSetup.xml。
2. 建立一個內容如下的資料檔案：

   Field 1, Field 2, Field 3
   Value 7, Value 8, Value 9
   Value 10, Value 11, Value 12

3. 將其儲存於 C:\Docs\dbfolder\datafile.txt。
4. 在 C:\Docs\ 下建立一個名為 Output 的資料夾。

進行 API 呼叫

1. 在瀏覽器中開啟以下連結：
   

   http://localhost:5159/swagger/index.html

2. 在頁面頂端點擊 Try it out 按鈕：

1. 請確保 File 參數為空。
2. Request body 請選擇 text/vnd.yaml。
3. 在您的 request body 中，加入以下兩個動作：
   1. TransformTextToRecordSetAction，參數如下：
      1. ConnctionSetup：從您的 btw 連線設定匯出的 xml 檔案。
      2. Text：包含要在列印時插入標籤的資料文字檔案。
   2. PrintBTWAction，參數如下：
      1. DocumentFile：要列印的 btw 檔案路徑。
      2. Printer：要使用的印表機。
      3. PrintToFileFolder & PrintToFileFileName：PDF 印表機使用的輸出位置與檔名。
      4. DatabaseOverrides：資料庫覆蓋設定。本例中，資料庫連線 dbfile 會從 datum 變數覆蓋。

ActionGroup:
   Actions:
      - TransformTextToRecordSetAction:
         ConnectionSetup: 
            File: C:\Docs\dbfolder\ConnectionSetup.xml
         Text:
            File: C:\Docs\dbfolder\datafile.txt
         RecordSetVariableName: datum 
      - PrintBTWAction:
         DocumentFile: C:\Docs\APITest.btw
         Printer: PDF
         PrintToFileFolder: C:\Docs\Output
         PrintToFileFileName: test.pdf
         DatabaseOverrides: 
            - Name: dbfile
              Type: VariableName
              DataSourceVariableName: datum 

您也可以嘗試上述 Print 動作的簡化版本：

      - PrintBTWAction:
         DocumentFile: C:\Docs\APITest.btw
         Printer: PDF
         PrintToFileFolder: C:\Docs\Output
         PrintToFileFileName: test.pdf
         DatabaseOverrides: 
            - Name: data
              FileTarget: C:\kit\databases\data.txt

如果呼叫成功，您應該會看到以下訊息：

其他資源

TransformTextToRecordSetAction 類別參考

PrintBTWAction 類別參考