XML

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.

El proveedor de datos XML proporciona soporte para una amplia gama de codificaciones de caracteres, incluyendo unicode (UTF-8 y UTF-16).

Qué es XPath

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

Configuración de un origen de datos XML

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.

Nombre

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.

Origen

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.

Ruta de archivo

Muestra la ruta del archivo XML seleccionado.

Registro XPath

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.

Evaluar

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.

Ejemplos

Muestra una lista de expresiones XPath de ejemplo. Éstas se construyen a partir del análisis del archivo XML.

Campo XPath

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.

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.

Ejemplo de configuración XML

Utiliza este sencillo documento XML como ejemplo:

<?xml version="1.0" encoding="UTF-8"?>
<section name = "Digital Camera Accessories">
    <category name="Kodak">
        <product stockcode="320-387-1010">
            <fields>
                <description>DC260/265/290 Lens adaptor</description>
                <price>787.00</price>
            </fields>
        </product>
        <product stockcode="320-387-1020">
            <fields>
                <description>Sanp Server 1200 1</description>
                <price>28.50</price>
            </fields>
        </product>
    </category>
    <category name="Canon">
        <product stockcode="320-387-1030">
            <fields>
                <description>30 BJC-70/80 battery</description>
                <price>787.00</price>
            </fields>
        </product>
        <product stockcode="320-387-1040">
            <fields>
                <description>BJ30 AC Adpator</description>
                <price>28.50</price>
            </fields>
        </product>
    </category>
</section>

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:

/section/category/product

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:

/fields/price/text()

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:

../@name

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:

Actualización del Origen de Datos

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.

Edición del Origen de Datos

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.

Campos clave

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.