Benutzerhandbuch

Umgang mit CSV-Dateien

Aktualisiert am

Erfahren Sie in diesem Artikel,

  • wie eine CSV-Datei aufgebaut ist,
  • wie Sie in der Applikation CSV-Dateien hochladen können und
  • wie Sie die CSV-Dateien aktualisieren, löschen, herunterladen oder inspizieren können.

1. Einführung

Eine CSV-Datei dient als Steuerdatei innerhalb der Applikation $PRODUCT_NAME_WORKFLOW. Sie liefert die Werte für die variablen Elemente eines VDP-Auftrags, wobei jede Zeile einem Datensatz entspricht. Die Verwendung einer CSV-Datei in der Applikation ist optional – ohne CSV-Datei wird der VDP-Auftrag über eine fortlaufende Nummerierung gesteuert.

Steuerdateien, welche als Quelle zur Befüllung des Inhalts variabler Elemente dienen, werden in der Praxis im Vorfeld erstellt, um dann in der Applikation bzw. im VDP-Editor zum Motiv als CSV-Datei hochgeladen zu werden. Ob die Daten der CSV-Datei durch einen Datenbankexport oder manuell in Microsoft Excel erstellt werden, ist für die Verarbeitung im VDP-Editor nicht von Bedeutung. Von Bedeutung ist jedoch, dass im VDP-Editor keine Funktion zur Verfügung steht, um logische Wenn-Dann-Abfragen auf Basis der CSV-Datei zu formulieren. Somit müssen alle Inhalte korrekt im Vorfeld in der Steuerdatei erfasst und als CSV-Datei abgespeichert werden.

In diesem Artikel wird Ihnen eine Erklärung über den Umgang mit CSV-Dateien in der Applikation $PRODUCT_NAME_WORKFLOW bereitgestellt. CSV-Dateien können in der Applikation im Bereich des VDP-Editors verwendet werden.

2. Aufbau einer CSV-Datei

Die Anforderungen an die CSV-Datei sind sehr einfach gehalten. Berücksichtigen Sie bei der Erstellung der CSV-Datei folgende Hinweise:

  • Die Speicherung einer CSV-Datei sollte aus der erzeugenden Applikation heraus, als klassische CSV-Datei, erfolgen.
  • Alle Glyphen bis auf Steuerzeichen sind in der CSV-Datei zulässig.
  • Kopfzeile in CSV-Datei: Eine Kopfzeile mit einer Beschreibung zu den Werten sollte zur besseren Übersicht eingefügt werden. Verpflichtend ist dies jedoch nicht.
  • Dateinamen der Bilder müssen in der CSV-Datei immer mit Dateierweiterung .jpg, .pdf, .png etc. geführt werden. Der Pfad zum Verzeichnis, worin die Bilder gespeichert sind, wird als globale Pfadangabe im Reiter Transformieren & Allgemeine Einstellungen in der Option Bildverzeichnis gewählt.
  • Kommastellen in Farbdefinitionen sind mit Punkt – also 0.33 für 33% – vorzunehmen.
  • Farbdefinitionen können in folgenden Formaten vorgenommen werden:
    • 0,1,0.5,0.4 – CMYK-Definition: C= 0% | M= 100% | Y= 50% | K= 40%
    • 70%,8%,12%,0% – CMYK-Definition: C= 70% | M= 8% | Y= 12% | K= 0%
    • 255,0,128– RGB-Definition: R = 255 | G = 0 | B = 128
    • 0.7,0,-0.5– Lab-Definition: L = 70 | a = 0 | b = –50
    • PANTONE 327 C,1,0.03,0.56,0.15 – Schmuckfarbdefinition mit CMYK-Werten: Pantone 327 C mit den Farbwerten C = 100% | M = 3% | Y = 56% | K = 15%

3. CSV-Datei hochladen

Sie können eine CSV-Datei in der Applikation an zwei Stellen hochladen – im Reiter Variable Daten oder direkt im VDP-Editor. Erst nach dem Hochladen können Sie in den VDP-Elementen auf die Spalten der CSV-Datei verweisen.

Hochladen im Reiter »Variable Daten«

Zum Hochladen einer CSV-Datei im Reiter Variable Daten gehen Sie folgendermaßen vor:

  1. Öffnen Sie einen Artikel oder ein Motiv, welches variable Daten beinhalten soll.
  2. Wechseln Sie in den Reiter Variable Daten [1].
  3. Aktivieren Sie dort die Schaltfläche CSV-Datei hinzufügen [2].

