跳至主內容
Deutsch English (United States) Español Français 日本語 简体中文

搜尋

此段落內的文章

檢視更多

如何使用命名資料來源建立 CSV 整合

Samantha Petro

BarTender Content Team

  • 更新於

概述

CSV 整合是最簡單且實用的整合方式之一。與其他類型的整合不同，這種整合會將觸發檔案中的 CSV 資料庫拆解成變數，然後傳遞給標籤檔案。請務必使用上方的版本下拉選單，因為不同 BarTender 版本的介面可能會有所不同。

如果您正在尋找類似的整合方式，請參考以下其他實用教學：

適用於

BarTender 2022 及更新版本

資訊

設定標籤

這種類型的標籤不使用資料庫，而是透過命名資料來源來處理所有資料。以下將介紹如何設定這種標籤的基本步驟。欲了解更多資訊，請參閱說明檔案中的命名資料來源。

  1. 建立一個新標籤。
  2. 在標籤設計區新增一個文字物件。
  3. 在標籤上按右鍵，選擇「內容」。
  4. 從清單中選擇資料來源。會顯示「範例文字」。
  5. 點選名稱欄位旁的方框。
  6. 在對話框中輸入一個獨特名稱，然後點選「確定」。本範例請使用 ProductName。

csv_nds_name.png

  1. 確認類型設為「內嵌資料」。
    NDS_EmbeddedData2022.png
  2. 當您建立更多文字物件時，命名資料來源的對話框會有所不同。點選名稱欄位旁的方框時，請選擇第一個選項來建立新名稱。例如，使用 ProductType。

csv_nds_name2.png

  1. 建立好所需的命名資料來源後，請儲存標籤。

建立整合

在建立整合時，您需要一個觸發檔案。CSV 欄位名稱不必與您的命名資料來源名稱相同，因為您會在整合中將欄位對應到命名資料來源。這些 CSV 欄位名稱會自動成為整合中的變數。請確保欄位名稱中不要有空格。

本範例也包含印表機資訊。請在測試前修改標籤名稱和印表機名稱。範例如下：

  Name,Food,ID,btw,printer
  Seagull Seed Rings,bird food,1236468,Test.btw,Zebra 105
  1. 開啟 Integration Builder，選擇「建立新整合」。
  2. 在新整合對話框中，選擇「檔案整合」並點選「確定」。
  3. 首先，設定整合如何偵測檔案，請設定掃描資料夾。這是您放置觸發檔案的位置，整合會自動偵測。以本範例來說，我使用 C 槽的資料夾。請避免使用「我的文件」或桌面等位置，因為這些位置需要額外權限才能存取。
    1. 點選「位置」旁的下拉選單，選擇「電腦/網路」
    2. 輸入資料夾名稱，或使用「瀏覽」按鈕選取。
  4. 將檔案類型模式改為符合您的檔案。我這裡使用預設的 .dat，您也可以用 .txt、.csv 或其他類型。

csv_scan_2022.png

  1. 往下捲動到本區底部。如果您使用 *.txt 檔案類型，請將「偵測後」的選項改為其他副檔名，避免整合重複偵測同一個檔案。
  2. 在左側選單中，點選「動作」旁的 + 號。
  3. 在對話框中，點選「轉換」類別，然後選擇「將文字轉換為記錄集」，再點選「確定」。
    • 點選「資料庫連線設定」按鈕，依照精靈步驟連線到包含您列印時所需資料庫欄位的 CSV 格式檔案。
      FEDBR_action_dbconnectionsetup_2022.jpg
    • 將「文字來源」改為「變數」，並確認變數設為「%EventData%」。
      FEDBR_action_textsourcevariable_2022.jpg
  4. 再次點選「動作」旁的 + 號。
  5. 點選「資料庫」類別，然後選擇「針對每筆資料庫記錄」，再點選「確定」。
  6. 在動作清單中，點選「列印文件」動作，並將其拖曳到「針對每筆資料庫記錄」動作下方，直到出現縮排。這樣「列印文件」動作就會成為其子動作。

