So strukturieren Sie eine CSV-Datei für Flussdiagramme

Kurz gesagt

• Die Kopfzeile muss die erste Zeile der Datei sein, nicht die dritte, unter einem Berichtstitel.
• Zugeordnet wird über Überschriftennamen, nicht über Spaltenpositionen; unbekannte Spalten werden mitgeführt und ignoriert.
• Eine Zeile je Schritt, nicht je Datensatz. Ein Export ist meist ein Protokoll und keine Definition.
• Kommagetrennt und UTF-8. Eine Semikolondatei aus einer europäischen Ländereinstellung kommt als einzige Spalte an.
• Setzen Sie jedes Feld mit Komma, Anführungszeichen oder Zeilenumbruch in Anführungszeichen; ein echtes Anführungszeichen schreiben Sie doppelt.

Die Datei ist die Schnittstelle, also muss die Datei stimmen

CSV ist keine Tabellenkalkulation. Es ist eine reine Textdatei mit einer Zeile je Datenzeile und einem Trennzeichen zwischen den Feldern, und sie trägt keine Zelltypen, keine Formatierung, keine Formeln und kein zweites Blatt. Deshalb exportiert jedes System sie: ein Helpdesk, ein ERP, ein Personalsystem und eine Datenbankkonsole erzeugen alle eine, und einig sind sie sich über wenig mehr als die Kommas. Und deshalb funktioniert ein Import entweder sofort oder er scheitert so, dass es aussieht, als wäre nichts geschehen.