Abbildung 1: Die anfängliche Ansicht eines VDP-Auftrags im Reiter Variable Daten in der Applikation

  1. Wählen Sie im Dialog CSV-Datei hinzufügen aus, ob Sie eine CSV-Datei hochladen oder ob Sie einen Amazon Transparency Code importieren wollen.
    • Zum Importieren von Amazon Transparency Codes wählen Sie in Quelle die Option Amazon Transparency Codes importieren [11] sowie die entsprechende Bestellung in Amazon Transparency Codes [12] aus.
    • Zum Hochladen einer CSV-Datei wählen Sie in Quelle die Option CSV-Datei hochladen [4] aus und fahren Sie wie nachstehend beschrieben fort.
  2. Im Reiter Allgemein [3] öffnen Sie die gewünschte CSV-Datei im Dateisystem oder ziehen die CSV-Datei in die Dropzone [5] und wählen die zu verwendenden Einstellungen aus. Es stehen im Dialog dabei folgende Optionen zur Verfügung:
    • Erste Zeile ist Tabellenkopf [6] – Aktivieren Sie diese Option, wenn in der CSV-Datei eine Kopfzeile mit Spaltenbezeichnungen definiert ist. Durch Aktivieren dieser Option wird dieser Datensatz nicht in der Produktion verwendet.
  3. Im Reiter Erweitert [7] bestimmen Sie nun die Trennzeichendefinition [8] – geben Sie mit, mit welchem Trennzeichen die CSV-Datei erstellt wurde.
    • Wählen Sie die Option Auswahlliste um in der Option Spaltentrennzeichen [9] das gewünschte Trennzeichen im Auswahlmenü auszuwählen.
    • Wählen Sie Benutzerdefiniert um in Spaltentrennzeichen [9] das verwendete Trennzeichen manuell einzugeben.
    • Wählen Sie zusätzlich unter Escape-Sequenz-Definition [10] aus den Optionen Auswahlliste, Benutzerdefiniert und Keine, um jeweils ein Zeichen anzugeben.
  4. Durch Klick auf Speichern, wird die CSV-Datei im definierten Muster dem Motiv hinzugefügt.

Abbildung 2: Links: Der CSV-Datei hinzufügen-Dialog mit dem Reiter Allgemein und der Möglichkeit eine CSV-Datei hochzuladen; Mitte: Der Reiter Erweitert; Rechts: Die Möglichkeit einen Amazon Transparency Code zu importieren

Hochladen im VDP-Editor

Der Vorgang, die CSV-Datei im VDP-Editor hochzuladen, funktioniert analog zum Hochladen im Reiter Variable Daten in der Applikation. Der einzige Unterschied ist dabei der Ausgangspunkt. Gehen Sie wie folgt dazu vor:

  1. Öffnen Sie einen Artikel oder ein Motiv, welches variable Daten beinhalten soll.
  2. Wechseln Sie in den Reiter Variable Daten [13].
  3. Bestimmen Sie dort die gewünschten Auftragseinstellungen [14].
  4. Aktivieren Sie die Schaltfläche VDP-Editor öffnen [15], wodurch der VDP-Editor gestartet wird.

Abbildung 3: Der Reiter Variable Daten in der Applikation zu Beginn eines VDP-Auftrags

  1. Nach dem Öffnen des VDP-Editors wird automatisch der Reiter Transformieren & Allgemeine Einstellungen [16] im Einstellungsbereich angezeigt.
  2. Klicken Sie auf die Schaltfläche Datei hochladen [17] im Einstellungsbereich Allgemeine Einstellungen.

Abbildung 4: Der Reiter Transformieren & Allgemeine Einstellungen im VDP-Editor

  1. Dadurch öffnet sich der Dialog CSV-Datei hinzufügen, worin Sie eine CSV-Datei durch einfaches Hineinziehen in die Dropzone auswählen bzw. Amazon Transparency Codes importieren können.
  2. Wählen Sie die gewünschten Einstellungen im Dialog aus und schließen Sie den Vorgang durch Drücken von Speichern [18] ab.

Abbildung 5: Der Dialog CSV-Datei hinzufügen mit einer CSV-Datei

  1. Ist der Hochladevorgang abgeschlossen, so werden Sie durch eine Nachricht darüber informiert.
  2. Nachdem die CSV-Datei hochgeladen ist, wird im Reiter Transformieren & Allgemeine Einstellungen der Dateiname [19] der CSV-Datei angezeigt.

Abbildung 6: Der Reiter Transformieren & Allgemeine Einstellungen im VDP-Editor mit einer bereits zugewiesenen CSV-Datei

4. CSV-Datei ersetzen, herunterladen, löschen und inspizieren

Sobald Sie dem Motiv eine CSV-Datei zugewiesen haben, so können Sie auf die Daten in den Spalten beim Konfigurieren der VDP-Elemente zugreifen. Sollten Sie jedoch die falsche CSV-Datei hochgeladen haben oder eine CSV-Datei ersetzen bzw. aktualisieren wollen, so können Sie diese Aktionen, wie nachfolgend beschrieben, ausführen.

CSV-Datei ersetzen

Eine bereits hochgeladene CSV-Datei kann im Nachhinein aktualisiert bzw. ersetzt werden. Dies kann direkt im VDP-Editor oder im Reiter Variable Daten der Applikation erfolgen. Gehen Sie dabei folgendermaßen vor:

  1. Öffnen Sie einen Artikel bzw. ein Motiv inkl. Variable Daten und CSV-Datei.
  2. Wechseln Sie in den Reiter Variable Daten.
  3. Dort betätigen Sie die Schaltfläche CSV-Datei ersetzen [21].
  4. Alternativ dazu können Sie auch den VDP-Editor öffnen und dort erneut das Symbol Datei hochladen drücken.

