Cómo se crea un documento XML

3. Cómo se crea un documento XML

Para crear un documento XML, puedes utilizar cualquier editor de texto plano, por ejemplo el Bloc de notas de Windows o el editor Nano de Linux, o cualquier editor de código, como Visual Studio Code (Ver curso completo de Visual Studio Code).

3.1. Crear un documento XML en cualquier editor de texto plano

Sigue los siguiente pasos para crear un documento XML en cualquier editor de texto plano.

1. Abre el editor de texto de tu elección.
2. Crea un nuevo archivo.
3. Escribe la declaración XML al comienzo del archivo:

<?xml version="1.0" encoding="UTF-8"?>

Esta línea especifica la versión de XML que estás utilizando y la codificación de caracteres.

4. A continuación, puedes comenzar a definir los elementos, atributos y contenido de tu documento XML. Por ejemplo:

<?xml version="1.0" encoding="UTF-8"?>
<libros>
  <libro>
    <titulo>El Gran Gatsby</titulo>
    <autor>F. Scott Fitzgerald</autor>
    <anio>1925</anio>
  </libro>
</libros>

En este ejemplo, hemos creado un elemento raíz <libros> que contiene un elemento hijo <libro>. El elemento <libro> tiene elementos hijos como <titulo>, <autor> y <anio>, que representan los datos de un libro específico.

5. Guarda el archivo con una extensión .xml, por ejemplo, «mi_documento.xml».

Una vez que hayas creado el documento XML, puedes utilizarlo en aplicaciones, procesamiento de datos o intercambio de información según sea necesario.

3.2. Crear un documento XML en Visual Studio Code

Utilizar XML en Visual Studio Code (VS Code) es un proceso bastante sencillo y directo, ya que VS Code ofrece soporte básico para XML de forma predeterminada. Sin embargo, para una experiencia más rica y funcionalidades avanzadas, puedes instalar extensiones adicionales.

Abrir o crear un archivo XML:

• Para abrir un archivo XML existente, simplemente haz clic en Archivo -> Abrir Archivo y selecciona tu archivo XML.
• Para crear uno nuevo, abre VS Code, ve a Archivo -> Nuevo Archivo, y guarda el archivo con la extensión .xml.

Edición básica:

• Puedes escribir tu código XML como lo harías en cualquier editor de texto. Por ejemplo:

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <elemento>Valor</elemento>
</root>

Guardar el archivo:

• Guarda tus cambios con Ctrl + S (Windows/Linux) o Cmd + S (Mac).

Instalar una extensión:

Para una mejor experiencia trabajando con XML, puedes instalar extensiones en VS Code que proporcionan funcionalidades adicionales como formateo automático, validación, autocompletado, etc.

• Haz clic en el icono de extensiones en la barra lateral o presiona Ctrl+Shift+X.
• Busca extensiones relacionadas con XML, como XML Tools o XML Language Support by Red Hat.
• Elige la extensión que prefieras y haz clic en Instalar.
• Una vez instalada la extensión, abre un archivo XML y comienza a usar las características adicionales que ofrece, como formatos de documentos, sugerencias de código, etc.
• Por ejemplo, al instalar la extensión «XML de Red Hat» al iniciar la declaración de XML se puede seleccionar la abreviatura correspondiente para que VS Code complete el código, como se puede ver en la siguiente imagen.

Lo ideal es que instales tanto XML Tools como XML Language Support by Red Hat y que pruebes ambas herramientas.

3.3. Uso de la extensión XML Tools de Visual Studio Code

XML Tools es una extensión para Visual Studio Code que proporciona funcionalidades útiles para trabajar con archivos XML.

Para usar XML Tools en Visual Studio Code, sigue estos pasos:

1. Instalación de la Extensión:
   • Abre Visual Studio Code.
   • Ve a la vista de extensiones haciendo clic en el ícono de los cuadrados en la barra lateral o presiona Ctrl+Shift+X.
   • Busca «XML Tools» en el campo de búsqueda.
   • Haz clic en «Instalar» en la extensión XML Tools de Josh Johnson.
2. Uso de algunas funcionalidades:
   • Formatear XML: Abre un archivo XML y haz clic derecho en el editor. Selecciona «Format Document» o utiliza el atajo Shift+Alt+F. Esto formateará tu XML para que tenga una estructura y sangría adecuadas.
   • Minificar XML: Para minimizar tu archivo XML (eliminar espacios y sangrías innecesarias), usa la opción «Minify XML» del menú contextual (Para acceder al menú contextual, selecciona todo el código (Ctrl+A) y haz clic con el botón derecho del ratón sobre el área seleccionada).
   • Desminificar XML: Selecciona todo el código (Ctrl+A), haz clic derecho para abrir el menú contextual y elige la opción «Format selection». Esto reorganizará el XML con sangrías y saltos de línea adecuados, haciéndolo más legible.
3. Opciones de configuración:
   • XML Tools permite una cierta personalización a través de las opciones de configuración de VS Code. Puedes acceder a estas configuraciones abriendo la paleta de comandos (Ctrl+Shift+P) y buscando «Preferences: Open Settings (JSON)». De esta forma puedes configurar aspectos como la sangría o si se deben cerrar automáticamente las etiquetas, entre otros.
4. Validación y verificación de esquemas:
   • XML Tools puede validar tu archivo XML contra un esquema XML (XSD) si está definido. Esto te ayuda a asegurarte de que tu XML cumple con un estándar específico. Este tema lo veremos en el tutorial de XSD.

En la siguiente sección veremos los caracteres especiales en XML.

3.3. Ejercicio propuesto

Uso de Visual Studio Code y XML Tools

Creación de la Declaración XML:

• Abre VSCode.
• Crea un nuevo archivo y guárdalo con la extensión .xml.
• Escribe la declaración estándar seleccionando la abreviatura correspondiente.

<?xml version="1.0" encoding="UTF-8"?>

Creación de un Documento XML:

• Dentro del mismo archivo, crea un documento XML sencillo que represente una lista de elementos. Por ejemplo, una lista de libros con títulos y autores.
• Asegúrate de incluir un elemento raíz, elementos hijos y algunos atributos.
• Ejemplo de estructura:

<library>
  <book title="The Hobbit" author="J.R.R. Tolkien" />
  <book title="1984" author="George Orwell" />
  <!-- Añade más libros aquí -->
</library>

Uso de XML Tools:

• Instala la extensión XML Tools en VSCode.
• Utiliza las funciones de minificación y formateo que ofrece XML Tools.
• Para minificar usa la opción «Minify XML» del menú contextual (Para acceder al menú contextual, selecciona todo el código (Ctrl+A) y haz clic con el botón derecho del ratón sobre el área seleccionada).
• Después, utiliza la función de formateo para volver a dar formato al documento. Para ello, selecciona todo el código (Ctrl+A), haz clic derecho para abrir el menú contextual y elige la opción «Format selection». Esto reorganizará el XML con sangrías y saltos de línea adecuados, haciéndolo más legible.
• Observa los cambios en la estructura del documento después de minificar y formatear.
• Agrega un par de libros más con la misma estructura que los del ejemplo.

De momento, no sabemos hacer nada más con los documentos XML. Más adelante podrás hacer lo siguiente:

• Verificar que el documento XML esté bien formado y cumpla con las reglas básicas de la sintaxis XML.
• Comprobar que el documento sea válido según un DTD o esquema.