csv_nds_child2.png

  1. 在「文件」區段，選擇您在前一節建立的文件。稍後我們會讓它使用變數名稱。
    1. 將位置改為「電腦/網路」
    2. 輸入資料夾名稱，或使用「瀏覽」按鈕選取。

csv_document_2022.png

  1. 點選［匯入文件設定...］按鈕
  2. 在對話框中，點選「確定」。
  3. 切換到「命名資料來源」分頁，您會看到已經自動匯入並填入的資訊。

csv_nds_override2.png

您要輸入在「值」欄位中的變數名稱，就是來自 CSV 的欄位名稱。變數名稱需以 % 符號包住。例如其中一個欄位名稱是 Name，對應的變數就是 %Name%。

  1. 在對應欄位中輸入變數。以範例資料庫來說，值如下：

csv_nds_override3.png

  1. 如果您想要覆寫印表機和標籤資訊，也可以在這裡使用變數。
    1. 點選「列印選項」分頁
    2. 在印表機欄位輸入 %printer%，這會對應到 csv 觸發檔案中的 printer 欄位
    3. 點選「文件」分頁。
    4. 在文件欄位中，移除您的 btw 檔案名稱，但保留路徑。將文件名稱改為 %btw%，這會對應到觸發檔案中的欄位名稱。文件欄位會像這個範例一樣包含路徑和變數：

csv_nds_override_name.png

請注意，當路徑中包含變數時，預覽會無法產生，這是正常現象。

  1. 儲存您的整合設定。
  2. 點選上方工具列的「測試整合」按鈕。
  3. 點選右上角的綠色「開始」按鈕。
  4. 在檔案總管中，將 CSV 觸發檔案拖曳到掃描資料夾。整合會自動觸發並列印標籤。

部署整合

測試完整合後，您可以將其部署到正式環境。

  1. 點選「部署」分頁，然後點選上方工具列的「部署」按鈕。如果有任何變更，系統會提示您先儲存整合檔案再繼續。
  2. 點選下拉清單，選擇「本機電腦」以在本機部署。點選「下一步」。
  3. 保持「立即部署」選項，然後點選「完成」。
  4. 稍等片刻，管理主控台會自動開啟，整合會顯示為已部署並正在執行。

csv_integration2.png

 

適用於

BarTender 2019 和 BarTender 2021

資訊

設定標籤

這種類型的標籤不使用資料庫，而是利用命名資料來源來處理所有資料。以下將介紹如何設定這種標籤的基本步驟。更多資訊請參考說明文件中的命名資料來源。

  1. 建立一個新的標籤。
  2. 在標籤設計區新增一個文字物件。
  3. 在標籤上按右鍵，選擇「內容」。
  4. 從清單中選擇資料來源。會顯示「範例文字」。
  5. 點選名稱欄位旁邊的方框。
  6. 在對話框中輸入一個獨特的名稱，然後點選「確定」。本例中請使用 ProductName。

csv_nds_name.png

  1. 確認類型設為「內嵌資料」。
    NDS_EmbeddedData2021.png
  2. 當你建立更多文字物件時，命名資料來源的對話框會有所不同。點選名稱欄位旁的方框時，請選擇第一個選項來建立新名稱。例如可使用 ProductType。

csv_nds_name2.png

  1. 當你建立好所需的命名資料來源後，請儲存標籤。

建立整合

在整合時，你需要一個觸發檔案。CSV 欄位名稱不需要和你的命名資料來源名稱相同，因為你會在整合時將欄位對應到命名資料來源。這些 CSV 欄位名稱會自動成為整合中的變數。請確保欄位名稱不要有空格。

