Conceptos clave para transformaciones en Jitterbit Studio

Esta página explica los conceptos fundamentales que debes entender al diseñar transformaciones y resolver problemas.

Esquemas

Un esquema define la estructura y los tipos de datos de tus datos de entrada o salida. Los esquemas especifican qué campos están disponibles, sus tipos de datos y cómo se organizan los campos:

Esquemas de origen

El esquema de origen describe la estructura de los datos que entran en tu transformación. Los esquemas de origen pueden provenir de estas fuentes:

• Esquemas generados por actividades: Se crean automáticamente mediante actividades de conectores como consultas de bases de datos o llamadas a API.

• Esquemas definidos por el usuario: Esquemas personalizados que creas o cargas.

Los esquemas de origen son opcionales. No necesitas un esquema de origen si solo utilizas variables, valores personalizados o lógica con scripts en tus asignaciones.

Para más información, consulta Elegir orígenes de esquema.

Esquemas de destino

El esquema de destino describe la estructura de los datos que salen de tu transformación. Al igual que los esquemas de origen, los esquemas de destino pueden ser generados por actividades o definidos por el usuario.

Los esquemas de destino siempre son obligatorios. Toda transformación debe tener un esquema de destino que defina la estructura de salida.

Para obtener orientación detallada sobre cómo crear y configurar esquemas, consulta Crear una transformación y configurar esquemas.

Estructuras de datos

Las estructuras de datos definen cómo se organiza la información dentro de los esquemas.

Estructuras planas

Las estructuras planas contienen campos en un único nivel sin anidamiento. Los ejemplos incluyen estos formatos:

• Archivos CSV con columnas
• Tablas de bases de datos individuales
• Archivos XML simples sin elementos anidados

<customer>
    <id>10123</id>
    <fullname>ABC Co.</fullname>
    <street>1 Main St.</street>
    <city>Anytown</city>
    <state>NY</state>
    <zip>12345</zip>
</customer>

Estructuras jerárquicas

Las estructuras jerárquicas contienen relaciones anidadas entre campos y registros. Los ejemplos incluyen estos formatos:

• Archivos XML complejos con elementos anidados
• Objetos JSON con propiedades anidadas
• Combinaciones de bases de datos en múltiples tablas

<customer>
    <id>10123</id>
    <name>ABC Co.</name>
    <addresses>
        <address>
            <street>1 Main St.</street>
            <city>Anytown</city>
            <state>NY</state>
            <zip>12345</zip>
        </address>
        <address>
            <street>1 Time Square</street>
            <city>New York City</city>
            <state>NY</state>
            <zip>54321</zip>
        </address>
    </addresses>
</customer>

Para más información sobre cómo trabajar con estructuras de datos, consulta Asignar datos.

Para escenarios de datos jerárquicos complejos, consulta Trabajar con datos jerárquicos.

Nodos y campos

Los esquemas se muestran como estructuras de árbol que contienen nodos y campos. Los nodos son contenedores que organizan campos en estructuras jerárquicas. Los campos contienen los valores de datos reales.

Cada nodo y campo muestra estos indicadores visuales:

• Clave de cardinalidad: Muestra las reglas de ocurrencia entre corchetes.
• Nombre: El identificador del elemento del esquema
• Tipo de datos: Solo para campos (cadena, entero, booleano, etc.)

• Indicadores de atributo/valor: Algunas estructuras XML incluyen símbolos adicionales:

  Símbolo	Significado
  @	Datos de atributo de elemento, por ejemplo @image
  #	Datos de texto de elemento, por ejemplo #text

Nodos

Los nodos son contenedores que organizan campos en estructuras jerárquicas:

