概述

列印流程是 BarTender 及其眾多元件的核心。當列印作業失敗時，檢查這個流程有助於找出問題發生的位置以及如何解決。

以下是 BarTender 正常列印流程的流程圖。

當出現問題時，通常是流程中的某個環節斷裂，或是某個步驟出現問題。您可以從綠色流程開始，依序檢查到橘色流程，讓故障排除更有效率。依照順序逐步排查，可以避免在前一個步驟已經出錯的情況下，重複排查同一問題。

以下將每個流程拆解，並說明可能出現問題的地方。這不是一份完整的列印故障排除指南，但足以讓您開始進行排查。

發送列印作業請求

在開始排查時，了解是什麼觸發了列印作業非常重要。對於 Designer 或 Print Station 這類應用程式，列印作業會在使用者點擊列印按鈕時開始。像是整合或 SDK 這類自動化，則會模擬這個動作，無需使用者直接操作即可啟動列印。

點擊列印按鈕通常不需要排查，但自動化流程則有多個元件需要檢查。請檢查觸發檔案、Integration Builder 的設定，或是您在 SDK 或任何 ActiveX 自動化中呼叫列印指令的程式碼。

• 印表機是否正確列出？
• 份數設定是否有效？
• 如果您使用 Print Command Scripts 或 BTXML 等指令，是否有遺漏特殊字元或指令？

如果指令或呼叫有誤，修正後可能就能解決問題，無需繼續後續排查。

重點整理

• 了解列印作業是如何被啟動的。
• 檢查所有列印作業的設定或指令。

取得列印資料

這是列印流程中很重要且常出現問題的步驟。BarTender 可以透過多種方式取得列印資料，包括資料輸入表單、資料庫連線，以及觸發檔案內的資料。當這個步驟出現問題時，您需要確保 BarTender 能夠連接到資料來源，且資料正確無誤。

資料輸入表單較難排查，通常是使用者輸入錯誤。資料庫連線則較容易控制。這類情況主要出現在 Designer、Print Station 和 Print Portal 列印時，當然也可能出現在整合（或其他自動化）中。您需要確保 BarTender 能連接到所使用的資料庫，且資料庫內有正確的資料。通常只要開啟 BarTender 的 資料庫連線設定 對話框即可檢查。

當涉及自動化（如整合）時，資料很可能來自標籤以外的來源。這讓排查變得更困難，因為資料來源可能很多。以下不是完整清單，但提供一些建議，協助您開始排查自動化取得資料的問題：

• 在管理主控台或 Integration Builder 中檢查整合日誌是否有錯誤。
• 檢查觸發檔案（大多數整合用）是否有資料且資料正確。
• 檢查資料庫連線（針對資料庫整合）是否沒有連線錯誤。
• 確保觸發檔案的資料庫類型與標籤的資料庫一致。例如，若標籤連接的是 CSV 檔案，則不能在整合中給它 XML 資料庫，資料庫類型必須相符。
• 如果使用命名資料來源，請確保所有資料來源都有列出。未列出或空白的命名資料來源，列印時可能會使用範例資料。

ActiveX 和 .NET 應用程式有更多潛在資料來源，複雜度也更高。不過，上述基本排查原則同樣適用，有助於找出資料問題。

重點整理

• 確保 BarTender 能連接到資料庫。
• 確保資料庫內有正確的資料。

將資料轉換為列印請求

這個步驟高度依賴於所列印的模板。它會處理所有轉換與效能最佳化，然後將作業轉換為印表機可用的程式碼。這個步驟很看情況，標籤或印表機越複雜，排查就越需要深入。

轉換是兩種資料處理中較大的部分。它們可能出現在多個地方，只要仔細檢查，就能根據標籤或自動化的使用情況逐一排查。