這個範例也包含了印表機資訊。請在測試前修改標籤名稱和印表機名稱。範例如下：

  Name,Food,ID,btw,printer
  Seagull Seed Rings,bird food,1236468,Test.btw,Zebra 105
  1. 開啟 Integration Builder，選擇「建立新整合」。
  2. 在新整合對話框中，選擇「檔案整合」並點選「確定」。
  3. 首先，設定整合如何偵測檔案，請設定掃描資料夾。這是你放置觸發檔案的位置，整合會自動偵測。以本例來說，我使用 C 槽的資料夾。請輸入資料夾名稱或使用「瀏覽」按鈕選取。避免使用「我的文件」或桌面等位置，因為這些位置需要額外權限。
  4. 將檔案類型模式改為符合你的檔案。我這裡使用預設的 .dat，你也可以用 .txt、.csv 或其他格式。

csv_scan_2016.png

  1. 往下捲動到本區底部。如果你使用 *.txt 檔案類型，請將「偵測後」的選項改為其他副檔名，避免整合重複偵測同一個檔案。
  2. 在左側選單中，點選「動作」旁的 + 號。
  3. 在對話框中，點選「轉換」分類，然後選擇「將文字轉換為記錄集」，再點選「確定」。
    • 點選「資料庫連線設定」按鈕，依照精靈步驟連接到包含你列印時所需資料庫欄位的 CSV 格式檔案。
      FEDBR_action_dbconnectionsetup_2021.jpg
    • 將「文字來源」改為「變數」，然後確認變數設為「%EventData%」。
      FEDBR_action_textsourcevariable_2021.jpg
  4. 再次點選「動作」旁的 + 號。
  5. 點選「資料庫」分類，然後選擇「針對每筆資料庫記錄」，再點選「確定」。
  6. 在動作清單中點選「列印文件」動作，並將它拖曳到「針對每筆資料庫記錄」動作下方，直到它縮排。這樣「列印文件」動作就會成為其子動作。

csv_nds_child2.png

  1. 在「文件」區段，選擇你在前一節建立的文件。稍後我們會讓它使用變數名稱。

csv_document_2016.png

  1. 點選 [匯入文件設定...] 按鈕
  2. 在對話框中點選「確定」。
  3. 切換到「命名資料來源」分頁，可以看到已經自動匯入並填入的資訊。

csv_nds_override2.png

你要輸入在「值」欄位的變數名稱，就是來自 CSV 的欄位名稱。變數以 % 包住欄位名稱。例如我們有一個欄位名稱是 Name，對應的變數就是 %Name%。

  1. 在對應的欄位輸入變數。以範例資料庫來說，值如下：

csv_nds_override3.png

  1. 如果你想要覆蓋印表機和標籤資訊，也可以在這裡使用變數。
    1. 點選「列印選項」分頁
    2. 在印表機欄位輸入 %printer%，這會對應到 csv 觸發檔案中的 printer 欄位
    3. 點選「文件」分頁。
    4. 在文件欄位中，移除你的 btw 檔案名稱但保留路徑，將文件名稱改為 %btw%，這會對應到觸發檔案中的欄位名稱。文件欄位會像這個範例一樣同時有路徑和變數：

csv_nds_override_name.png

請注意，當路徑中包含變數時，預覽會無法產生，這是正常現象。

  1. 儲存你的整合設定。
  2. 點選上方工具列的「測試整合」按鈕。
  3. 點選右上角的綠色「開始」按鈕。
  4. 在檔案總管中，將 CSV 觸發檔案拖曳到掃描資料夾。整合會自動觸發並列印標籤。

部署整合

測試整合後，你可以將它部署到正式環境。

  1. 點選「部署」分頁，然後點選上方工具列的「部署」按鈕。如果有任何變更，系統會提示你先儲存整合檔案。
  2. 點選下拉清單，選擇「本機電腦」以在本機部署。點選「下一步」。
  3. 保持「立即部署」選項，然後點選「完成」。
  4. 稍等片刻，管理主控台會自動開啟，整合會顯示為已部署並正在執行。

csv_integration2.png

其他資源

相關文章