Übersicht

BarTender 2019 führt neue Arten von Textdatenbanken ein, darunter auch XML-Datenbanken. Da Designer diese Datenbanktypen jetzt nativ lesen kann, können Sie sie auch als Trigger-Dateien verwenden, ohne dass eine XLST-Transformation erforderlich ist.

In diesem Tutorial erfahren Sie Folgendes:

• Verwendung einer XML-Datei als Datenbank
• Einrichtung einer XML-Datei-Integration
• Testen und Bereitstellen Ihrer Integration

Für das Tutorial steht Ihnen Beispieldaten zur Verfügung. Sobald Sie damit vertraut sind, können Sie die gleichen Schritte mit Ihren eigenen Daten und Etiketten durchführen, um eine XML-Integration nach Ihren Bedürfnissen zu erstellen.

Gilt für

BarTender 2019 und neuer

Informationen

Erstellen einer XML-Datenbank

Hier ist eine Beispiel-XML-Datenbank für ein fiktives Tierfutterunternehmen, Seagull Pet Snacks. Die Datenbank enthält einen einfachen Header-Bereich <HEADER> mit einem Datenkörper in <DETAILS>.

<?xml version="1.0"?>
<LABEL>
  <HEADER>
    <BRAND>Seagull Pet Snacks</BRAND>
    <PACKAGE>Bag</PACKAGE>
    <LOCATION>Seattle</LOCATION>
    <DETAILS>
        <NAME>Kitty Kibble</NAME>
        <TAGLINE>Delicious snacks for kitty</TAGLINE>
        <FLAVOR>Salmon</FLAVOR>
    </DETAILS>
  </HEADER>
</LABEL>

So erstellen Sie eine XML-Datenbank

1. Öffnen Sie einen Texteditor wie Notepad.
2. Fügen Sie den obigen Text in Ihren Editor ein.
3. Gehen Sie zu Datei > Speichern unter und ändern Sie den Dateityp auf Alle Dateien.
4. Geben Sie zum Beispiel den Namen Database.xml ein und klicken Sie auf Speichern.

Erstellen der Etikettendatei

1. Öffnen Sie BarTender Designer und erstellen Sie ein neues Dokument.
2. Nachdem Sie den Assistenten für das neue Dokument abgeschlossen haben, gehen Sie zu Datei > Datenbankverbindung einrichten.
3. Wählen Sie Neue Datenbankverbindung erstellen und klicken Sie auf Weiter.
4. Wählen Sie XML-Datei aus der Liste und klicken Sie auf Weiter.
5. Verwenden Sie die Schaltfläche Durchsuchen, um die Datei database.xml zu finden. Wählen Sie sie aus und klicken Sie auf Weiter.
6. Wählen Sie für dieses Tutorial die erste Option Schema automatisch aus XML-Datei erkennen und klicken Sie auf Weiter.
7. Im nächsten Bildschirm können Sie BarTender mitteilen, wo sich die Daten in Ihrer XML-Datei befinden.
   In unserer Datenbank oben gibt es einen Header mit dem Tag <HEADER> und einen Bereich, der jeden Datensatz oder jedes Etikett mit <DETAILS> markiert. Da wir nur die Informationen im DETAILS-Bereich als unsere Datenbank verwenden möchten, wählen Sie diesen im oberen Bereich aus, wie im Screenshot unten gezeigt:
   
   Beachten Sie, wie sich die Dateivorschau je nach ausgewähltem Tag ändert. Im unteren Bereich sehen Sie, wie Ihre Daten in Tabellenform aussehen. Wenn die Vorschau als Tags angezeigt wird, klicken Sie auf die Registerkarte Felder auf der rechten Seite, um zur Tabellenansicht zu wechseln.
8. Mit dem DETAILS-Tag im oberen Bereich ausgewählt, klicken Sie auf Weiter.
9. Im nächsten Bildschirm können Sie Felder abwählen, wenn Sie sie ignorieren möchten. In diesem Beispiel lassen wir alle 3 Felder ausgewählt. Klicken Sie auf Fertig stellen im Assistenten und dann auf OK im Dialogfeld.
10. Nachdem die Datenbank verbunden ist, klicken Sie auf die Registerkarte Datenquellen in Ihrer Toolbox, falls sie nicht bereits ausgewählt ist.
11. Ziehen Sie alle drei Felder auf Ihr Etikett.
    Tipp: Wenn der TAGLINE-Text zu breit für Ihr Etikett ist, können Sie im Eigenschaftenfenster unter dem Abschnitt Umbruch den Zeilenumbruch aktivieren.
