Gilt für: BarTender 2019 und neuer.

Überblick

Das Ziel dieses Beispiels ist es, ein Print Command Script in eine Dateiintegration einzubinden.

Diese Art der Integration kann für Unternehmen notwendig sein, die verschiedene Anwendungen und Datenbanken mit unterschiedlichen Druckanforderungen im gesamten Netzwerk haben. In solchen Fällen kann das zu druckende BarTender-Dokument je nach den im Trigger-File enthaltenen Daten variieren.

Mit wenig Programmieraufwand können diese Anwendungen so angepasst oder konfiguriert werden, dass sie eine Textdatei mit den für den Druck benötigten Daten sowie eingebetteten Befehlszeilen schreiben. Der Integration Service kann dann diese Befehlszeilen auslesen und ausführen und BarTender anweisen, wie der Artikel je nach den spezifischen Anweisungen in der Datei gedruckt werden soll.

Szenario

Ein Unternehmen muss Rechnungen drucken, die von vielen verschiedenen Nutzern im Netzwerk eingegeben werden. Jeder Nutzer hat Zugriff auf ein gemeinsames Laufwerk. Die Rechnungen sind jedoch je nach Nutzer und Produkt unterschiedlich formatiert. Die verschiedenen Abteilungen nutzen jeweils einen eigenen Drucker.

In diesem Fall kann eine Rechnungsanwendung zu jeder Rechnung eine Textdatei erstellen, die sowohl Daten als auch ein Print Command Script enthält. Das Script weist BarTender an:

1. Das angegebene BarTender-Dokument zu öffnen.
2. Die Trigger-Datei als Datenquelle zu verwenden.
3. An einen bestimmten Drucker zu drucken.
4. Die Trigger-Datei zu löschen.

Umsetzung

Die folgenden Schritte beschreiben, wie Sie die Integration für das oben beschriebene Szenario einrichten, bereitstellen und überprüfen.

Daten-Dateien einrichten

1. Erstellen Sie den Netzwerkordner, in dem die Trigger-Dateien gespeichert werden. Dies ist der Ordner, den der Integration Service überwachen wird. In diesem Beispiel heißt er \\InvoiceServer\NewInvoice.
2. Erstellen Sie für jeden Rechnungstyp eine Beispieldatei, in der die Daten genauso strukturiert und getrennt sind wie in den echten Daten-Dateien. In diesem Beispiel gibt es zwei Abteilungen, die Rechnungen drucken.

• Für die erste Abteilung erstellen Sie eine Textdatei mit dem Namen invoice1.txt, die zwei Zeilen mit kommagetrennten Daten enthält (siehe unten).
  

  BusinessName,ContactName,Position,Address1,City,State,Zip,Country,Phone1,Phone2
  Around the Town,Jerome Davis,Buyer,1220 Governor Sq.,Haddonfield,GA,31002,USA,(706) 555-7788,(706) 555-6750

• Für die zweite Abteilung erstellen Sie eine Textdatei mit dem Namen invoice2.txt, die zwei Zeilen mit Anführungszeichen und Komma getrennten Daten enthält (siehe unten).
  

  "BusinessName","ContactName","Position","Address1","City","State","Zip","Country","Phone1","Phone2"
  "Far Fetched Imports","Jerry Bom","manager","3320 Happy St.","Incident","Washington","98887","USA","(206) 555-7788","(206) 555-6750"

• Speichern Sie die Textdateien im in Schritt 1 erstellten Verzeichnis \\InvoiceServer\NewInvoice.

BarTender-Dokumente erstellen

1. Erstellen Sie entsprechend dem Abschnitt "BarTender-Dokument erstellen" aus Dokument mit einer Datendatei drucken ein BarTender-Dokument für die erste Abteilung und verwenden Sie invoice1.txt als Datenbank.
2. Speichern Sie das Dokument als HardwareInvoice.btw.
3. Erstellen Sie nach denselben Schritten ein zweites BarTender-Dokument für die zweite Abteilung und verwenden Sie invoice2.txt als Datenbank. Achten Sie darauf, als Trennzeichen "Anführungszeichen und Komma" anzugeben.
4. Speichern Sie das Dokument als SoftwareInvoice.btw.
5. Verschieben Sie beide Beispieldateien aus dem Ordner, den der Integration Service überwacht, in einen anderen Ordner.
6. Schließen Sie BarTender.

Print Command Script zu den Trigger-Dateien hinzufügen

