Überblick

Es gibt Situationen, in denen Sie die Informationen in einem Datenbankfeld auf Ihrem Etikett für einen Druckauftrag durch neue Informationen ersetzen möchten. Diese Aktion wird als Datenbank-Override bezeichnet. Wenn Sie einen Aufruf an die BarTender Cloud REST API machen, ist möglicherweise nicht klar, wie dies in Ihrem sendenden Programm oder Ihrer Client-Anwendung aussehen könnte.

Dieser Artikel zeigt ein Beispiel für eine Druckaktion (einschließlich eines Datenbank-Overrides), die Sie an die BarTender Cloud REST API senden könnten.

Gilt für

BarTender Cloud

Informationen

Dokument einrichten

Bevor wir zum Beispiel kommen, richten wir das Dokument ein, das zur Druckaktion gehört.

1. Erstellen Sie ein neues Dokument im BarTender Cloud Designer.
2. Klicken Sie oben links auf das Symbol Datenbankeinrichtung, um den Datenbankeinrichtungs-Assistenten zu öffnen.

3. Klicken Sie auf Textdatei und dann auf Weiter.
4. Wählen Sie Eingebettete Beispieldaten und klicken Sie dann auf Weiter.
5. Fügen Sie die folgenden Beispieldaten ein und klicken Sie dann auf Weiter.

6. Folgen Sie dem Rest des Datenbankeinrichtungs-Assistenten, um Ihre Datenbankverbindung abzuschließen.

Beispiel für ein Payload

Hier sehen Sie ein Beispiel für ein Payload, das einen Datenbank-Override enthält. Dieses Beispiel ist in JSON, Sie können aber auch YAML verwenden. Sie können das vollständige Beispiel mit der Bildlaufleiste rechts ansehen.

[
    {
        "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"
                }
            ]
        }
    }

Weitere Informationen finden Sie in den folgenden Ressourcen.

Weitere Ressourcen

BarTender Cloud Online-Hilfe – YAML-Referenz für Datenbank-Overrides

BarTender Cloud REST API Übersicht

BarTender Cloud REST API Authentifizierung und Tokens

BarTender Cloud REST API Anwendungstypen