Benutzerhandbuch

Umgang mit CSV-Dateien

Aktualisiert am

Erfahren Sie in diesem Artikel,

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

1. Einführung

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. Umgang mit CSV-Dateien

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. 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.

2.1. CSV-Datei hochladen

CSV-Dateien können an zwei Stellen in der Applikation hochgeladen und dem Motiv angehängt werden. Erst wenn die CSV-Datei zugewiesen wurde, kann beim Erstellen auf den Inhalt in der CSV-Datei verwiesen werden.

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. Im Dialog CSV-Datei hinzufügen können Sie auswählen, 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öglichkeite einen Amazon Transparency Codes 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 is der Startpunkt. 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. Betätigen Sie 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 einfach 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 bereits eingefügten CSV-Datei

  1. Ist der Hochladevorgang abgeschlossen, so werden Sie durch eine Nachricht darüber informiert.
  2. Nach dem 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

2.2. CSV-Datei aktualisieren, herunterladen, löschen und anzeigen

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 aktualisieren wollen so können Sie dies tun, wie nachfolgend beschrieben.

CSV-Datei aktualisieren

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 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önne Sie auch den VDP-Editor öffnen und dort das Symbol CSV-Datei löschen [20] (Abbildung 6) drücken.

Abbildung 8: 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.

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 9: Der Reiter Variable Daten im VDP-Editor mit der Möglichkeit eine CSV-Datei herunterzuladen und eine Vorschau zu betrachten

2.3. 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.

2.3.1. 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

2.3.2. 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 den falschen Separator ausgewählt. Ersetzen Sie in diesem Fall die CSV-Datei und wählen Sie den korrekten Separator für Spalten aus. Nur wenn sich die Liste so darstellt wie in der Abbildung gezeigt, kann von einer fehlerfreien Verarbeitung ausgegangen werden.

2.4. 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%

Artikel Update: $PRODUCT_NAME_WORKFLOW Version 2.3.0 – 09/2026

Vorheriger Artikel Variable Daten – Eine Einführung
Nächster Artikel VDP-Auftrag vorbereiten

Mit Variablen Daten umgehen

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

Andere Ressourcen
Noch Fragen? Kontaktieren Sie uns!