1. Öffnen Sie invoice1.txt und fügen Sie die folgenden zwei Zeilen am Anfang der Datei ein. (Die einzigen harten Zeilenumbrüche sind direkt vor und nach %END%.)
   

   %BTW% /AF=c:\command\HardwareInvoice.btw /D="%Trigger File Name%" /PRN="EasyCoder F4 (203 dpi)" /R=3 /P /DD 
   %END%

   
   Die gesamte Datei sieht nun wie folgt aus:
   

   %BTW% /AF=c:\command\HardwareInvoice.btw /D="%Trigger File Name%" /PRN="EasyCoder F4 (203 dpi)" /R=3 /P /DD 
   %END%
   BusinessName,ContactName,Position,Address1,City,State,Zip,Country,Phone1,Phone2
   Around the Town,Jerome Davis,Buyer,1220 Governor Sq.,Haddonfield,GA,31002,USA,(706) 555-7788,(706) 555-6750

2. Speichern Sie das Dokument als invoice1.dat.
3. Öffnen Sie invoice2.txt und fügen Sie die folgenden zwei Zeilen am Anfang der Datei ein. (Die einzigen harten Zeilenumbrüche sind direkt vor und nach %END%.)
   

   %BTW% /AF=c:\command\SoftwareInvoice.btw /D="%Trigger File Name%" /PRN="Datamax 4400" /R=3 /P /DD 
   %END%

4. Die gesamte Datei sieht nun wie folgt aus:
   

   %BTW% /AF=c:\command\SoftwareInvoice.btw /D="%Trigger File Name%" /PRN="Datamax 4400" /R=3 /P /DD 
   %END%
   "BusinessName","ContactName","Position","Address1","City","State","Zip","Country","Phone1","Phone2"
   "Far Fetched Imports","Jerry Bom","manager","3320 Happy St.","Incident","Washington","98887","USA","(206) 555-7788","(206) 555-6750"

5. Speichern Sie das Dokument als invoice2.dat.

Integrationsdatei erstellen und bereitstellen

Erstellen

1. Öffnen Sie den BarTender Integration Builder.
2. Klicken Sie auf Neue Integration erstellen, um den Dialog "Neue Integration" zu öffnen.
3. Klicken Sie auf Datei und dann auf OK.
4. Wählen Sie im Bereich Dateiintegration Integration aus.
5. Geben Sie im Eigenschaftenbereich den Namen Ihrer Integration als Jede Bestellung ein.
6. Wählen Sie im Menü Integration starten Automatisch aus.
7. Geben Sie unter Benutzerkonto die Benutzeranmeldedaten an. Weitere Informationen finden Sie unter Dokument mit einer leeren Datei drucken.
8. Wählen Sie im Bereich Dateiintegration Dateierkennung aus.
9. Wählen Sie im Eigenschaftenbereich unter Erkennungsoptionen in der Liste Speicherort Computer/Netzwerk aus.
10. Geben Sie für die Option "Zu scannender Ordner" den Pfad ein oder navigieren Sie zu dem Ordner, den der Integration Service überwachen soll. In diesem Fall geben Sie den Ordner \\InvoiceServer\NewInvoice an, den Sie im Abschnitt Daten-Dateien einrichten erstellt haben.
11. Geben Sie im Feld Dateimuster *.dat ein. 
12. Scrollen Sie nach unten zum Abschnitt "Aktionen nach Erkennung". Wählen Sie im Aktionsmenü Datei umbenennen aus.

13. Geben Sie im Feld "Neue Erweiterung" .txt ein. Diese Erweiterung darf nicht mit der im Dateimuster angegebenen übereinstimmen.

14. Klicken Sie im Bereich Dateiintegration unter Aktionen auf  rechts neben "Dokument drucken", um die Standardaktion zu entfernen.
15. Wählen Sie Aktionen und klicken Sie auf , um den Dialog "Neue Aktion" zu öffnen.
16. Wählen Sie im linken Navigationsbereich unter den Aktionstypen Drucken und dann Print Command Script aus.
17. Klicken Sie auf OK, um den Dialog Neue Aktion zu schließen.
18. Klicken Sie oben links im Integration Builder auf , um die Integrationsdatei als VariantInvoices.btin zu speichern.

Bereitstellen

