XML
XML (Extensible Markup Language) es una iniciativa de la W3C que permite codificar la información en una estructura que pueden interpretar tanto las personas como los ordenadores
Última actualización
XML (Extensible Markup Language) es una iniciativa de la W3C que permite codificar la información en una estructura que pueden interpretar tanto las personas como los ordenadores
Última actualización
El Proveedores de Datos XML es un módulo opcional para EasyCatalog que permite utilizar un archivo en formato XML como Origen de Datos. Al igual que el resto de proveedores de datos de EasyCatalog, el enlace que se establece es bidireccional, lo que permite que los cambios en los datos realizados en InDesign se actualicen de vuelta en el archivo XML de origen.
El Proveedores de Datos XML permite a EasyCatalog importar la información de los registros directamente desde un archivo XML. Trabajar con orígenes de datos XML es similar a hacerlo con archivos delimitados, aunque, eso sí, para ello deberás configurarlo correctamente usando expresiones XPath.
Las expresiones XPath se utilizan para identificar la ubicación de los registros y campos en un archivo XML.
El proveedor de datos XML proporciona soporte para una amplia gama de codificaciones de caracteres, incluyendo unicode (UTF-8 y UTF-16).
XPath es un lenguaje que permite extraer la información de un documento XML. El proveedor de datos XML lo utiliza para navegar a través de elementos y atributos del documento XML.
XPath utiliza expresiones de ruta para seleccionar los nodos o conjuntos de nodos del documento XML. Éstas se parecen mucho a las expresiones utilizadas en la línea de comandos de tu sistema operativo para navegar por el sistema de archivos.
Además de poder encontrar e identificar nodos, XPath también incluye una serie de funciones adicionales que permiten, por ejemplo, la comparación de los valores de un nodo, etc. El resto de este manual asume un conocimiento mínimo de XPath. Para obtener más información, consulta la referencia completa del idioma, que encontrarás en la siguiente dirección Web: https://www.w3.org/TR/xpath
Configurar un origen de datos XML es una tarea relativamente sencilla que, básicamente, consiste en especificar los valores correctos de las diferentes opciones del cuadro de diálogo Configuración del Origen de datos XML.
Al igual que con los demás Orígenes de Datos de EasyCatalog, el nombre del Origen de Datos XML debe ser único, puesto que se utilizará para identificarlo de manera inequívoca. El nombre que escribas aquí aparecerá en el menú Archivo→Nuevo→panel EasyCatalog.
Aquí se muestra la ruta del archivo XML. Este es el archivo que se leerá cuando se cree el Origen de Datos y durante cualquier operación de sincronización posterior.
Muestra la ruta del archivo XML seleccionado.
El Proveedor de Datos XML necesita una expresión XPath para identificar la ubicación de los nodos que definen cada registro en el documento XML. EasyCatalog confecciona automáticamente una lista de expresiones XPath válidas basadas en el contenido del archivo XML. Para utilizar alguna de estas expresiones, selecciónala en el menú desplegableEjemplos.
Evalúa la expresión introducida en el campo Registro XPath y muestra el número de registros encontrados en el archivo XML. Para comprobar si has introducido la expresión XPath correcta, utiliza el botónEvaluar; EasyCatalog te mostrará los registros que ha encontrado y que se importarán en el panel.
Muestra una lista de expresiones XPath de ejemplo. Éstas se construyen a partir del análisis del archivo XML.
Esta área del cuadro de diálogo muestra los campos que ya has configurado. Debes configurar una expresión XPath para cada uno de los campos que desees importar desde el nodo registro. Crea un nuevo campo haciendo clic en el botón ‘Nuevo’ de la parte inferior del cuadro de diálogo:
El Nombre del origen del campo se utilizará como nombre del campo en EasyCatalog.
Escribe la ruta XPath del contenido del campo en el apartado Ruta. Dicha ruta es relativa al registro XPath configurado en el paso anterior.
Utiliza el menú desplegable Ejemplos para mostrar una lista de expresiones XPath de ejemplo.
Utiliza el cuadro de verificación Clave para seleccionar el campo clave del origen de datos.
La elección del campo Clave es fundamental para el correcto funcionamiento de EasyCatalog. El campo clave se utiliza para identificar de forma única cada registro del origen de datos, y nunca debe cambiar.
EasyCatalog puede importar en un campo fragmentos XML directamente desde el origen de datos. Para ello, debes marcar el cuadro de verificación Cargar como fragmento XML en el cuadro de diálogo Configuración de campo. Cuando marcas esta opción, se cargará toda la estructura XML de la ruta especificada en el campo. Puedes procesar el código XML posteriormente mediante el modo "Complejo" del cuadro de diálogo Opciones de Tabla, o bien con funciones específicas en un campo personalizado.
Utiliza este sencillo documento XML como ejemplo:
En el ejemplo anterior, el nodo de producto contiene los datos de cada registro. La ruta XPath para un registro sería, por lo tanto:
Si pulsas el botón Evaluar se reportarán cuatro instancias de estos nodos en el documento XML. Esto indica que, cuando acabes la configuración del origen de datos, EasyCatalog detectará cuatro registros en esta estructura XML.
Cuando hayas configurado correctamente la ruta XPath para cada uno de los registros, deberás indicar el resto de rutas XPath para los campos que quieras importar a EasyCatalog. En este ejemplo, vamos a importar cinco campos: algunos están directamente contenidos en el nodo de registro, pero otros, como el nombre de categoría y el nombre de sección, deben recuperarse a partir del nodo padre del registro .
Las rutas XPath de los campos son relativas a la del registro. Así, por ejemplo, para recuperar el contenido del nodo Price, deberemos usar la siguiente ruta XPath:
Para recuperar el contenido de un nodo padre, como el nombre de la categoría del producto, utiliza .. para hacer referencia a los nodos y atributos superiores en la jerarquía XML:
La ruta anterior indica el atributo name del nodo padre del nodo del registro.
Para recuperar el contenido del resto de nodos y atributos, deberás utilizar las siguientes expresiones XPath:
Del mismo modo que EasyCatalog puede actualizar Orígenes de Datos de tipo archivo, también puede hacerlo con Orígenes de Datos de tipo XML. Cada vez que se crea o sincroniza el Origen de Datos, se almacena una instantánea del archivo XML, por lo que EasyCatalog solo necesitará actualizar aquellos nodos que hayan cambiado. Esto significa que se conservará cualquier información adicional en el XML que EasyCatalog no utilice.
La configuración de un origen de datos XML se puede modificar posteriormente utilizando el cuadro de diálogo Información. Haz clic en el botón Info de la parte inferior del panel de datos de EasyCatalog, y pulsa Configurar... para editar la configuración del origen de datos.
Una vez que se ha configurado un Origen de Datos XML, solo se puede modificar el atributo XPath de los campos clave. Los campos clave no se pueden renombrar o eliminar una vez configurado el panel. De esta forma impedimos que se rompa la relación de los vínculos del documento con su Origen de Datos.
| Campo | XPath | Descripción |
|---|---|---|
Stock Code
@stockcode
Contenido del atributostockcode
Categoría
../@name
Atributo name del nodo padre
Sección
../../@name
Atributo name del nodo abuelo section
Descripción
/fields/desciption/text()
Contenido textual del nodo description
Precio
/fields/price/text()
Contenido textual del nodo price
