XML a JSON: por qué cambian los arrays y los atributos

Cuando conviertes un array de JSON a XML, no aparece una etiqueta nueva que envuelva el array: la estructura pasa a ser la de etiquetas con el mismo nombre repetidas tal cual, tantas veces como elementos haya. A la inversa, cuando los atributos de XML pasan a JSON no se mezclan con los demás valores, sino que se meten bajo una clave aparte, como @attributes. Ninguna de las dos cosas es un error: son el resultado de que la forma de la información que XML y JSON pueden contener es distinta de entrada.
Resumen ① Un array de JSON se convierte en una estructura donde las etiquetas con el mismo nombre se repiten tantas veces como elementos haya, sin ninguna etiqueta que las envuelva, porque en XML no existe el concepto de array. ② Un elemento XML puede tener a la vez atributos, elementos hijos y texto, pero un objeto JSON no distingue esas tres cosas, así que el conversor separa los atributos en una clave aparte, como @attributes. ③ Esta forma de representarlo no es una regla fijada por los estándares de XML y JSON, sino una convención que decide el conversor, así que con otra herramienta la forma del JSON resultante puede variar un poco.
El problema
Cuando conviertes a JSON datos que llegan en XML para usarlos en tu código, te atascas en dos puntos. Uno es «si hay varias etiquetas con el mismo nombre es un array, entonces por qué cuando hay una sola no sale un array, sino un único objeto». El otro es «por qué un valor de atributo como category="cooking" no aparece al mismo nivel que otros campos como title o author, sino dentro de una clave que no conoces, @attributes».
En la dirección contraria pasa lo mismo. Cuando tienes que exportar datos de un array de JSON a un formato XML y ves por primera vez que no aparece una etiqueta que envuelva el array, sino solo etiquetas con el mismo nombre repetidas tantas veces como elementos haya, te quedas pensando si la estructura del array no habrá desaparecido.
En los dos casos no es un resultado mal generado por el conversor, sino una consecuencia inevitable de que XML y JSON pueden expresar la información de formas distintas.
La solución
Si ordenas las dos direcciones en forma de reglas, puedes anticipar la forma del resultado incluso sin herramienta.
Array de JSON → XML: por qué se repiten las etiquetas
En XML no existe un tipo de dato array. Lo que hay son «elementos», y un elemento puede aparecer varias veces seguidas con el mismo nombre. Así que al pasar "book": [ {...}, {...} ] de JSON a XML, en lugar de crear una etiqueta nueva que envuelva el array se usa el método de repetir la etiqueta <book> tantas veces como elementos haya dentro. Con 2 elementos, <book> aparece 2 veces; con 5, 5 veces.
Atributos XML → JSON: por qué se separan en @attributes
Un solo elemento XML puede tener a la vez tres cosas: atributos (por ejemplo, category="cooking"), elementos hijos (por ejemplo, <title>) y texto (los caracteres que van entre las etiquetas). En cambio, un objeto JSON solo tiene pares clave-valor y no cuenta con una sintaxis que distinga «si este valor es un atributo o un elemento hijo». Para que esa distinción no se pierda, el conversor agrupa los atributos bajo una clave aparte llamada @attributes, de modo que no se mezclen con los elementos hijos ni con el texto. Si un elemento tiene atributos y texto a la vez, el texto se guarda aparte en otra clave llamada #text.
Si no hay atributos ni elementos hijos, el texto tal cual
Al contrario, si un elemento solo tiene texto, sin atributos ni elementos hijos (por ejemplo, <author>Giada De Laurentiis</author>), no se envuelve en un objeto: se devuelve ese valor directamente como texto. Esa es la razón por la que ves algo tan simple como {"author": "Giada De Laurentiis"}.
Si el JSON tiene varias claves en el nivel superior, se crea automáticamente una etiqueta que las envuelve
En XML tiene que haber exactamente un elemento raíz. Por eso, si el JSON que conviertes tiene una sola clave en el nivel superior, se usa ese nombre de clave tal cual como etiqueta raíz; pero si tiene dos o más claves, no hay ninguna etiqueta que las envuelva, así que el conversor crea por su cuenta una etiqueta llamada <root> y mete dentro todas las claves como hijas.
Con estas cuatro reglas ya puedes explicar la mayoría de las veces por qué la estructura resultante sale así al ir de XML a JSON y de JSON a XML. Compruébalo tú mismo con ejemplos reales en nuestra herramienta.
Pega tu XML y lo verás al instante en JSON, o pega tu JSON y lo obtendrás en XML: la conversión funciona en ambos sentidos.