12. Speichern Sie Ihr Etikett. Es ist jetzt einsatzbereit!

Erstellen der Integration

1. Öffnen Sie den Integration Builder.
2. Wählen Sie auf dem Startbildschirm Neue Integration erstellen.
3. Wählen Sie im Dialog Datei aus und klicken Sie auf OK.
4. Wählen Sie unter Dateierkennung den Speicherort Ihres Überwachungsordners. Hier sucht die Integration nach Dateien.
   
   Hinweis: Es wird empfohlen, einen Ordner an einem allgemein zugänglichen Ort wie dem Laufwerk C zu wählen. Ordner in "Eigene Dateien" oder auf dem Desktop erfordern möglicherweise spezielle Zugriffsrechte.
5. Ändern Sie das Dateimuster auf *.xml, da wir nach XML-Dateien suchen werden.
6. Klicken Sie auf die Aktion Dokument drucken.
7. Wechseln Sie auf die Registerkarte Dokument und verwenden Sie die Schaltfläche Durchsuchen, um das zuvor erstellte Dokument auszuwählen. Wie beim Überwachungsordner wird empfohlen, das Dokument in einem zentralen Ordner und nicht in "Eigene Dateien" zu speichern.
8. Konfigurieren Sie die Option Datenbank-Überschreibung.
   
   BarTender 2019: Wechseln Sie auf die Registerkarte Druckoptionen, aktivieren Sie unter Datenbank-Überschreibungen das Kontrollkästchen neben Datenquelle verwenden und lassen Sie die Dropdown-Option auf Integration Input Data.
   
   
   BarTender 2021: Wechseln Sie auf die Registerkarte Druckoptionen, klicken Sie unter Datenbank-Überschreibungen auf das blaue Plus, um eine neue Überschreibungsoption hinzuzufügen. Setzen Sie die Datenquelle auf Variabel und das Feld Variable auf "%EventData%".
   
   
   
9. Speichern Sie Ihre Datei.

Testen und Bereitstellen der Integration

Bevor wir die Integration bereitstellen, sollten wir sie testen und einige Beispiel-Triggerdateien erstellen. Die Triggerdateien müssen die gleiche Struktur wie die mit der Etikettendatei verknüpfte Datenbank haben. Hier sind Beispieldaten zum Testen. Diese enthalten andere Daten als die Datenbank des Etiketts, aber die Struktur ist identisch:

<?xml version="1.0"?>
<LABEL>
  <HEADER>
    <BRAND>Seagull Pet Snacks</BRAND>
    <PACKAGE>Box</PACKAGE>
    <LOCATION>Seattle</LOCATION>
    <DETAILS>
        <NAME>Dog Crunchies</NAME>
        <TAGLINE>Crunchy snacks for your best friend!</TAGLINE>
        <FLAVOR>Duck</FLAVOR>
    </DETAILS>
  </HEADER>
</LABEL>

1. Erstellen Sie eine Beispiel-Triggerdatei mit den obigen Daten. Achten Sie darauf, dass die Dateiendung .XML ist, da die Integration dies erwartet.
2. Öffnen Sie die Integration und klicken Sie auf die Registerkarte Test.
3. Klicken Sie auf die grüne Start-Schaltfläche im oberen Menüband.
4. Legen Sie die Datei in den Überwachungsordner, den Sie im vorherigen Abschnitt festgelegt haben.
5. Es erscheinen Integrationsmeldungen, die bestätigen, dass die Integration die Datei erkannt hat.
6. Nach einem erfolgreichen Druck können Sie die Integration bereitstellen.
7. Klicken Sie auf die Registerkarte Bereitstellen und dann auf die grüne Bereitstellen-Schaltfläche.
8. Falls Sie Ihre Datei noch nicht gespeichert haben, werden Sie dazu aufgefordert.
9. Klicken Sie auf das Dropdown-Menü und wählen Sie Dieser Computer aus der Liste. Klicken Sie auf Weiter.
10. Wählen Sie Jetzt bereitstellen und klicken Sie auf Fertig stellen.
11. Ihre Integration ist jetzt bereitgestellt.

Weitere Ressourcen

Dokument mit Druckbefehl-Skript drucken (Video - 9:40)

Datei-Integration mit Druckbefehl-Skript erstellen (27:58)