SS Boîte à outils
SS Boîte à outils
Toutes les données sont traitées localement

Convertisseur XML vers JSON pour SOAP, payloads d'API et attributs de balises

Lisez une réponse SOAP ou un payload XML d'API au format JSON dans le navigateur, et réécrivez des objets JSON en balises et attributs. Le mapping compact est prévisible, mais un seul enfant et deux enfants homonymes produisent des structures JSON différentes, et l'ordre du texte mixte n'est pas conservé.

Le comportement de ce convertisseur XML ↔ JSON

  1. Les balises deviennent des clés, les attributs vont dans _attributes

    Chaque élément devient une clé portant le nom de sa balise. <user id="7">Ann</user> donne { user: { _attributes: { id: "7" }, _text: "Ann" } }, sans mélange entre attributs, texte et balises enfants.

  2. Un enfant est un objet, deux deviennent un tableau

    Un seul <item> reste un objet ; deux <item> frères deviennent un tableau JSON. Quand une réponse passe de deux lignes à une, la structure change : le client doit gérer les deux formes.

  3. Déclaration, commentaires et CDATA ont leurs propres clés

    _declaration, _doctype, _comment et _cdata apparaissent au même niveau que l'élément racine. Le CDATA est lu comme du texte brut, et les quatre sont réécrits lors de la conversion JSON → XML.

  4. Le texte reste, sa position non

    En mode compact, les textes situés de part et d'autre d'un enfant sont fusionnés dans un tableau _text : <r>before<a>1</a>after</r> donne _text: ["before", "after"] et, réécrit, beforeafter<a>1</a>. Pour un aller-retour propre, utilisez un contenu composé uniquement d'éléments.

  5. Espaces de noms et caractères spéciaux pris en charge

    xmlns / xmlns:p restent des attributs ordinaires et les <, & et > du texte sont échappés en sortie puis restaurés en entrée. Les fichiers sont lus et convertis localement, rien n'est envoyé.

FAQ sur la conversion XML ↔ JSON

Pourquoi la structure JSON change-t-elle quand une seule ligne revient ?

À cause du mode compact de xml-js : les enfants homonymes répétés deviennent un tableau, un enfant unique reste un objet. Deux <item> donnent item: [...], un seul donne item: {...}. Normalisez en tableau avant de lire les champs.

Comment sont représentés les attributs et le texte des éléments ?

Les attributs vont dans _attributes, le texte dans _text, par exemple <user id="7">Ann</user> → { user: { _attributes: { id: "7" }, _text: "Ann" } }. Le texte est toujours une chaîne, même pour <n>42</n>, et un élément vide devient {}.

Puis-je convertir un tableau JSON racine en XML ?

Non. La racine JSON doit être un objet unique ; un tableau racine produit des noms de balises invalides comme <0><r>a</r></0><1><r>b</r></1>. Encapsulez le tableau dans un objet racine, par exemple { "items": { "item": [...] } }.

Déclaration, commentaires, CDATA et DOCTYPE sont-ils conservés ?

Oui, via les clés _declaration, _comment, _cdata et _doctype. À la lecture, _comment contient les espaces alentour (par ex. " hi ") ; à l'écriture, on retrouve <?xml ...?>, <!--hi-->, <![CDATA[...]]> et <!DOCTYPE r>.

Que devient le texte mêlé à des éléments enfants ?

Le mode compact regroupe les fragments de texte dans un tableau _text et perd leurs positions. <r>before<a>1</a>after</r> devient { r: { _text: ["before", "after"], a: { _text: "1" } } }, et l'écriture donne <r>beforeafter<a>1</a></r>. Le mode non compact conserve l'ordre, mais cette page est fixée en compact.

Comment sont traités les espaces de noms et les caractères spéciaux ?

Les déclarations d'espace de noms restent des attributs normaux (xmlns, xmlns:p) et les balises préfixées gardent le préfixe dans la clé (p:a). Le texte échappe <, & et > en écriture et résout les entités en lecture ; les valeurs d'attributs n'échappent que les guillemets, donc un < ou & brut dans un attribut peut produire un XML invalide.

Quelles erreurs apparaissent, et mes données sont-elles envoyées ?

Plusieurs racines échouent avec « Text data outside of root node », une balise de fermeture incorrecte avec « Unmatched closing tag », une racine scalaire avec « The JSON structure is invalid ». Le champ devient rouge et aucune sortie partielle n'est écrite. Tout s'exécute dans le navigateur, les fichiers ne sont jamais envoyés.

Outils associés
SponsorMindElixir