QueryChart liest die Datei über die Überschriftennamen. Die erste Zeile muss die Kopfzeile sein, und ihre Namen werden mit den eigenen Spalten des Editors abgeglichen (#, Form, Boxtext, Linie zu, Linientext, Horizontale Bahn, Vertikale Bahn) und nicht mit Positionen. Die Reihenfolge Ihrer Spalten spielt also keine Rolle, und eine Spalte, die QueryChart nicht kennt, wird mitgeführt und ignoriert. Ziehen Sie die .csv auf den Tabellenbereich eines Diagramms oder kopieren Sie die Zeilen hinein. Es gibt keinen Importassistenten und keinen Bildschirm zum Zuordnen von Spalten, und das ist der Tausch: Die Zuordnung steht in Ihrer Kopfzeile statt in einem Dialog.

Der Rest ist der Teil, an dem Menschen einen Nachmittag verlieren, und nichts davon hat mit Diagrammen zu tun. Eine Datei, die auf einem Rechner gespeichert wurde, dessen Listentrennzeichen ein Semikolon ist, ist keine kommagetrennte Datei. Ein Feld mit einem Komma muss in Anführungszeichen stehen, sonst wird es zu zwei Feldern. Eine Byte-Reihenfolge-Markierung ist in jedem Editor unsichtbar und hängt trotzdem am ersten Überschriftennamen. Eine Schrittreferenz 007 kommt aus einem Umweg über eine Tabellenkalkulation als 7 zurück. Das sind Dateiprobleme, und sie zu beheben lohnt sich, bevor Sie überhaupt an Formen denken: /de/guides/verbindungen-im-flussdiagramm-in-csv-definieren behandelt, was in die Verbindungsspalten gehört, sobald die Datei selbst überhaupt geparst wird.

Das Beispiel unten ist eine Support-Ticket-Triage, richtig exportiert: achtzehn Zeilen, eine je Schritt, Spalte für Spalte aufgebaut. Lesen Sie es als Datei und nicht als Bild. Das Diagramm ist das, was Sie bekommen, wenn die Spalten stimmen, und nicht das, worum Sie sich mühen müssen. Wenn Sie eine bereits korrekte Datei als Muster brauchen, öffnen Sie /de/templates/csv-zu-flussdiagramm und sehen Sie sich die Zeilen dazu an.

Eine CSV, Spalte für Spalte gelesen

Eine Support-Ticket-Triage als achtzehn Zeilen. Öffnen Sie das Tabellenpanel, um zu sehen, welche Spalte der Datei jede Stufe füllt.

1. Kopfzeile und eine Zeile je Schritt

   Die erste Zeile der Datei benennt die Spalten; jede Zeile darunter ist ein Schritt. Die Zeilen 1 bis 6 laufen von „Ticket melden“ bis „Priorität aus Auswirkung und Dringlichkeit festlegen“, jede auf einer eigenen Zeile und mit nichts als einer Beschriftung. Das ist das Minimum, mit dem eine Datei überhaupt importiert wird, und es ist auch der Punkt, an dem die meisten Exporte bereits falsch liegen, weil sie eine Zeile je Ticket enthalten und nicht eine Zeile je Schritt.

2. Die Spalte Form

   Form ist ein Wert, den der Parser abgleicht, also wird er genau geschrieben: Start in Zeile 1, Prozess in Zeile 2, Entscheidung in den Zeilen 3, 5, 7 und 9. „Angaben ausreichend für die Bearbeitung?“ und „Hat die Lösung gewirkt?“ sind Rauten, weil in der Zelle Entscheidung steht, und nicht wegen des Fragezeichens. Ein Wert, den der Parser nicht kennt, fällt stillschweigend auf Prozess zurück. So landet eine Entscheidung als Rechteck, an dem die Verzweigungsbeschriftungen weiterhin hängen.

3. Linie zu und Linientext, in Anführungszeichen

   Zeile 5, „Antwort vor Ablauf der Nachfassfrist?“, hat Linie zu 6,18 und Linientext „Antwort eingegangen,Keine Antwort“: zwei Listen, positionsweise gepaart, und beide enthalten ein Komma, also stehen beide Felder in der Datei in Anführungszeichen. Dasselbe gilt für jeden Boxtext, der ein Komma trägt: Das Komma gehört dann zur Beschriftung und nicht zum Format. Nehmen Sie diese Anführungszeichen weg, gewinnt die Zeile ein Feld und alles dahinter rutscht eine Spalte nach links.

4. Die Bahnenspalten und die fertige Datei

   Die letzten beiden Spalten werden wie jede andere über den Namen zugeordnet: Horizontale Bahn trägt Meldung, Triage, First Level, Eskalation und Abschluss, Vertikale Bahn trägt Melder, Service Desk und Fachteam. Sind sie gefüllt, werden dieselben achtzehn Zeilen als Swimlane-Diagramm gezeichnet, das bei „Ticket geschlossen“ in Zeile 17 und „Geschlossen, keine Antwort des Melders“ in Zeile 18 endet. An der Datei hat sich nichts geändert außer zwei weiteren Spalten mit gewöhnlichem Text.

So funktioniert es

1. Exportieren Sie eine einzige schlichte Tabelle

   Aus welchem System die Daten auch stammen: Exportieren Sie das Raster und sonst nichts. Berichtstitel, ein Datumsstempel, eine Logozeile, verbundene Überschriften, Zwischensummenzeilen und eine abschließende Leerzeile landen alle als Zeilen in der Datei, und jede davon wird als Schritt gelesen. Bietet der Export eine Option „Rohdaten“ oder „unformatiert“, dann ist das die richtige.

2. Machen Sie die Kopfzeile zur Zeile eins

   Öffnen Sie die Datei in einem Texteditor statt in einer Tabellenkalkulation und sehen Sie sich die erste Zeile an. Sie muss die Kopfzeile sein. Exporte, die mit zwei oder drei Metadatenzeilen beginnen, sind häufig genug, dass dies das Erste ist, was zu prüfen ist, und diese Zeilen zu löschen ist die ganze Lösung.

3. Benennen Sie die Überschriften auf die Spaltennamen von QueryChart um

   Setzen Sie die Kopfzellen auf Form, Boxtext, Linie zu, Linientext, Horizontale Bahn und Vertikale Bahn. Zugeordnet wird über den Namen, die Spalten dürfen also in beliebiger Reihenfolge stehen, und Ihre eigenen Spalten (Ticketnummer, System, Durchlaufzeit) können unangetastet in der Datei bleiben; sie werden mitgeführt und ignoriert statt abgelehnt.

4. Verdichten Sie die Zeilen auf eine je Schritt

   Ein Export ist normalerweise ein Protokoll: eine Zeile je Ticket, je Auftrag, je Vorgang. Ein Flussdiagramm braucht eine Zeile je unterschiedenem Schritt, verdichten oder entdoppeln Sie also zuerst und heben Sie die Mengen für die spätere Auswertung auf. Eine Datei mit viertausend Zeilen ist ein Datenbestand und kein Prozess, und sie zu importieren erzeugt viertausend Kästen.

5. Nummerieren Sie die Schritte und füllen Sie Linie zu

   Linie zu enthält die 1-basierte Position der Zielzeile, gezählt werden dabei nur die Datenzeilen, der erste Schritt unter der Kopfzeile ist also 1. Es ist nicht die Ticketnummer, nicht der Schrittcode und nichts aus dem Quellsystem. Führt ein Schritt an zwei Stellen, schreiben Sie beide Zahlen kommagetrennt in dasselbe Feld und setzen Sie das Feld in Anführungszeichen.

6. Trennzeichen und Kodierung richten, dann die Datei ablegen

   Speichern Sie kommagetrennt als UTF-8 und ziehen Sie die .csv dann auf den Tabellenbereich eines neuen Diagramms. Lesen Sie die erste Darstellung als Prüfung der Datei: Die Zeilenzahl sollte Ihrer Schrittzahl entsprechen, und jede Spalte sollte dort gelandet sein, wo Sie sie erwarten. Eine Datei, die als eine breite Spalte ankommt, ist ein Problem des Trennzeichens und kein gescheiterter Import.

Häufige Fehler

• Eine Semikolondatei mit der Endung .csv

  Auf einem Rechner, dessen regionales Listentrennzeichen ein Semikolon ist, schreibt „Speichern unter CSV“ Semikolons, und die Datei endet trotzdem auf .csv. Sie kommt als eine Spalte an, in der alle Werte stecken. Exportieren Sie mit Kommas neu oder ersetzen Sie die Trennzeichen vor dem Import in einem Texteditor.

• Die Kopfzeile ist nicht die erste Zeile

  Berichtsexporte setzen gewohnheitsmäßig einen Titel, einen Zeitraum und eine Leerzeile über die Daten. QueryChart liest Zeile eins als Kopfzeile, diese Zeilen werden also zu den Spaltennamen und Ihre eigentliche Kopfzeile zu einem Schritt. Löschen Sie alles oberhalb der Kopfzeile.

• Ein Komma in einer Verzweigungsbeschriftung

  Anführungszeichen schützen ein Feld vor dem CSV-Parser, aber Linientext teilt selbst an Kommas, um Beschriftungen den Zielen zuzuordnen. Ein Zweig mit der Beschriftung „Ja, mit Freigabe“ wird deshalb zu zwei Beschriftungen, egal wie er eingepackt ist. Benennen Sie den Zweig stattdessen um. Kurze Beschriftungen sind auf einem Diagramm ohnehin besser.

• Führende Nullen und lange Zahlen nach dem Umweg

  CSV hat keine Typen, also entscheidet das Programm, in dem Sie die Datei öffnen. Einmal in einer Tabellenkalkulation geöffnet und neu gespeichert, wird aus 007 die 7, aus einer sechzehnstelligen Referenz 4,12346E+15 und aus 3/4 ein Datum. Bearbeiten Sie die Datei in einem Texteditor oder importieren Sie die Spalte als Text und prüfen Sie die Werte, die Codes waren und keine Zahlen.

Importieren Sie Ihre CSV als Flussdiagramm

Öffnen Sie das Triage-Beispiel, sehen Sie sich die genauen Spaltennamen und die Anführungszeichen an und ziehen Sie dann Ihre eigene Datei darüber.

Importieren Sie Ihre CSV als Flussdiagramm

Verwandte Anleitungen

• So erstellen Sie ein Swimlane-Diagramm aus einer CSV
• CSV oder Excel für Flussdiagramme: aus welcher Datei bauen
• Ablaufdiagramm für den Mitarbeiter-Onboarding-Prozess — Excel

Häufig gestellte Fragen

Spielt die Spaltenreihenfolge in meiner CSV eine Rolle?

Nein. Zugeordnet wird über den Überschriftennamen, Boxtext darf also die vierte Spalte sein und Form die letzte. Wichtig ist, dass die Namen die des Editors sind (Form, Boxtext, Linie zu, Linientext, Horizontale Bahn, Vertikale Bahn) und dass sie auf der ersten Zeile der Datei stehen. Spalten, die QueryChart nicht kennt, werden mitgeführt und ignoriert, Sie müssen Ihre Ticketnummern, Systeme oder Zeiten also nicht vorher herausnehmen.

Welches Trennzeichen und welche Kodierung soll die Datei haben?

Kommas und UTF-8. Semikolons sind der übliche Fehlschlag: Auf einem Rechner mit europäischem Listentrennzeichen ist die „CSV“ aus Excel semikolongetrennt, und die Datei wird dann als eine einzige Spalte importiert. Die Kodierung zeigt sich an zerschossenen Umlauten. Speichern Sie als „CSV UTF-8“ statt als schlichte CSV. Wenn jede Spalte zugeordnet wird außer der ersten, verdächtigen Sie eine Byte-Reihenfolge-Markierung: Sie ist im Editor unsichtbar, hängt aber am ersten Überschriftennamen, sodass dieser Name nicht mehr passt.

Wie schreibe ich ein Feld, das ein Komma enthält?

Setzen Sie das ganze Feld in doppelte Anführungszeichen: „Geschlossen, keine Antwort des Melders“. Ein echtes doppeltes Anführungszeichen innerhalb eines solchen Feldes wird als zwei Anführungszeichen geschrieben. Zeilenumbrüche in einem eingepackten Feld sind ebenfalls zulässig, auch wenn eine Kastenbeschriftung selten einen braucht. Die beiden Verbindungsspalten brauchen fast immer Anführungszeichen, denn „6,18“ und „Antwort eingegangen,Keine Antwort“ enthalten das Trennzeichen bewusst. Genau das paart die Beschriftungen mit den Zielen.

Mein Export hat eine Zeile je Ticket, nicht je Schritt. Kann ich ihn verwenden?

Nicht direkt. Ein Vorgangsprotokoll beschreibt, was tausendfach geschehen ist; ein Flussdiagramm beschreibt, was einmal geschehen soll. Reduzieren Sie es zuerst auf die unterschiedenen Schritte (eine Pivotierung über die Tätigkeits- oder Statusspalte reicht meist) und heben Sie die Mengen getrennt auf, denn sie sind die interessante Hälfte einer Prozessanalyse. /de/guides/csv-in-eine-prozesslandkarte-umwandeln geht diese Reduktion an einem Export genau dieser Form durch.

Welche Spalten sind wirklich erforderlich?

Boxtext allein wird importiert: Sie erhalten eine Spalte unverbundener Kästen. Ergänzen Sie Linie zu, und daraus wird ein Flussdiagramm, denn das ist die Spalte, die die Beziehungen trägt. Form, Linientext und die beiden Bahnenspalten sind Verfeinerungen: Entscheidungen als Rauten, beschriftete Zweige, Schritte mit Phase und Verantwortlichem. Wenn Sie lieber von einer bereits korrekt strukturierten Datei ausgehen: Die CSV-Vorlagen sind herunterladbare CSVs funktionierender Diagramme.