Abbildung 7: Der Reiter Variable Daten in der Applikation mit der Möglichkeit eine CSV-Datei zu ersetzen

CSV-Datei herunterladen

Eine bereits hochgeladene CSV-Datei kann im Nachhinein auch wieder heruntergeladen, jedoch dabei nicht im selben Moment gelöscht werden. Dies kann direkt im VDP-Editor oder im Reiter Variable Daten der Applikation erfolgen. Gehen Sie dabei folgendermaßen vor:

  1. Öffnen Sie einen Artikel bzw. ein Motiv inkl. Variable Daten und CSV-Datei.
  2. Wechseln Sie in den Reiter Variable Daten.
  3. Dort klicken Sie auf das Symbol Herunterladen [24].
  4. Alternativ dazu können Sie auch den VDP-Editor öffnen und dort das Symbol Herunterladen drücken.

Abbildung 8: Der Reiter Variable Daten im VDP-Editor mit der Möglichkeit eine CSV-Datei herunterzuladen und eine Vorschau zu betrachten

CSV-Datei löschen

Eine bereits hochgeladene CSV-Datei kann im Nachhinein auch wieder gelöscht werden. Dies kann direkt im VDP-Editor oder im Reiter Variable Daten der Applikation erfolgen. Gehen Sie dabei folgendermaßen vor:

  1. Öffnen Sie einen Artikel bzw. ein Motiv inkl. Variable Daten und CSV-Datei.
  2. Wechseln Sie in den Reiter Variable Daten.
  3. Dort betätigen Sie die Schaltfläche CSV-Datei löschen [22].
  4. Alternativ dazu können Sie auch den VDP-Editor öffnen und dort das Symbol CSV-Datei löschen [20] (Abbildung 6) drücken.

Abbildung 9: Der Reiter Variable Daten in der Applikation mit der Möglichkeit eine CSV-Datei zu löschen

Löschen einer CSV-Datei

Beachten Sie, dass durch das Löschen einer CSV-Datei ein VDP-Auftrag ungültig werden kann, wenn Sie für VDP-Elemente bereits zuvor diese als Datenquelle verwendet haben. Wenn Sie eine CSV-Datei aktualisieren wollen, so sollten Sie die CSV-Datei ersetzen, wodurch, wenn sich die CSV-Datei hinsichtlich der Struktur (Anzahl von Spalten) nicht unterscheidet, der VDP-Auftrag nicht ungültig wird.

4.1. CSV-Datei inspizieren

Bevor Sie an die Erstellung von variablen Elementen, die mit einer CSV-Datei verknüpft werden sollen, herangehen, sollten Sie sich zuvor ein Bild über den Inhalt der CSV-Datei machen.

Auch das Inspizieren der CSV-Datei kann im Reiter Variable Daten in der Applikation bzw. im Reiter Transformieren & Allgemeine Einstellungen im VDP-Editor durchgeführt werden.

4.1.1. Inspizieren im Reiter »Variable Daten«

Die Liste aller Datensätze kann über das Symbol Vorschau [23] (siehe Abbildung 9) eingesehen werden. Sie können durch die Liste [25] navigieren, so wie Sie es in der Applikation von anderen Listen gewohnt sind.

Abbildung 10: Der Dialog CSV-Datei mit angezeigtem Inhalt der CSV-Datei

4.1.2. Inspizieren im Reiter »Transformieren & Allgemeine Einstellungen«

Wenn Sie die Option CSV-Datei anzeigen [26] im Reiter Transformieren & Allgemeine Einstellungen im VDP-Editor drücken, so wird der Dialog CSV-Datei geöffnet, worin Sie alle Datensätze der CSV-Datei angezeigt bekommen. Sie können auch hier durch die Liste navigieren, so wie Sie es in der Applikation von anderen Listen gewohnt sind.

Abbildung 11: Links: Der Reiter Transformieren & Allgemeine Einstellungen im VDP-Editor; Rechts: Der Reiter mit angezeigtem Inhalt der CSV-Datei

Die Liste wird nicht sauber in Spalten getrennt angezeigt

Sollte die Liste der Datensätze nicht sauber in Spalten getrennt angezeigt werden, so haben Sie beim Hochladen der CSV-Datei das falsche Spaltentrennzeichen ausgewählt. Ersetzen Sie in diesem Fall die CSV-Datei und wählen Sie das korrekte Spaltentrennzeichen für die Spalten aus. Nur wenn sich die Liste so darstellt wie in der Abbildung gezeigt, kann von einer fehlerfreien Verarbeitung ausgegangen werden.

Artikel Update: $PRODUCT_NAME_WORKFLOW Version 2.3.0 – 10/2026

Vorheriger Artikel Konzeption und Benutzeroberfläche
Nächster Artikel VDP-Auftrag vorbereiten

Mit Variablen Daten umgehen

Allgemeine Informationen 5
VDP-Editor 5
Trennblatt-Editor 1
Amazon Transparency Codes 2

Andere Ressourcen
Noch Fragen? Kontaktieren Sie uns!