Procesamiento de Esquemas¶

Introducción¶

Cuando se utiliza un esquema definido por el usuario, en determinadas circunstancias los datos pueden convertirse durante el procesamiento. Esta página describe cuándo y cómo se convierten los datos.

Nombres de Campos y Nodos¶

Los nombres de campos y nodos se convierten a espacios de nombres válidos siguiendo el estándar XML. Como referencia, consulte NCNameChar para los caracteres permitidos según lo definido por el W3C.

Nombres con Espacios¶

Los espacios incluidos como parte de un campo o nombre de nodo se reemplazan con un guión bajo (_).

Caracteres Especiales en Esquemas¶

Los caracteres especiales en los esquemas definidos por el usuario se procesan de forma diferente según el tipo de esquema. Estas conversiones se limitan únicamente a las estructuras del esquema y no afectan los datos reales.

El manejo de caracteres especiales depende del tipo de esquema, como se describe en la siguiente tabla. Los caracteres especiales incluyen, entre otros, estos caracteres no alfanuméricos:

. _ - $ # @ ?

La compatibilidad con caracteres especiales de Cloud Studio está limitada por la compatibilidad con caracteres especiales del propio tipo de esquema. Por ejemplo, incluyendo un $, #, @, o ? en un campo de esquema XML o nombre de nodo no se admite porque XML no admite esos caracteres especiales.

Al duplicar un esquema proporcionado por una base de datos, cualquier carácter especial en un campo de esquema o nombre de nodo se reemplaza por guiones bajos según sea necesario para crear un esquema XML válido.

Manejo de caracteres especiales en esquemas	Personalizado Plano o Jerárquico Esquema	Esquema CSV cargado	Esquema JSON cargado	Esquema XML cargado
Los caracteres especiales en el lado de origen o de destino de una transformación se conservan tal cual
Los caracteres especiales en el lado de origen o de destino de una transformación se reemplazan por un signo de interrogación (`?`)
Los caracteres especiales en el lado de origen o de destino de una transformación se reemplazan por un guión bajo (`_`)
Los caracteres especiales en una secuencia de comandos de comandos en un campo de destino en una transformación se reemplazan por un signo de interrogación (`?`)

Archivos CSV con Encabezados¶

Si se proporciona un archivo CSV con una fila de encabezado como archivo de esquema de muestra, se aplican estas reglas para generar nombres de columnas:

Los caracteres especiales se reemplazan por un signo de interrogación (?).
Los espacios se reemplazan con un guión bajo (_).
Si el nombre de una columna está en blanco, se reemplaza con f1, f2, f3, etcétera.
Si el nombre de una columna comienza con un número, tiene como prefijo un guión bajo (_).
Si el nombre de una columna se repite, se le añade 2, 3, 4, etcétera.

Tipos de Datos¶

Estas secciones describen el soporte de Jitterbit para ciertos tipos de datos. Para conocer todos los tipos de datos admitidos en Jitterbit Secuencias de Comandos, consulte Tipos de datos en Jitterbit Script.

Tipos de Datos de Precisión Ilimitada¶

Los tipos de datos de precisión ilimitada, como XML decimal, se convierten en tipos de datos dobles y, por lo tanto, se les impone un límite de precisión que, como resultado, podría truncar los datos.

El límite de precisión está dentro del rango de los valores mínimo y máximo de una longitud con signo, que es de –2.147.483.648 a 2.147.483.647. Si está fuera de este rango, considere usar un tipo de datos de cadena para evitar truncar datos.

Tipos de Datos No Primitivos¶

Los tipos de datos primitivos boolean, date, double, float, integer, long, y string y el tipo de datos no primitivo decimal son compatibles con todos los tipos de esquema. Al crear o editar un plano personalizado o jerárquico esquema o editar cualquier esquema cargado en una transformación, estos tipos de datos están disponibles para elegir en el menú desplegable Tipo. Para nuevos esquemas personalizados, otros tipos de datos no primitivos como datetime no son compatibles.

Sin embargo, se admiten otros tipos de datos no primitivos para esquemas que se generan automáticamente a partir de un esquema generado por conector o fueron reflejados a partir de dicho esquema. Una vez generados, dichos esquemas también se pueden editar manualmente en el editor de esquema personalizado. Si el esquema contiene tipos de datos no primitivos, estos también se enumeran en el menú desplegable Tipo al editar dicho esquema.

Valores Nulos¶

Los campos que tienen un valor nulo se incluyen en el esquema de datos resultante a pesar de no tener datos. Como tampoco tienen un tipo de datos definido, estos campos se tratan como si tuvieran un tipo de datos de cadena.