Puntos donde sueles atascarte
| Situación | Motivo |
|---|---|
| Un hijo con el mismo nombre aparece una sola vez y sale como objeto, no como array | La regla es que se pasa a array a partir de la segunda vez que aparece el mismo nombre, así que tu código puede comportarse de forma distinta según si hay 1 elemento o 2 o más |
| Un valor que parece numérico sale como texto entre comillas | El texto de XML no tiene concepto de tipo, así que valores como 2005 o 30.00 también se convierten a texto |
| Atributos, elementos hijos y texto mezclados en una misma etiqueta | Los atributos van a @attributes, los elementos hijos a la clave con el nombre de su etiqueta y el texto restante a la clave #text |
| Varias claves en el nivel superior del JSON | Como no hay ninguna etiqueta que las envuelva, el conversor crea automáticamente una etiqueta llamada root y envuelve todo con ella |
| Un valor null en el JSON | Se convierte en una etiqueta autocerrada sin contenido (<tag/>) |
En resumen
- Un array de JSON se convierte en una estructura donde las etiquetas con el mismo nombre se repiten tantas veces como elementos haya, sin ninguna etiqueta que las envuelva, porque en XML no existe el concepto de array.
- Un elemento XML puede tener a la vez atributos, elementos hijos y texto, pero un objeto JSON no hace esa distinción, así que el conversor separa los atributos en @attributes y el texto restante en #text.
- Un elemento que solo tiene texto, sin atributos ni elementos hijos, no se envuelve en un objeto: sale directamente como valor de texto.
- En XML tiene que haber un único elemento raíz, así que si el JSON tiene varias claves en el nivel superior, el conversor crea automáticamente una etiqueta root que las envuelve.
- Esta forma de representarlo no es una regla fijada por los estándares de XML y JSON, sino una convención del conversor, así que si conviertes con otra herramienta los nombres de las claves pueden salir distintos.
Pega tu XML y lo verás al instante en JSON, o pega tu JSON y lo obtendrás en XML: la conversión funciona en ambos sentidos.
Preguntas frecuentes
¿Se puede hacer que salga como array aunque solo haya un elemento hijo?
Esta regla de conversión pasa a array a partir de la segunda vez que aparece un elemento con el mismo nombre, así que si solo hay un elemento sale únicamente como un objeto. Si quieres tratarlo siempre como array, sin importar el número de elementos, tienes que añadir tú mismo en tu código, después de recibir el JSON convertido, un paso que envuelva el valor en un array cuando no lo sea.
¿Los nombres @attributes y #text son un estándar fijado?
Entre XML y JSON no existe un estándar oficial que obligue a usar estos nombres. @attributes y #text son la notación que ha adoptado este conversor para distinguir atributos y texto de los demás valores, y otras bibliotecas o herramientas usan otros enfoques, como poner una @ delante del nombre del atributo. Por eso, cuando pases el JSON convertido a otro sistema, lo más seguro es comprobar antes si el otro lado usa la misma notación.
Al convertir JSON a XML, ¿puedo elegir el nombre de la etiqueta raíz?
Si el JSON tiene exactamente una clave en el nivel superior, ese nombre de clave se convierte tal cual en la etiqueta raíz, así que basta con fijar de antemano el nombre que quieras como esa clave. Si hay varias claves en el nivel superior no hay etiqueta que las envuelva y se pone automáticamente el nombre root, así que para usar el nombre que quieras tienes que envolver antes el JSON en la forma { "nombreQueQuieras": { ...resto de claves } }.
Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano