概述

有時候，您可能會想要在列印標籤時，用新的資訊取代標籤中資料庫欄位的內容。這個動作稱為資料庫覆寫（Database Override）。當您呼叫 BarTender Cloud REST API 時，可能不太清楚在您的發送程式或客戶端應用程式中該如何操作。

本文提供了一個包含資料庫覆寫的列印動作範例，您可以將其發送到 BarTender Cloud REST API。

適用於

BarTender Cloud

相關資訊

文件設定

在進入範例之前，讓我們先設定與列印動作相關的文件。

1. 在 BarTender Cloud Designer 中建立一個新文件。
2. 點選畫面左上角的 資料庫設定 圖示，開啟資料庫設定精靈。

3. 點選 文字檔案，然後按 下一步。
4. 選擇 內嵌範例資料，再點選 下一步。
5. 貼上以下範例資料，然後點選 下一步。

6. 依照資料庫設定精靈的指示完成資料庫連線。

Payload 範例

以下是一個包含資料庫覆寫的 payload 範例。這個範例是 JSON 格式，您也可以使用 YAML。您可以使用右側的捲軸查看完整範例。

[
    {
        "SetVariableAction": {
            "VariableName": "EventData",
            "VariableValue": "Id,name,year\r\n1,7325856667720,KS2451-Test1,2020\r\n2,7325856667721,KS2451-Test2,2024\r\n3,1234,test3,22"
        }
    },
    {
        "PrintBTWAction": {
            "DocumentFile": "librarian://main/test.btw",
            "Name": "Print Document",
            "Printer": "PDF",
            "SaveAfterPrint": false,
            "Copies": 1,
            "ReturnPrintData": "true",
            "ReturnPrintSummary": "true",
            "PrintToFileFileName": "myOutput.PDF",
            "PrintToFileFolder": "librarian://main/pdf/",
            "PrintToFileNameVariable": "myPdfOutput",
            "MakeUniqueOutputFile": "true",
            "DatabaseOverrides": [
                {
                  "Name": "Text",
                  "Type": "VariableName",
                  "DataSourceVariableName": "EventData"
                }
            ]
        }
    }

如需更多資訊，請參考下方資源。

其他資源

BarTender Cloud 線上說明 - 資料庫覆寫 YAML 參考

BarTender Cloud REST API 概述

BarTender Cloud REST API 驗證與權杖

BarTender Cloud REST API 應用程式類型