1. Klicken Sie auf  Integration bereitstellen, um den Dialog "Neue Bereitstellung" zu öffnen.
2. Geben Sie einen Namen und eine Beschreibung für die Bereitstellung ein.
3. Stellen Sie sicher, dass bei der Einstellung "Integrationsdatei" VariantInvoices.btin angegeben ist. Andernfalls klicken Sie auf Durchsuchen und wählen Sie VariantInvoices.btin aus.
4. Fügen Sie unter Zielserver die Server hinzu, auf denen Sie die Integrationsdatei bereitstellen möchten.
5. Legen Sie die gewünschten Einstellungen für die Fehlerbehandlung fest.
6. Klicken Sie auf OK, um den Dialog zu schließen und die Integrationsdatei bereitzustellen.
7. Die Administration Console öffnet sich im Knoten Integrationen und zeigt Ihre Integration an.

Print Command Script verstehen und anpassen

%BTW% ist der Print Command Script-Befehl, der dem Integration Service mitteilt, BarTender zu starten und die folgende Zeichenkette als BarTender-Befehlszeile zu verwenden.

%END% teilt dem Integration Service mit, dass die Befehlszeile beendet ist und die folgenden Zeilen Daten sind.

Sie müssen das Print Command Script für beide Trigger-Dateien wie folgt anpassen: 

• Ersetzen Sie den Pfad und den Druckernamen nach dem /PRN-Befehl durch den Pfad und Druckernamen Ihrer eigenen Drucker.
• Ersetzen Sie c:\command\ durch den Pfad, in dem Sie Ihre BarTender-Dokumente gespeichert haben.

Beachten Sie außerdem Folgendes:

• Wenn einer der Pfade, Dateinamen oder Druckernamen in Ihrem Print Command Script Leerzeichen enthält, müssen Sie den gesamten Pfad in Anführungszeichen setzen.
• Die Administration Console erkennt %Trigger File Name% als Variable und ersetzt sie automatisch durch den aktuellen Namen der Trigger-Datei, bevor der Parameter an BarTender übergeben wird. Ersetzen Sie %Trigger File Name% nicht durch den Namen der Datenbankdatei.
• Der Befehl /R=3 weist BarTender an, die dritte Zeile in der Trigger-Datei als Datensatz zu behandeln.
• Wenn Sie mit Print Command Script ein Etikett drucken, das einen Inner Join auf zwei Datenbanken hat, wobei eine Datenbank eine Textdatei ist und die andere eine beliebige andere Datenbankart, und ein Datenbank-Override auf der Textdatenbank mit dem /D-Befehl durchgeführt wird, sollte der /R-Befehl auf /R=1 statt /R=3 gesetzt werden.
• Der Befehl /P weist BarTender an, den Artikel zu drucken.
• Der Befehl /DD weist BarTender an, die Trigger-Datei nach dem Auslesen zu löschen.

Szenario ausführen und Integrationsverarbeitung anzeigen

1. Klicken Sie in der Administration Console auf den Integrationsnamen Jede Bestellung, um eine Detailansicht der Integration zu öffnen.
2. Während Sie das Beispiel-Szenario im nächsten Schritt ausführen, können Sie die Verarbeitungsschritte der Integration im Bereich Ausgabe dieser Ansicht beobachten.
2. Kopieren Sie mit dem Windows Explorer die Textdatei invoice1.dat in den Ordner \\InvoiceServer\NewInvoice.
3. Die Integration startet fast sofort, erkennt die Datei invoice1.dat und benennt invoice1.dat in invoice1.txt um.
4. BarTender startet im Hintergrund (Sie sehen es nicht geöffnet) und übergibt die .txt-Datei an die Befehlszeile in der Trigger-Datei, wobei invoice1.txt für die Variable %Trigger File Name% eingesetzt wird.
5. BarTender öffnet dann HardwareInvoice.btw, liest die Daten aus invoice1.txt, druckt den Artikel und löscht invoice1.txt.
3. Kopieren Sie mit dem Windows Explorer die Textdatei invoice2.dat in den Ordner \\InvoiceServer\NewInvoice.
4. Die Integration startet fast sofort, erkennt die Datei invoice2.dat und benennt invoice2.dat in invoice2.txt um.
5. BarTender öffnet und übergibt die .txt-Datei an die Befehlszeile in der Trigger-Datei, wobei invoice2.txt für die Variable %Trigger File Name% eingesetzt wird.
6. BarTender öffnet dann SoftwareInvoice.btw, liest die Daten aus invoice2.txt, druckt den Artikel und löscht invoice2.txt.