So erstellen Sie eine grundlegende CSV-Integration mit Datenbank-Überschreibungen
Überblick
CSV-Integrationen gehören zu den einfachsten und nützlichsten Integrationen. Sie benötigen nur wenig Einrichtung, um loszulegen. Bei dieser Art von Integration wird die Information aus einer Trigger-Datei verwendet, um die mit einem Etikett verknüpfte Datenbank zu überschreiben. Achten Sie darauf, das Versions-Dropdown oben zu verwenden, 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 Print Command Script drucken (Video - 9:40) – eine Integration, bei der Drucker- und Etiketteninformationen im Skript-Header festgelegt werden und eine CSV-Datenbank enthalten ist.
- So erstellen Sie eine CSV-Integration mit benannten Datenquellen – eine CSV-Integration, die eine CSV-Datei aufteilt und die Daten auf benannte Datenquellen auf dem Etikett verteilt. Kann ebenfalls verwendet werden, um Drucker- und Etiketteninformationen festzulegen.
Gilt für
BarTender 2022 und neuer
Informationen
Etikett einrichten
Beginnen Sie zunächst damit, die Etikettendatei einzurichten und mit einer Datenbank zu verbinden. Sie können Ihre eigene CSV verwenden oder diese einfache Beispieldatenbank in einer Text- oder CSV-Datei speichern:
Name,Food,ID
Seagull Kitty Snax,cat treats,12334668
BarTender Dog Bones,dog food,25346489
- Erstellen Sie ein neues Etikett und verbinden Sie es mit der Textdatenbank. Wenn Sie mit dem Vorgang nicht vertraut sind, sehen Sie sich Erste Schritte mit Datenbankverbindungen (Video - 5:20) an.
- Klicken Sie im Werkzeugkasten (standardmäßig auf der linken Seite der Benutzeroberfläche) auf den Tab „Datenquellen“.
- Ziehen Sie ein Datenbankfeld aus dem Werkzeugkasten auf den Etiketten-Designbereich. Wiederholen Sie dies für jedes Datenbankfeld, das Sie auf dem Etikett verwenden möchten.
- Speichern Sie das Etikett.
Integration erstellen
Für Ihre Integration benötigen Sie eine Trigger-Datei. Die Datei muss dem Datenbankformat entsprechen, das Sie mit dem Etikett verwendet haben. Eine CSV-Trigger-Datei muss also zu einer CSV-Datenbank passen und eine tabulatorgetrennte Datenbank benötigt eine entsprechende Trigger-Datei. Wenn Sie das obige Beispiel verwendet haben, können Sie diese Beispiel-Trigger-Datei nutzen:
Name,Food,ID
Seagull Seed Rings,bird food,1236468
- Öffnen Sie den Integration Builder und wählen Sie „Neue Integration erstellen“.
- Wählen Sie im neuen Integrationsdialog „Datei-Integration“ aus und klicken Sie auf OK.
- Legen Sie zunächst fest, wie die Integration Dateien erkennt, indem Sie den Scan-Ordner festlegen. Hier werden Ihre Trigger-Dateien abgelegt und von der Integration aufgenommen. In meinem Beispiel habe ich einen Ordner auf dem Laufwerk C verwendet. Vermeiden Sie Orte wie „Eigene Dokumente“ oder den Desktop, da für diese Orte zusätzliche Berechtigungen erforderlich sind.
- Klicken Sie auf das Dropdown-Menü „Speicherort“ und wählen Sie „Computer/Netzwerk“.
- Verwenden Sie die Schaltfläche „Durchsuchen“, um Ihren Ordner zu finden, oder geben Sie den Ordnernamen ein.
- Ändern Sie das Dateimuster so, dass es zu Ihrer Datei passt. Ich verwende standardmäßig .dat, aber Sie können 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 die Aktion „Dokument drucken“.
- Wählen Sie im Abschnitt „Dokument“ das Dokument aus, das beim Auslösen der Integration gedruckt werden soll.
- Klicken Sie auf den Tab „Druckoptionen“. Klicken Sie im Bereich „Datenbanküberschreibungen“ auf die Schaltfläche „Datenbanküberschreibung hinzufügen“. Ändern Sie die Datenquelle auf „Variabel“. Wählen Sie im Dropdown-Menü „Variable“ den Eintrag „EventData“ aus.
-
Die Option (Die Standarddatenbank) wird standardmäßig ausgewählt, wenn Sie die Dokumenteinstellungen nicht importiert haben. Sie gibt an, dass die erste Datenbankverbindung auf Dokumentebene im Dokument überschrieben wird. Sie bezieht sich nicht auf Tabellenobjekte oder Datenbankverbindungen von Dateneingabefeldern. Wenn Sie stattdessen eine Tabellenobjekt- oder Dateneingabefeld-Datenbankverbindung überschreiben möchten oder den Namen der Verbindung kennen, können Sie einen bestehenden Namen in der Liste Datenbank zum Überschreiben auswählen oder auf
Hinzufügen klicken und den Namen im Textfeld Datenbank zum Überschreiben eingeben, um eine neue Verbindung hinzuzufügen. - Speichern Sie Ihre Integration.
- Klicken Sie auf die Schaltfläche „Integration testen“ in der oberen Symbolleiste.
- Klicken Sie oben rechts auf die grüne Start-Schaltfläche.
- Ziehen Sie im Datei-Explorer die CSV-Trigger-Datei in den Scan-Ordner. 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 den Tab „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.
Gilt für
BarTender 2021
Informationen
Etikett einrichten
Beginnen Sie zunächst damit, die Etikettendatei einzurichten und mit einer Datenbank zu verbinden. Sie können Ihre eigene CSV verwenden oder diese einfache Beispieldatenbank in einer Text- oder CSV-Datei speichern:
Name,Food,ID
Seagull Kitty Snax,cat treats,12334668
BarTender Dog Bones,dog food,25346489
- Erstellen Sie ein neues Etikett und verbinden Sie es mit der Textdatenbank. Wenn Sie mit dem Vorgang nicht vertraut sind, sehen Sie sich Erste Schritte mit Datenbankverbindungen (Video - 5:20) an.
- Klicken Sie im Werkzeugkasten (standardmäßig auf der linken Seite der Benutzeroberfläche) auf den Tab „Datenquellen“.
- Ziehen Sie ein Datenbankfeld aus dem Werkzeugkasten auf den Etiketten-Designbereich. Wiederholen Sie dies für jedes Datenbankfeld, das Sie auf dem Etikett verwenden möchten.
- Speichern Sie das Etikett.
Integration erstellen
Für Ihre Integration benötigen Sie eine Trigger-Datei. Die Datei muss dem Datenbankformat entsprechen, das Sie mit dem Etikett verwendet haben. Eine CSV-Trigger-Datei muss also zu einer CSV-Datenbank passen und eine tabulatorgetrennte Datenbank benötigt eine entsprechende Trigger-Datei. Wenn Sie das obige Beispiel verwendet haben, können Sie diese Beispiel-Trigger-Datei nutzen:
Name,Food,ID
Seagull Seed Rings,bird food,1236468
- Öffnen Sie den Integration Builder und wählen Sie „Neue Integration erstellen“.
- Wählen Sie im neuen Integrationsdialog „Datei-Integration“ aus und klicken Sie auf OK.
- Legen Sie zunächst fest, wie die Integration Dateien erkennt, indem Sie den Scan-Ordner festlegen. Hier werden Ihre Trigger-Dateien abgelegt und von der Integration aufgenommen. In meinem Beispiel habe ich einen Ordner auf dem Laufwerk C verwendet. Geben Sie den Ordnernamen ein oder verwenden Sie die Schaltfläche „Durchsuchen“, um ihn zu finden. Vermeiden Sie Orte wie „Eigene Dokumente“ 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, aber Sie können 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 die Aktion „Dokument drucken“.
- Wählen Sie im Abschnitt „Dokument“ das Dokument aus, das beim Auslösen der Integration gedruckt werden soll.
- Klicken Sie auf den Tab „Druckoptionen“. Klicken Sie im Bereich „Datenbanküberschreibungen“ auf die Schaltfläche „Datenbanküberschreibung hinzufügen“. Ändern Sie die Datenquelle auf „Variabel“. Wählen Sie im Dropdown-Menü „Variable“ den Eintrag „EventData“ aus.
-
Die Option (Die Standarddatenbank) wird standardmäßig ausgewählt, wenn Sie die Dokumenteinstellungen nicht importiert haben. Sie gibt an, dass die erste Datenbankverbindung auf Dokumentebene im Dokument überschrieben wird. Sie bezieht sich nicht auf Tabellenobjekte oder Datenbankverbindungen von Dateneingabefeldern. Wenn Sie stattdessen eine Tabellenobjekt- oder Dateneingabefeld-Datenbankverbindung überschreiben möchten oder den Namen der Verbindung kennen, können Sie einen bestehenden Namen in der Liste Datenbank zum Überschreiben auswählen oder auf
Hinzufügen klicken und den Namen im Textfeld Datenbank zum Überschreiben eingeben, um eine neue Verbindung hinzuzufügen. - Speichern Sie Ihre Integration.
- Klicken Sie auf die Schaltfläche „Integration testen“ in der oberen Symbolleiste.
- Klicken Sie oben rechts auf die grüne Start-Schaltfläche.
- Ziehen Sie im Datei-Explorer die CSV-Trigger-Datei in den Scan-Ordner. 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 den Tab „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.
Gilt für
BarTender 2019
Informationen
Etikett einrichten
Beginnen Sie zunächst damit, die Etikettendatei einzurichten und mit einer Datenbank zu verbinden. Sie können Ihre eigene CSV verwenden oder diese einfache Beispieldatenbank in einer Text- oder CSV-Datei speichern:
Name,Food,ID
Seagull Kitty Snax,cat treats,12334668
BarTender Dog Bones,dog food,25346489
- Erstellen Sie ein neues Etikett und verbinden Sie es mit der Textdatenbank. Wenn Sie mit dem Vorgang nicht vertraut sind, sehen Sie sich Erste Schritte mit Datenbankverbindungen (Video - 5:20) an.
- Klicken Sie im Werkzeugkasten (standardmäßig auf der linken Seite der Benutzeroberfläche) auf den Tab „Datenquellen“.
- Ziehen Sie ein Datenbankfeld aus dem Werkzeugkasten auf den Etiketten-Designbereich. Wiederholen Sie dies für jedes Datenbankfeld, das Sie auf dem Etikett verwenden möchten.
- Speichern Sie das Etikett.
Integration erstellen
Für Ihre Integration benötigen Sie eine Trigger-Datei. Die Datei muss dem Datenbankformat entsprechen, das Sie mit dem Etikett verwendet haben. Eine CSV-Trigger-Datei muss also zu einer CSV-Datenbank passen und eine tabulatorgetrennte Datenbank benötigt eine entsprechende Trigger-Datei. Wenn Sie das obige Beispiel verwendet haben, können Sie diese Beispiel-Trigger-Datei nutzen:
Name,Food,ID
Seagull Seed Rings,bird food,1236468
- Öffnen Sie den Integration Builder und wählen Sie „Neue Integration erstellen“.
- Wählen Sie im neuen Integrationsdialog „Datei-Integration“ aus und klicken Sie auf OK.
- Legen Sie zunächst fest, wie die Integration Dateien erkennt, indem Sie den Scan-Ordner festlegen. Hier werden Ihre Trigger-Dateien abgelegt und von der Integration aufgenommen. In meinem Beispiel habe ich einen Ordner auf dem Laufwerk C verwendet. Geben Sie den Ordnernamen ein oder verwenden Sie die Schaltfläche „Durchsuchen“, um ihn zu finden. Vermeiden Sie Orte wie „Eigene Dokumente“ 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, aber Sie können 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 die Aktion „Dokument drucken“.
- Wählen Sie im Abschnitt „Dokument“ das Dokument aus, das beim Auslösen der Integration gedruckt werden soll.
- Klicken Sie auf den Tab „Druckoptionen“. Aktivieren Sie im Bereich „Datenbanküberschreibungen“ das Kontrollkästchen und belassen Sie die Standardoption „Integrations-Eingabedaten“.
- Speichern Sie Ihre Integration.
- Klicken Sie auf die Schaltfläche „Integration testen“ in der oberen Symbolleiste.
- Klicken Sie oben rechts auf die grüne Start-Schaltfläche.
- Ziehen Sie im Datei-Explorer die CSV-Trigger-Datei in den Scan-Ordner. 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 den Tab „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.
Weitere Ressourcen