• 資料來源轉換是套用在標籤上任何物件的轉換。文字物件、條碼或資料庫欄位都可能有轉換。開啟每個有轉換的物件對話框，有助於找出潛在問題。
• 文件動作允許某些轉換在列印開始或過程中執行。檢查所有不是在列印後執行的文件動作，有助於找出有問題的轉換。
• 文件層級腳本較難排查。請檢查所有腳本事件，並找出有錯誤的腳本，以排查這類轉換問題。
• 整合轉換是在整合層級執行，設定在整合檔案中，而不是標籤檔案。與標籤轉換不同，整合轉換可能影響所有與該整合搭配的文件。請檢查說明文件中列出的所有轉換動作，並確保所有轉換都正常運作。

效能最佳化可在 BarTender Designer 的列印對話框中找到，僅限使用 Seagull 印表機驅動程式時可用。如果有這個分頁，請先關閉所有印表機最佳化設定，若這樣能解決問題，再逐一開啟，直到找出有問題的最佳化項目。如果還是無法解決，請繼續下一步。

如果您未使用 Seagull 驅動程式，請參考印表機製造商的網站或客服，尋求最佳化相關協助。

重點整理

• 檢查 BarTender 中所有轉換與資料來源。
• 檢查 BarTender 的效能分頁。

將列印請求轉換為印表機程式碼

這個步驟涉及多種技術，目的是將 BarTender 的列印作業傳送到您的印表機。轉換為印表機程式碼時，BarTender 會與印表機驅動程式溝通，建議使用 Seagull 驅動程式。請參考 Seagull 驅動程式技術文件 。

轉換完成後，作業必須排入佇列並傳送到印表機。

雖然這個流程很複雜，且可控性有限，但還是有一些方法可以確保這個步驟正常運作。

首先，您可以直接 列印到檔案 ，這會在您的電腦上產生一個包含印表機程式碼的檔案，這些程式碼原本會傳送到印表機。雖然這個檔案內容不易閱讀，但您應該能看到資料。

如果您遇到間歇性列印問題，Seagull 驅動程式可以記錄產生的印表機程式碼。這樣您可以比較正常與異常的列印作業，並在印表機手冊中查找有問題的指令。要開啟列印程式碼記錄，請參考印表機「印表機內容」中的說明檔案。

這個流程的最後一步是將印表機程式碼交給印表機佇列。小型作業通常進入佇列後很快就完成，您可能來不及看到。請暫停印表機，然後從 BarTender 發送一個作業，確認作業有出現在清單上。再解除暫停，確認作業能順利離開佇列且沒有錯誤。

重點整理

• 這個步驟很複雜。
• 建議盡量使用 Seagull 驅動程式。

將資料傳送到印表機

這是最後一個步驟，涉及 BarTender 與印表機的連線，以及印表機本身。如果前面所有步驟都沒問題，問題很可能出在這裡。

這個流程的第一步是發送作業。這可能是透過傳輸線連接 USB 印表機，或是透過網路傳送。檢查連接線很重要，確保印表機程式碼能順利傳送到印表機。

• 如果是 USB 印表機，請確保 USB 線正確連接到印表機與電腦。
• 如果是網路印表機，請檢查是否有網路延遲或流量問題。您可能需要請教 IT 人員，或使用像 WireShark 這類第三方工具協助排查這個步驟。

確認連線正常後，接下來要檢查實體印表機。

• 每次發送列印時，印表機是否都出現錯誤？
• 是否列印出亂碼？
• 耗材、墨水或碳帶是否有實體問題？

第一種情況建議聯絡印表機原廠處理，第二種情況可以嘗試清除印表機快取。請參考印表機使用手冊，了解如何執行這個步驟。手冊中也可能有其他排查實體問題的方法。

重點整理

• 確保電腦能連接到印表機。
• 第三方工具有助於診斷問題。

其他資源

本指南僅為概略的故障排除說明，未涵蓋所有可能遇到的列印情境。如果這些建議無法解決您的問題，請聯絡客服，我們會協助您處理。