Ich baue Toolz.dev‘und ein wiederkehrender Job über die WordPress - und Laravel-Arbeit, die ich mache, ist das Einspeisen von Daten in Systeme, die vor ein oder zwei Jahrzehnten entworfen wurden Viele von ihnen sprechen immer noch XML und nur XML: ein Produkt-Feed für einen Marktplatz, ein Importformat für ein Buchhaltungspaket, ein SOAP-Endpunkt, der nichts anderes betrachtet Die Daten kommen fast immer als CSV-Export aus einer Tabellenkalkulation, also besteht die Aufgabe darin, flache, durch Kommas getrennte Zeilen in ein strukturiertes XML-Dokument umzuwandelnIch habe beobachtet, wie das auf jede erdenkliche Weise schiefgeht, von einem Kundennamen, der ein Komma enthält, das in zwei Spalten aufgeteilt ist, bis hin zu einem Ampersand in einem Firmennamen, der die ganze Datei nicht analysiert wurde. Die CSV-zu-XML-Konverter Existiert, um diese Konvertierung korrekt im Browser durchzuführen, ohne eine Kundenliste in einen anonymen Server einzufügen. Dieses Handbuch behandelt, was die Konvertierung beinhaltet, warum die kniffligen Teile knifflig sind und wie man die Ausgabe für alles formt, was sie lesen wird.
tl; dr: Ein CSV-zu-XML-Konverter liest durch Kommas getrennte Zeilen und schreibt sie als wohlgeformtes XML-Dokument, wobei jede Zeile zu einem Element wird und jede Zelle entweder zu einem benannten untergeordneten Element oder einem Attribut wird. Es analysiert CSV gemäß RFC 4180, sodass zitierte Felder, die Kommas, Anführungszeichen oder Zeilenumbrüche enthalten, erhalten bleiben; Es erkennt automatisch, ob es sich bei dem Trennzeichen um ein Komma, ein Semikolon, eine Registerkarte oder eine Pipe handelt; es zwingt Spaltennamen in gültige XML-Tags; und es entgeht den markup-bedeutenden Zeichen, sodass die Ausgabe immer analysiert wird. Es läuft vollständig in Ihrem Browser, sodass die Daten in Ihrem CSV nie hochgeladen werden.
Was ist der Unterschied zwischen CSV und XML?
CSV, kommagetrennte Werte, ist ein flaches Textformat Jede Zeile ist ein Datensatz, und innerhalb einer Zeile wird jedes Feld durch ein Trennzeichen, meist ein Komma, getrennt, es ist kompakt, jede Tabellenkalkulation kann es exportieren, und es ist trivial für einen Menschen zu lesen Was es nicht kann, ist Struktur oder Bedeutung auszudrücken In einem CSV steht nichts, was eine Spalte bedeutet, keine Verschachtelung, keine Typen; ein Zellenhalt true und eine Zelle, die das Wort hält true Ununterscheidbar sind, und ein Wert, der selbst ein Komma enthält, bedarf eines besonderen Zitats, um nicht als zwei Felder gelesen zu werden.
XML, die Extensible Markup Language, ist der umgekehrte HandelJeder Wert ist in ein benanntes Tag eingewickelt, also <name>Ada Lovelace</name> Trägt sowohl den Wert als auch die Beschriftung dafür, Dass Ausführlichkeit Struktur kauft: Elemente verschachteln sich, Dokumente können anhand eines Schemas validiert werden, und ein Stylesheet kann das Ganze transformieren Die Regeln dafür, was als wohlgeformtes XML zählt, sind in der W3 C XML 1.0 Spezifikation‘und sie sind streng in einer Weise, wie CSV nie ist, was genau der Grund ist, warum eine mechanische Konvertierung vorsichtig sein muss Umwandeln von CSV in XML geht es im Grunde darum, die Struktur und das Escaping, das CSV implizit hinterlässt, hinzuzufügen.
Wie wird eine Reihe zum Element?
Die natürliche Abbildung behandelt die erste CSV-Zeile als Kopfzeile, die Spaltennamen hält, und jede folgende Zeile als einen Datensatz Jeder Datensatz wird zu einem Zeilenelement, und in seinem Inneren wird jede Zelle zu einem untergeordneten Element, das nach seiner Spalte benannt ist Also ein CSV von id,name,role Mit einer Datenzeile 1,Ada Lovelace,Engineer wird:
<rows>
<row>
<id>1</id>
<name>Ada Lovelace</name>
<role>Engineer</role>
</row>
</rows>
Die äußere rows Element ist der Dokumentstamm, denn ein wohlgeformtes XML-Dokument muss genau ein Element der obersten Ebene haben, das alles andere umhüllt Der Konverter lässt Sie sowohl das Stamm - als auch das pro-Zeile-Element umbenennen, sodass Sie produzieren können <catalog><product>...</product></catalog> Stattdessen, wenn das das ist, was Ihr Ziel erwartet Die Spaltennamen werden zu den Tag-Namen, wo die erste echte Einschränkung beißt, denn nicht jede Spaltenüberschrift ist ein legales XML-Tag.
Warum werden einige Spaltennamen geändert?
XML-Elementnamen sind nicht frei form. Die Spezifikation besagt, dass ein Name mit einem Buchstaben oder Unterstrich beginnen muss und dann möglicherweise Buchstaben, Ziffern, Bindestriche, Punkte und Unterstriche enthält, jedoch keine Leerzeichen und nicht die meisten Satzzeichen, und es darf nicht mit einer Ziffer beginnen. Eine Tabellenkalkulationsspalte namens First Name oder Unit Price ($) oder 2024 Total Ist eine vollkommen gute Überschrift und ein illegales XML-Tag. Wenn ein Konverter aussendet <First Name> Das Dokument würde überhaupt nicht analysiert.
Das Tool bereinigt also jeden Spaltennamen in ein gültiges Tag Leerzeichen und illegale Zeichen werden zu Unterstrichen, also First Name wird First_NameUnd ein Name, der mit einer Ziffer beginnt, erhält ein Unterstrichpräfix 2024 Total wird _2024_Total. Wenn zwei Spalten auf dasselbe Tag bereinigen, oder der Header einen Namen wirklich wiederholt, erhalten die Duplikate ein numerisches Suffix, sodass keine Spalte stillschweigend ein anderes überschreibt, und das Tool warnt Sie, wenn es dies getan hat Die wichtige Garantie ist, dass nur die Tag-Namen angepasst werden; die Daten in jeder Zelle werden unberührt durchgelassen. Wenn Sie die Originalbeschriftungen genau beibehalten müssen, passt der unten behandelte Attributmodus oft besser, da Attributnamen denselben Regeln entsprechen, Sie sich aber auch dafür entscheiden können, die Überschrift als Wert an anderer Stelle zu tragen.
Wie sieht es mit Kommas und Anführungszeichen innerhalb eines Wertes aus?
Dies ist der Teil, der naive Konverter bricht, und es lohnt sich zu verstehen. CSV hat eine Zitatkonvention, formalisiert in RFC 4180, für Werte, die den Grenzwert oder einen Zeilenumbruch enthalten Ein solcher Wert wird in doppelte Anführungszeichen gewickelt, und jedes wörtliche doppelte Anführungszeichen darin wird als zwei doppelte Anführungszeichen geschrieben Also eine Firmenfeldhaltung Hopper, Grace CSV gespeichert ist als "Hopper, Grace"und eine Notizlesung she said "hi" gespeichert wird als "she said ""hi"""drohen
Ein Konverter, der jede Zeile auf Kommas aufteilt, wird diese beiden verstümmeln, ein Feld in zwei verwandeln und überall verirrte Anführungszeichen hinterlassen Dieses Tool verwendet einen richtigen Zustandsmaschinen-Parser, der verfolgt, ob es sich innerhalb eines zitierten Feldes befindet, also ein eingebettetes Komma, ein eingebettetes Zitat und sogar eine neue Zeile innerhalb eines angegebenen Wertes werden alle als Teil des einzigen Feldes gelesen, zu dem sie gehören. Das ist der Unterschied zwischen einem benannten Kunden Smith, John Ankunft als Eins <name> Element und als gebrochener Datensatz mit einer zusätzlichen Spalte ankommen Wenn Ihr Export aus Excel, Google Sheets oder einem Datenbank-Dump kam, verwendet er mit ziemlicher Sicherheit dieses Zitat, und das korrekte Parsen ist nicht optional.
Sobald der Wert sicher analysiert ist, muss er noch für XML sicher gemacht werden, was ein separates Escaping-Problem ist. Fünf Zeichen sind in XML etwas Besonderes, und die drei, die im Elementtext wichtig sind, sind das kaufmännische Zeichen, das Less-Than-Zeichen und das Größer-als-Zeichen. Eine Zelle enthält Ben & Jerry's oder x < y Ungültiges XML erzeugen würde, wenn es wörtlich geschrieben wird, so dass der Konverter sie durch die vordefinierten Entitäten ersetzt &, <, und >. In Attributwerten wird das doppelte Zitat ebenfalls ausgeblendet Dieses Escaping garantiert die Ausgabeparsen, egal was die Daten enthalten.
Soll jede Zelle ein Element oder ein Attribut sein?
XML gibt Ihnen zwei Stellen, an denen Sie einen Wert setzen können: als Text eines untergeordneten Elements, oder als Attribut auf dem Zeilenelement Der Konverter unterstützt beides, und welcher richtig ist, hängt ganz von dem System ab, das die Datei lesen wird Der Elementmodus erzeugt die lesbare, verschachtelbare Form:
<row>
<name>Ada</name>
</row>
Der Attributmodus kollabiert die gesamte Zeile in einem einzigen selbstschließenden Element:
<row name="Ada" role="Engineer"/>
So vergleichen sich die beiden in den Dimensionen, die normalerweise darüber entscheiden:
| Rücksicht | Kind Elemente | Attribute |
|---|---|---|
| Lesbarkeit | Höher, ein Wert pro Zeile | Denser, eine Zeile pro Zeile |
| Dateigröße | Größer, Tags wiederholt | Kleiner |
| Später weiter nisten können | ja | kein |
| Wiederholte Werte pro Spalte | Erlaubt | Ein Wert pro Attributname |
| Typische Passform | Daten im Dokumentstil, Feeds | Kompakte Datensätze, konfigurieren |
Als Faustregel gilt, wenn die Daten record-artig und flach sind und der Leser sie klein haben möchte, sind Attribute in Ordnung; wenn die Daten später möglicherweise an Struktur wachsen, oder ein Mensch sie lesen wird, sind Elemente die sicherere Voreinstellung Wenn Sie sich nicht sicher sind, was das konsumierende System will, sind Elemente die konservativere Wahl, da alles, was Attribute akzeptiert, auch an Elemente angepasst werden kann, aber das Gegenteil ist nicht immer der Fall.
So verwenden Sie den CSV-zu-XML-Konverter
Schritt 1: Fügen Sie Ihren CSV ein
Fügen Sie Ihre CSV ein oder geben Sie sie in das Eingabefeld ein Ein direkt aus Excel oder Google Sheets kopierter Block funktioniert ebenso wie der Inhalt eines .csv Datei, einschließlich zitierter Felder, die Kommas oder Zeilenumbrüche enthalten.
Schritt 2: Legen Sie die Optionen fest
Lassen Sie den Trennzeichen auf auto-detect oder wählen Sie einen explizit, bestätigen Sie, ob die erste Zeile ein Header ist, setzen Sie die Namen der Wurzel - und Zeilenelemente, und wählen Sie aus, ob jede Zelle ein untergeordnetes Element oder ein Attribut wird Sie können auch die XML-Deklaration umschalten und zwischen eingekerbter und minifizierter Ausgabe wechseln.
Schritt 3: Konvertieren
Klicken Sie auf In XML konvertieren Das Tool analysiert jede Zeile, bereinigt die Spaltennamen in gültige Tags, entgeht den Markup-Zeichen und stellt ein wohlgeformtes Dokument zusammen, das Sie vor umbenannten Spalten oder zerlumpten Zeilen warnt.
Schritt 4: Kopieren oder herunterladen
Kopieren Sie das XML in Ihre Zwischenablage oder laden Sie es als herunter .xml Datei. wenn die Form für das Zielsystem nicht ganz stimmt, passen Sie die Elementnamen an oder wechseln Sie zwischen Element - und Attributmodus und konvertieren Sie erneut.
Warum den Trennzeichen automatisch erkennen?
Nicht jedes & quot; CSV" ist durch Kommas getrennt Exporte von europäischen Lokalen verwenden häufig ein Semikolon, da das Komma in diesen Regionen das Dezimaltrennzeichen ist und Daten, die aus einer Datenbank oder einem Protokoll gezogen werden, oft durch Tabulatoren getrennt sind. Ein an Kommas gesperrter Konverter würde eine Semikolondatei als eine einzige breite Spalte lesen und Unsinn erzeugen. Dieses Tool erkennt den Trennzeichen, indem es Komma, Semikolon, Tabulator und Pipe versucht und auswählt, welche eine konsistente Spaltenanzahl über die ersten Zeilen erzeugt, was ein weitaus zuverlässigeres Signal als die Rohfrequenz ist, da ein Komma in Prosa oft, aber unregelmäßig erscheint. Sie können die Vermutung immer überschreiben, wenn eine Datei ungewöhnlich ist.
Zerrissene Zeilen, bei denen eine Zeile mehr oder weniger Felder als der Header hat, sind das andere reale Durcheinander Der Konverter paddet kurze Zeilen mit leeren Elementen und warnt Sie, anstatt stillschweigend Daten fallen zu lassen, sodass Sie sehen können, dass Zeile 47 ihre letzten beiden Felder gefehlt hat, anstatt sie stromabwärts zu entdecken Zusätzliche Felder jenseits des Headers erhalten generische Spaltennamen, damit nichts verloren geht, und die Warnung sagt Ihnen genau, wie viele Zeilen betroffen waren, was normalerweise ausreicht, um das Problem auf einen verirrten Trennzeichen in der Quelle zurückzuführen Wenn Sie eine unordentliche Datei vor der Konvertierung überprüfen möchten, wird die CSV-Betrachter Rendert es als Tabelle mit demselben toleranten Parser, was oft die schnellste Möglichkeit ist, einen abweichenden Trennzeichen oder ein nicht geschlossenes Zitat zu erkennen, bevor es zu einer fehlerhaften Ausgabe wird.
Wo der CSV zu XML Konverter zu allem anderen passt
Die Datenkonvertierung ist selten ein einzelner Hop. Die gleiche CSV, die heute XML werden muss, muss möglicherweise morgen für eine REST-API oder eine Charge von SQL-Einfügungen für eine Datenbanklast zu JSON werden. Die CSV-zu-JSON-Konverter Behandelt das JSON-Ziel mit demselben RFC 4180-Parser und dem CSV-zu-SQL-Konverter Verwandeln Sie dieselben Zeilen in Einfügeanweisungen Wenn die Daten bereits XML sind und Sie in die andere Richtung gehen müssen, wird die XML-zu-JSON-Konverter und das JSON-zu-XML-Konverter Deckt beide Richtungen der XML-JSON-Grenze ab und verwendet dieselben Attribut- und Textkonventionen, denen dieses Tool folgt, sodass die Hin- und Rückfahrt vorhersehbar ist.
Für das Gesamtbild ist die CSV-zu-JSON-Leitfaden Grabt tiefer in die Analyse der gleichen chaotischen Exporte ein, die JSON-zu-XML-Leitfaden Erklärt die Element-and-Attribute-Zuordnung von der JSON-Seite und der Datenschutz in Online-Tools Artikel erklärt, warum es wichtig ist, all dies im Browser zu tun, wenn die CSV Namen und E-Mail-Adressen speichert Wie alles auf Toolz.dev läuft der Konverter vollständig in Ihrem Browser, sodass die Daten, die Sie konvertieren, Ihren Computer nie verlassen.
Häufig gestellte Fragen
Wie konvertiere ich eine CSV-Datei in XML?
Fügen Sie die CSV in das Eingabefeld ein, bestätigen Sie die Einstellungen für den Trennzeichen und den Header, und klicken Sie auf Konvertieren in XML Die erste Zeile wird als Spaltennamen gelesen, und jede folgende Zeile wird zu einem XML-Element, dessen untergeordnete Tags nach diesen Spalten benannt sind, Sie können das Ergebnis dann kopieren oder als . xml-Datei herunterladen.
Was passiert mit der CSV-Header-Reihe?
Wenn & quot; erste Zeile header" eingeschaltet ist, werden die Headerzellen zu den XML-Elementnamen für jede Datenzeile Namen werden in gültige XML-Tags bereinigt, so wird " First Name" zu First_Name und eine doppelte Spalte wird mit einem numerischen Suffix umbenannt, wenn Sie die Header-Option ausschalten, werden Spalten mit spalte_1, spalte_2 und so weiter bezeichnet.
Soll jede Zelle ein Element oder ein Attribut sein?
Es hängt davon ab, dass das System das XML liest Der Elementmodus schreibt eine lesbare verschachtelbare Struktur mit einem Tag pro Wert, während der Attributmodus eine Zeile in ein einzelnes kompaktes Element mit einem Attribut pro Spalte zusammenfaltet Dieser Konverter unterstützt beides, also wählen Sie das aus, das Ihr Schema oder Ihr Importziel erwartet; Elemente sind die sicherere Voreinstellung, wenn Sie sich nicht sicher sind.
Verarbeitet der Konverter Kommas innerhalb eines Werts?
Ja. Nach RFC 4180 wird ein Wert, der ein Komma, ein doppeltes Zitat oder einen Zeilenumbruch enthält, in der CSV in doppelte Anführungszeichen gewickelt, und ein eingebettetes Zitat wird als zwei Anführungszeichen geschrieben Der Parser liest diese zitierten Felder als einen einzigen Wert, anstatt sie aufzuteilen, also bleibt & quot; Hopper, Grace" in einem Element.
Welche Trennzeichen werden unterstützt?
Komma, Semikolon, Tabulator und Pipe Standardmäßig erkennt das Tool den Trennzeichen automatisch, indem es diejenige auswählt, die eine konsistente Anzahl von Spalten über die ersten Zeilen hinweg erzeugt, die europäische Semikolondateien und Tabulator-getrennte Exporte korrekt verarbeitet Sie können den Trennzeichen auch manuell auswählen.
Warum werden einige meiner Spaltennamen im XML geändert?
XML-Elementnamen können keine Leerzeichen oder die meisten Satzzeichen enthalten und nicht mit einer Ziffer oder Bindestrich beginnen Der Konverter ersetzt illegale Zeichen durch Unterstriche und legt einen Namen vor, der mit einer Ziffer beginnt, sodass die Ausgabe immer gut geformt ist. Die Originaldaten in jeder Zelle werden nie geändert, nur die Tag-Namen.
Werden meine CSV-Daten auf einen Server hochgeladen?
Nr. Die gesamte Konvertierung läuft in Ihrem Browser mit JavaScript Nichts, was Sie einfügen, wird übertragen, protokolliert oder gespeichert, und das Tool arbeitet weiterhin ohne Netzwerkverbindung, sobald die Seite geladen wurde, wodurch Namen, E-Mails und andere Daten in Ihrem CSV privat bleiben.
Kann ich XML zurück in CSV oder in JSON konvertieren?
Dieses Tool konvertiert CSV in XML Um die Daten in die andere Richtung umzugestalten, verwenden Sie den XML-zu-JSON-Konverter und verwenden Sie den CSV-zu-JSON-Konverter, wenn JSON und nicht XML Ihr Ziel ist Alle laufen clientseitig mit den gleichen Datenschutzgarantien.