• Símbolos de intercalación: Expanden y contraen nodos.
• Nombres en negrita: Indican nodos que contienen asignaciones cuando están contraídos.
• Expansión predeterminada: 8 niveles de profundidad para esquemas con menos de 750 nodos, 5 niveles de profundidad para esquemas de 750 a 5,000 nodos, y 2 niveles de profundidad para esquemas de 5,000 nodos o más. La expansión o contracción de un nodo más allá de este valor predeterminado se conserva cuando reabre la transformación.

No puedes asignar datos directamente a los nodos. En su lugar, asignas datos a los campos que contienen los nodos.

Campos

Los campos contienen los valores de datos reales y tienen estas propiedades:

• Nombre: El identificador del campo.
• Tipo de dato: El tipo de dato, como cadena, entero, booleano, fecha y otros.
• Formato: Formato opcional para fechas o moneda.

• Valores predeterminados: Cuando un esquema XSD o WSDL especifica un valor predeterminado para un elemento o atributo, el valor aparece junto al nombre del campo en la interfaz de transformación:

  

Notación de cardinalidad

Las claves de cardinalidad indican reglas de ocurrencia usando notación de estilo UML:

Asignaciones

Una asignación conecta datos de origen a campos de destino y define cómo se deben transformar los datos.

Tipos de asignaciones

• Asignaciones de campos directas: Conectan campos de origen directamente a campos de destino. Consulta Asignar campos manualmente.

• Asignaciones de valores personalizados: Asigna valores estáticos o expresiones. Consulta Usar valores personalizados.

• Asignaciones de variables: Referencia variables de proyecto o globales. Consulta Asignar variables.

• Asignaciones de scripts: Usa funciones y lógica para transformar datos. Consulta Asignación con scripts.

• Lógica condicional: Aplica lógica diferente según las condiciones. Consulta Lógica condicional.

Scripts de asignación

Todas las asignaciones se implementan como scripts en campos de destino. Incluso las asignaciones visuales como arrastrar y soltar crean scripts subyacentes. Puedes editar estos scripts directamente para transformaciones complejas.

Para la asignación automática de estructuras similares, consulta Asignar estructuras idénticas.

Nodos de bucle

Los nodos de bucle manejan datos repetidos, como múltiples registros o matrices. Cuando asignas campos dentro de nodos de bucle, la transformación procesa cada iteración de los datos.

Generación automática de bucles

Los nodos de bucle se generan automáticamente cuando asignas campos de datos de origen repetidos a estructuras de destino repetidas. Aparece una línea de iterador que muestra cómo la transformación recorrerá los datos.

Definición manual de bucles

Puedes definir manualmente nodos de bucle cuando la generación automática no coincide con tus necesidades de procesamiento de datos. Esto es útil cuando tienes múltiples niveles de datos repetidos y necesitas controlar qué nivel impulsa la iteración.

Para orientación completa sobre cómo trabajar con datos repetidos, consulta Controlar bucles de datos.

Variables

Las variables están diseñadas para pasar valores, configuraciones y pequeñas cantidades de datos entre diferentes componentes en tu integración. Las variables son útiles cuando necesitas compartir información como IDs de sesión, parámetros de configuración o valores calculados en scripts, transformaciones y operaciones. Estos tipos de variables están disponibles para usar:

Para ejemplos e información detallada sobre cada tipo de variable, consulta sus páginas de documentación individual.

Para ejemplos prácticos de uso de variables en transformaciones, consulta Asignar variables.

Flujo de datos

Los datos fluyen a través de transformaciones en esta secuencia:

1. Entrada: Una actividad de origen proporciona datos que coinciden con el esquema de origen.

2. Procesamiento: Una transformación aplica asignaciones, funciones y lógica empresarial.

3. Salida: Los datos transformados que coinciden con el esquema de destino van a la actividad de destino.

Comprender este flujo te ayuda a diseñar asignaciones que manejen los datos correctamente y a solucionar problemas cuando los datos no se transforman como se esperaba.

Para orientación sobre validación y solución de problemas, consulta Probar y validar transformaciones y Resolver conflictos y errores de asignación de transformaciones.