Übersicht

Wenn Sie den Etikettendruck mit der BarTender REST API automatisieren, können Sie eine Datenbankverbindung für Ihr Etikett mit eigenen Daten aus Textdateien überschreiben, ohne Ihre BTW-Datei anpassen zu müssen.

Mit der Funktion TransformTextToRecordSetAction während Ihres API-Aufrufs werden die Daten aus Ihrer Textdatei in Datensätze umgewandelt, die dann beim Drucken Ihr Etikett befüllen.

In diesem Artikel zeigen wir Ihnen, wie Sie diese Funktion mit YAML aufrufen.

Eine allgemeine Übersicht darüber, wie die REST API funktioniert, finden Sie in diesem Artikel. 

Gilt für

BarTender 2022 und neuer

Automation Edition und höher 

Informationen

Erstellen Sie Ihr BarTender-Dokument

1. Erstellen Sie eine Datenbank-Textdatei mit folgendem Format: 

   Feld 1, Feld 2, Feld 3
   Wert 1, Wert 2, Wert 3
   Wert 4, Wert 5, Wert 6

2. Speichern Sie die Datei als dbfile.txt.
3. Öffnen Sie BarTender Designer und erstellen Sie ein neues Dokument.
4. Fügen Sie eine Textdatenbankverbindung für dbfile.txt hinzu. (Weitere Informationen finden Sie in diesem Artikel)
5. Stellen Sie sicher, dass Ihre Datenbankverbindung den Namen dbfile trägt:

1. Fügen Sie 3 Textobjekte zum Etikett hinzu und verbinden Sie diese mit den Datenbankfeldern.  
2. Speichern Sie die Datei unter C:\Docs\APITest.btw.

Richten Sie Ihre Umgebung ein

1. Exportieren Sie Ihre Datenbankverbindungseinstellungen: 

1. Speichern Sie die Datei unter C:\Docs\dbfolder\ConnectionSetup.xml.
2. Erstellen Sie eine Datendatei mit folgendem Inhalt:

   Feld 1, Feld 2, Feld 3
   Wert 7, Wert 8, Wert 9
   Wert 10, Wert 11, Wert 12

3. Speichern Sie diese unter C:\Docs\dbfolder\datafile.txt.
4. Erstellen Sie einen Ordner namens Output unter C:\Docs\.

Führen Sie Ihren API-Aufruf aus

1. Öffnen Sie folgenden Link in Ihrem Browser:
   

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

2. Klicken Sie oben auf der Seite auf die Schaltfläche Try it out: 

1. Stellen Sie sicher, dass das Feld für die Datei leer ist.
2. Wählen Sie für den Request Body text/vnd.yaml aus.
3. Fügen Sie in Ihrem Request Body die folgenden zwei Aktionen hinzu: 
   1. TransformTextToRecordSetAction mit folgenden Parametern: 
      1. ConnctionSetup: die XML-Datei, die Sie aus Ihrer BTW-Verbindung exportiert haben. 
      2. Text: die Textdatei, die die einzufügenden Daten für Ihre Etiketten enthält. 
   2. PrintBTWAction mit folgenden Parametern:
      1. DocumentFile: der Pfad zu Ihrer zu druckenden BTW-Datei.
      2. Printer: der zu verwendende Drucker.
      3. PrintToFileFolder & PrintToFileFileName: Speicherort und Dateiname, die vom PDF-Drucker verwendet werden.
      4. DatabaseOverrides: die Einstellungen zum Überschreiben der Datenbank. In diesem Fall wird die Datenbankverbindung dbfile aus der Variable datum überschrieben.  

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 

Sie können auch diese einfachere Alternative der oben gezeigten Print-Aktion ausprobieren:

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

Wenn der Aufruf erfolgreich war, sehen Sie folgende Meldung: 

Weitere Ressourcen

Referenz zur TransformTextToRecordSetAction-Klasse

Referenz zur PrintBTWAction-Klasse