Espacios de Nombres de Esquema XML¶

Se admiten espacios de nombres en esquemas XML. Si se utiliza más de un espacio de nombres en un esquema XML, Harmony Agente convierte el esquema XML en varios archivos XSD durante el procesamiento.

Solución de Problemas¶

Debido a cambios realizados en las versiones de Harmony 10.25 y 10.27, es posible que observe un comportamiento diferente en los proyectos creados antes de estos lanzamientos. Estos cambios afectan a los esquemas XML que han sido reflejados y es más probable que afecten las asignaciones que utilizan funciones XML que involucran espacios de nombres, como el SelectNodes función. En este caso, las asignaciones que antes eran válidas ahora pueden no serlo debido a un error relacionado con la sintaxis de la función XML.

Compare las diferencias entre este ejemplo de esquema XML reflejado anterior a 10.25 con uno creado en 10.25 o posterior:

esquema xml anotado

Ejemplo de esquema XML anterior a 10.25: En proyectos creados antes de 10.25, los esquemas XML reflejados utilizan el prefijo de espacio de nombres predeterminado para documentos XML: xsi. Como se muestra resaltado en rojo arriba, xmlns:xsi declara el espacio de nombres y los campos no asignados se muestran en el esquema con el atributo xsi:nil="true".
Esquema XML de ejemplo en 10.25 y posteriores: En proyectos creados en 10.25 y posteriores y resaltados en verde arriba, los esquemas XML reflejados utilizan el prefijo de espacio de nombres. ns para declarar un espacio de nombres calificado. Los campos no asignados no se muestran en el esquema.

En las versiones 10.25 y 10.26, si importó un proyecto con un esquema XML reflejado que se creó antes de la versión 10.25, el esquema se reprocesó y se cambió para usar el prefijo de espacio de nombres calificado.

A partir de la versión 10.27, los proyectos importados cuyos esquemas XML reflejados se crearon antes de la 10.25 conservan el prefijo de espacio de nombres del esquema XML predeterminado para que el esquema sea idéntico al que se creó. Este cambio significa que cualquier proyecto anterior a 10.25 que se importe a la versión actual debería funcionar como se diseñó originalmente.

Para forzar una actualización de un esquema XML anterior a 10.25 para usar el prefijo de espacio de nombres actualizado, puede regenerar el esquema actualizándolo o reconfigurando la actividad que proporciona el esquema.

Etiquetas de Cierre Automático de Esquema XML¶

Las etiquetas de cierre automático en elementos de esquemas XML se admiten con cierta manipulación del XML de muestra utilizado para generar el esquema. Para enviar el elemento XML en la carga útil sin un valor asignado, puede utilizar una función Jitterbit y una variable Jitterbit como se describe a continuación.

Manipular el XML de Muestra¶

Se requiere manipulación cuando un archivo de muestra XML utiliza notación abreviada para una etiqueta de apertura y cierre en un elemento como este:

<tag/>

Si dicha abreviatura se utiliza directamente en un esquema XML, no se podrá asignar el nodo cuando se utilice como esquema de destino de una transformación.

Para resolverlo, manipule el XML de muestra que se utiliza para generar el esquema para expandir las etiquetas de apertura y cierre que rodean el elemento y proporcione un valor de muestra para que se asigne un tipo de datos al elemento:

<tag>example</tag>

Luego, el elemento aparecerá como un campo en el esquema XML y, cuando se utilice como esquema de destino en una transformación, podrá asignarlo a ese campo.

Asignar al Campo XML¶

Si no tiene un objeto o variable de origen para asignar al campo de destino, puede colocar la función Jitterbit Null en el secuencia de comandos de transformación para utilizarlo como valor asignado:

<trans>
Null()
</trans>

Antes de la transformación utilizando el esquema XML, configure una de estas variables Jitterbit (según cuál sea apropiada para su caso de uso) para controlar lo que se envía:

XML vacío: Para enviar un nodo XML vacío en la carga útil, use jitterbit.target.xml.include_empty_xml:
```
$jitterbit.target.xml.include_empty_xml=true;
```
XML nulo: Para enviar un valor nulo en la carga útil XML, utilice jitterbit.target.xml.include_null_xml:
```
$jitterbit.target.xml.include_null_xml=true;
```
Excluir XML vacío: Para excluir un nodo XML vacío con un tipo de datos booleano, utilice jitterbit.target.xml.exclude_empty_data:
```
$jitterbit.target.xml.exclude_empty_data=true;
```