So erstellen Sie eine CSV-Integration mit benannten Datenquellen
Überblick
CSV-Integrationen gehören zu den einfachsten und nützlichsten Integrationen. Im Gegensatz zu anderen Integrationsarten nimmt diese Integration eine CSV-Datenbank, die sich in einer Trigger-Datei befindet, und zerlegt sie in Variablen, die an eine Etikettendatei übergeben werden können. Verwenden Sie unbedingt das Versions-Dropdown oben, da die Benutzeroberfläche je nach BarTender-Version unterschiedlich sein kann.
Wenn Sie nach ähnlichen Integrationen suchen, finden Sie hier weitere hilfreiche Anleitungen:
- Dokument mit Druckbefehl-Skript drucken (Video - 9:40) – eine Integration, bei der Drucker- und Etiketteninformationen im Skriptkopf festgelegt werden und eine CSV-Datenbank enthalten ist
- So erstellen Sie eine einfache CSV-Integration – eine CSV-Integration, die eine Datenbanküberschreibung verwendet, um Daten an ein Etikett zu senden.
- Erstellen einer Datenbankintegration (Video - 33:42) – eine Integration, die sehr ähnlich wie diese Art der CSV-Integration funktioniert und Benannte Datenquellen auf dem Etikett verwendet.
Gilt für
BarTender 2022 und neuer
Informationen
Etikett einrichten
Diese Art von Etikett verwendet keine Datenbank, sondern nutzt Benannte Datenquellen, um alle Daten zu verwalten. Im Folgenden werden die Grundlagen zur Einrichtung dieses Etiketts erklärt. Weitere Informationen finden Sie unter Benannte Datenquellen in der Hilfedatei.
- Erstellen Sie ein neues Etikett.
- Fügen Sie ein Textobjekt im Etikettendesignbereich hinzu.
- Klicken Sie mit der rechten Maustaste auf das Etikett und wählen Sie Eigenschaften.
- Wählen Sie die Datenquelle aus der Liste aus. Dort steht "Beispieltext".
- Klicken Sie auf das Feld neben dem Namensfeld.
- Geben Sie im Dialogfeld einen eindeutigen Namen ein und klicken Sie auf OK. In diesem Beispiel verwenden Sie ProductName.
- Stellen Sie sicher, dass der Typ auf "Eingebettete Daten" gesetzt ist.
- Wenn Sie weitere Textobjekte erstellen, sieht das Dialogfeld für Benannte Datenquellen etwas anders aus. Wenn Sie auf das Feld neben dem Namensfeld klicken, wählen Sie die erste Option, um einen neuen Namen zu erstellen. Zum Beispiel: ProductType.
- Sobald Sie so viele Benannte Datenquellen erstellt haben, wie Sie benötigen, speichern Sie das Etikett.
Integration erstellen
Für Ihre Integration benötigen Sie eine Trigger-Datei. Die Feldnamen in der CSV müssen nicht mit den Namen Ihrer Benannten Datenquellen übereinstimmen, da Sie die Felder in der Integration den Benannten Datenquellen zuordnen. Diese CSV-Feldnamen werden automatisch zu Variablen in Ihrer Integration. Achten Sie darauf, dass Ihre Feldnamen keine Leerzeichen enthalten.
Dieses Beispiel enthält auch Druckerinformationen. Passen Sie den Etikettennamen und den Druckernamen an, bevor Sie in Ihrer eigenen Integration testen. Hier das Beispiel:
Name,Food,ID,btw,printer
Seagull Seed Rings,bird food,1236468,Test.btw,Zebra 105
- Öffnen Sie den Integration Builder und wählen Sie "Neue Integration erstellen".
- Wählen Sie im neuen Integrationsdialog "Datei-Integration" und klicken Sie auf OK.
- Legen Sie zunächst fest, wie die Integration Dateien erkennt, indem Sie den Überwachungsordner festlegen. Hier werden Ihre Trigger-Dateien abgelegt und von der Integration abgeholt. In meinem Beispiel habe ich einen Ordner auf dem Laufwerk C verwendet. Vermeiden Sie Orte wie "Eigene Dateien" oder den Desktop, da für diese Orte zusätzliche Berechtigungen erforderlich sind.
- Klicken Sie auf das Dropdown-Menü neben Speicherort und wählen Sie "Computer/Netzwerk"
- Geben Sie den Ordnernamen ein oder verwenden Sie die Durchsuchen-Schaltfläche, um ihn zu finden.
- Ändern Sie das Dateimuster so, dass es zu Ihrer Datei passt. Ich verwende die Standardeinstellung .dat, Sie können aber auch .txt, .csv oder einen beliebigen anderen Typ verwenden.
- Scrollen Sie bis zum Ende dieses Abschnitts. Wenn Sie ein *.txt-Dateimuster verwenden, ändern Sie die Optionen unter "Nach Erkennung" auf eine andere Dateiendung, damit die Integration nicht immer wieder dieselbe Datei aufnimmt.
- Klicken Sie im linken Menü auf das + neben Aktionen.
- Klicken Sie im Dialog auf die Kategorie "Transformieren" und wählen Sie dann "Text in Datensatz umwandeln" und klicken Sie auf OK.
- Klicken Sie auf die Schaltfläche "Datenbankverbindung einrichten" und folgen Sie den Schritten des Assistenten, um eine Verbindung zu einer CSV-formatierten Datei herzustellen, die die Datenbankfelder enthält, die Sie beim Drucken verwenden.
- Ändern Sie die "Textquelle" auf "Variable" und stellen Sie sicher, dass die Variable auf "%EventData%" gesetzt ist.
- Klicken Sie auf die Schaltfläche "Datenbankverbindung einrichten" und folgen Sie den Schritten des Assistenten, um eine Verbindung zu einer CSV-formatierten Datei herzustellen, die die Datenbankfelder enthält, die Sie beim Drucken verwenden.
- Klicken Sie erneut auf das + neben Aktion.
- Klicken Sie auf die Kategorie "Datenbank" und wählen Sie dann "Für jeden Datenbankdatensatz" und klicken Sie auf OK.
- Klicken Sie in der Aktionsliste auf die Aktion "Dokument drucken" und ziehen Sie sie unter die Aktion "Für jeden Datenbankdatensatz", bis sie eingerückt ist. Dadurch wird die Aktion "Dokument drucken" ein untergeordnetes Element dieser Aktion.
- Wählen Sie im Abschnitt Dokument das Dokument aus, das Sie im vorherigen Abschnitt erstellt haben. Wir werden später einen Variablennamen verwenden.
- Ändern Sie den Speicherort auf "Computer/Netzwerk"
- Geben Sie den Ordnernamen ein oder verwenden Sie die Durchsuchen-Schaltfläche, um ihn zu finden.
- Klicken Sie auf die Schaltfläche [Dokumenteinstellungen importieren...]
- Klicken Sie im Dialog auf OK.
- Klicken Sie auf die Registerkarte "Benannte Datenquellen" und sehen Sie sich die Informationen an, die für Sie importiert und ausgefüllt wurden.
Die Variablennamen, die Sie in das Wert-Feld eintragen möchten, sind die Feldnamen aus Ihrer CSV. Variablen werden gekennzeichnet, indem der Name mit % umschlossen wird. Einer unserer Feldnamen ist Name, also wäre die entsprechende Variable %Name%.
- Tragen Sie die Variablen in die passenden Spalten ein. Mit der Beispieldatenbank lauten die Werte wie folgt:
- Wenn Sie die Drucker- und Etiketteninformationen überschreiben möchten, können Sie hier ebenfalls Variablen verwenden.
- Klicken Sie auf die Registerkarte "Druckoptionen"
- Geben Sie im Druckerfeld %printer% ein, was dem Druckerfeld in der CSV-Trigger-Datei entspricht
- Klicken Sie auf die Registerkarte "Dokument".
- Entfernen Sie im Dokumentenfeld den Namen Ihrer btw-Datei, lassen Sie aber den Pfad bestehen. Ersetzen Sie den Dokumentnamen durch %btw%, was dem Feldnamen in der Trigger-Datei entspricht. Das Dokumentenfeld enthält dann einen Pfad und eine Variable, ähnlich wie in diesem Beispiel:
Beachten Sie, dass die Vorschau fehlschlägt, wenn der Pfad eine Variable enthält. Das ist normal.
- Speichern Sie Ihre Integration.
- Klicken Sie in der oberen Symbolleiste auf die Schaltfläche "Integration testen".
- Klicken Sie oben rechts auf die grüne Start-Schaltfläche.
- Ziehen Sie im Datei-Explorer die CSV-Trigger-Datei in den Überwachungsordner. Die Integration wird ausgelöst und ein Etikett wird gedruckt.
Integration bereitstellen
Nachdem Sie die Integration getestet haben, möchten Sie sie in die Produktion übernehmen.
- Klicken Sie auf die Registerkarte "Bereitstellen" und dann auf die Schaltfläche "Bereitstellen" in der oberen Symbolleiste. Wenn Änderungen vorgenommen wurden, werden Sie aufgefordert, Ihre Integrationsdatei vor dem Fortfahren zu speichern.
- Klicken Sie auf die Dropdown-Liste und wählen Sie "Dieser Computer", um lokal bereitzustellen. Klicken Sie auf Weiter.
- Lassen Sie "Jetzt bereitstellen" ausgewählt und klicken Sie auf Fertig stellen.
- Nach einem Moment öffnet sich die Verwaltungskonsole und die Integration wird als bereitgestellt und ausgeführt angezeigt.
Gilt für
BarTender 2019 und BarTender 2021
Informationen
Etikett einrichten
Dieser Etikettentyp verwendet keine Datenbank, sondern nutzt Benannte Datenquellen, um alle Daten zu verwalten. Im Folgenden werden die Grundlagen zur Einrichtung dieses Etiketts erklärt. Weitere Informationen finden Sie unter Benannte Datenquellen in der Hilfedatei.
- Erstellen Sie ein neues Etikett.
- Fügen Sie ein Textobjekt im Etikettendesignbereich hinzu.
- Klicken Sie mit der rechten Maustaste auf das Etikett und wählen Sie Eigenschaften.
- Wählen Sie die Datenquelle aus der Liste aus. Dort steht "Beispieltext".
- Klicken Sie auf das Kästchen neben dem Namensfeld.
- Geben Sie im Dialogfeld einen eindeutigen Namen ein und klicken Sie auf OK. In diesem Beispiel verwenden Sie ProductName.
- Stellen Sie sicher, dass der Typ auf "Eingebettete Daten" gesetzt ist.
- Wenn Sie weitere Textobjekte erstellen, sieht das Dialogfeld für die Benannte Datenquelle etwas anders aus. Wenn Sie auf das Kästchen neben dem Namensfeld klicken, wählen Sie die erste Option, um einen neuen Namen zu erstellen. Zum Beispiel ProductType.
- Sobald Sie so viele Benannte Datenquellen erstellt haben, wie Sie benötigen, speichern Sie das Etikett.
Integration erstellen
Für Ihre Integration benötigen Sie eine Trigger-Datei. Die Feldnamen in der CSV müssen nicht mit den Namen Ihrer Benannten Datenquellen übereinstimmen, da Sie die Felder hier in der Integration zuordnen. Diese CSV-Feldnamen werden automatisch zu Variablen in Ihrer Integration. Achten Sie darauf, dass Ihre Feldnamen keine Leerzeichen enthalten.
In diesem Beispiel sind auch Druckerinformationen enthalten. Passen Sie den Etikettennamen und den Druckernamen an, bevor Sie in Ihrer eigenen Integration testen. Hier das Beispiel:
Name,Food,ID,btw,printer
Seagull Seed Rings,bird food,1236468,Test.btw,Zebra 105
- Öffnen Sie den Integration Builder und wählen Sie "Neue Integration erstellen".
- Wählen Sie im neuen Integrationsdialog "Datei-Integration" und klicken Sie auf OK.
- Legen Sie zunächst fest, wie die Integration Dateien erkennt, indem Sie den Überwachungsordner festlegen. Hier werden Ihre Trigger-Dateien abgelegt und von der Integration abgeholt. In meinem Beispiel habe ich einen Ordner auf dem Laufwerk C verwendet. Geben Sie den Ordnernamen ein oder nutzen Sie die Durchsuchen-Schaltfläche. Vermeiden Sie Orte wie "Eigene Dateien" oder den Desktop, da für diese Orte zusätzliche Berechtigungen erforderlich sind.
- Ändern Sie das Dateimuster so, dass es zu Ihrer Datei passt. Ich verwende standardmäßig .dat, Sie können aber auch .txt, .csv oder einen beliebigen anderen Typ verwenden.
- Scrollen Sie bis zum Ende dieses Abschnitts. Wenn Sie ein *.txt-Dateimuster verwenden, ändern Sie die Optionen unter "Nach Erkennung" auf eine andere Dateiendung, damit die Integration nicht immer wieder dieselbe Datei aufnimmt.
- Klicken Sie im linken Menü auf das + neben Aktionen.
- Klicken Sie im Dialog auf die Kategorie "Transformieren" und wählen Sie dann "Text in Datensatz umwandeln" und klicken Sie auf OK.
- Klicken Sie auf die Schaltfläche "Datenbankverbindung einrichten" und folgen Sie den Schritten des Assistenten, um eine Verbindung zu einer CSV-Datei herzustellen, die die Datenbankfelder enthält, die Sie beim Drucken verwenden.
- Ändern Sie die "Textquelle" auf "Variable" und stellen Sie sicher, dass die Variable auf "%EventData%" gesetzt ist.
- Klicken Sie auf die Schaltfläche "Datenbankverbindung einrichten" und folgen Sie den Schritten des Assistenten, um eine Verbindung zu einer CSV-Datei herzustellen, die die Datenbankfelder enthält, die Sie beim Drucken verwenden.
- Klicken Sie erneut auf das + neben Aktion.
- Klicken Sie auf die Kategorie "Datenbank" und wählen Sie dann "Für jeden Datenbankdatensatz" und klicken Sie auf OK.
- Klicken Sie in der Aktionsliste auf die Aktion "Dokument drucken" und ziehen Sie sie unter die Aktion "Für jeden Datenbankdatensatz", bis sie eingerückt ist. Dadurch wird die Aktion "Dokument drucken" ein untergeordnetes Element dieser Aktion.
- Wählen Sie im Abschnitt Dokument das Dokument aus, das Sie im vorherigen Abschnitt erstellt haben. Wir werden später einen Variablennamen verwenden.
- Klicken Sie auf die Schaltfläche [Dokumenteinstellungen importieren...]
- Klicken Sie im Dialog auf OK.
- Klicken Sie auf die Registerkarte "Benannte Datenquellen" und sehen Sie sich die Informationen an, die für Sie importiert und ausgefüllt wurden.
Die Variablennamen, die Sie in das Wertefeld eintragen möchten, sind die Feldnamen aus Ihrer CSV. Variablen werden gekennzeichnet, indem der Name mit % umschlossen wird. Einer unserer Feldnamen ist Name, also wäre die entsprechende Variable %Name%.
- Tragen Sie die Variablen in die passenden Spalten ein. Mit der Beispieldatenbank lauten die Werte wie folgt:
- Wenn Sie die Drucker- und Etiketteninformationen überschreiben möchten, können Sie hier ebenfalls Variablen verwenden.
- Klicken Sie auf die Registerkarte "Druckoptionen"
- Geben Sie im Druckerfeld %printer% ein, was dem Druckerfeld in der CSV-Triggerdatei entspricht
- Klicken Sie auf die Registerkarte "Dokument".
- Entfernen Sie im Dokumentfeld den Namen Ihrer btw-Datei, lassen Sie aber den Pfad bestehen. Ersetzen Sie den Dokumentnamen durch %btw%, was dem Feldnamen in der Triggerdatei entspricht. Das Dokumentfeld enthält dann einen Pfad und eine Variable, ähnlich wie in diesem Beispiel:
Beachten Sie, dass die Vorschau nicht generiert werden kann, wenn der Pfad eine Variable enthält. Das ist normal.
- Speichern Sie Ihre Integration.
- Klicken Sie in der oberen Symbolleiste auf die Schaltfläche "Integration testen".
- Klicken Sie oben rechts auf die grüne Start-Schaltfläche.
- Ziehen Sie im Datei-Explorer die CSV-Triggerdatei in den Überwachungsordner. Die Integration wird ausgelöst und ein Etikett wird gedruckt.
Integration bereitstellen
Nachdem Sie die Integration getestet haben, möchten Sie sie in den Produktivbetrieb übernehmen.
- Klicken Sie auf die Registerkarte "Bereitstellen" und dann auf die Schaltfläche "Bereitstellen" in der oberen Symbolleiste. Wenn Änderungen vorgenommen wurden, werden Sie aufgefordert, Ihre Integrationsdatei vor dem Fortfahren zu speichern.
- Klicken Sie auf die Dropdown-Liste und wählen Sie "Dieser Computer", um lokal bereitzustellen. Klicken Sie auf Weiter.
- Lassen Sie "Jetzt bereitstellen" ausgewählt und klicken Sie auf Fertigstellen.
- Nach einem Moment öffnet sich die Verwaltungskonsole und die Integration wird als bereitgestellt und ausgeführt angezeigt.