Modo de mapeo en transformaciones en Jitterbit Integration Studio

Introducción

El modo de mapeo ofrece una descripción general de un mapeo de transformación y las herramientas básicas para ejecutarlo. Consulte Modo de Secuencia de comandos para herramientas de mapeo avanzadas y elementos de modo común para elementos de la interfaz de usuario compartidos por múltiples modos de visualización.

Modo de mapeo de acceso

El modo de mapeo es el modo de visualización predeterminado al abrir una transformación para su configuración.

En el modo de mapeo, el lado izquierdo contiene la estructura de origen y las variables disponibles para ser utilizadas dentro del mapeo de la estructura de destino en el lado derecho:

Al acceder a una transformación que abrió previamente, Integration Studio se desplaza automáticamente a la ubicación en el esquema al que accedió por última vez.

Para volver al modo de mapeo mientras está en modo de secuencia de comandos, haz clic en la flecha a la izquierda de la pantalla:

Esquemas de origen y destino

En el modo de mapeo, el lado izquierdo de la transformación muestra el esquema de origen, mientras que el lado derecho muestra el esquema de destino. Estos esquemas pueden definirse en una actividad que se encuentra adyacente a la transformación, o directamente en una transformación. Si aún no se ha especificado un esquema, se le presentan las siguientes opciones para el lado de origen o de destino, respectivamente.

No se especificó ninguna fuente

No es necesario especificar un esquema de origen (consulte Uso del esquema). Si no desea que se utilice un esquema de origen, no necesita hacer nada con el lado de origen de la transformación.

Si no ha especificado un esquema de origen y desea especificar uno, puede regresar al flujo de trabajo para proporcionar un esquema en una actividad ubicado adyacente a la transformación, o seleccione una de estas opciones:

• Usar variables: Esto cambia a la pestaña Variables, donde puede agregar variables como se describe en Asignación de variables.
• Definir esquema: Proporciona un menú adicional de opciones, incluyendo Crear plano, Crear jerárquico y Usar archivo de muestra. Al seleccionar una opción, se abre el plano o jerárquico editor de esquema personalizado o una interfaz para proporcionar un archivo de muestra como se describe en Esquemas.
• Esquema de destino reflejado: Copia el esquema de destino como se describe en Esquemas. Esta opción solo está presente si (1) hay un esquema de destino especificado y (2) la fuente de la transformación no es una actividad adyacente con un esquema generado por el conector.

No hay objetivo especificado

Se debe especificar un esquema de destino antes de poder configurar una asignación de transformación (consulte Uso del esquema).

Si no ha especificado un esquema de destino, puede regresar al flujo de trabajo para proporcionar un esquema en una actividad ubicado adyacente a la transformación, o seleccione una de estas opciones:

Definir esquema: Esto proporciona un menú adicional de opciones, incluyendo Crear plano, Crear jerárquico y Usar archivo de muestra. Al seleccionar una opción, se abre el plano o jerárquico editor de esquema personalizado o una interfaz para proporcionar un archivo de muestra como se describe en Esquemas. - Esquema de origen reflejado: Copia el esquema de origen como se describe en Esquemas. Esta opción solo está presente si (1) hay un esquema de origen especificado y (2) el objetivo de la transformación no es una actividad adyacente con un esquema generado por el conector.

Nodos de destino

Un esquema de destino específico se compone de nodos que contienen campos o nodos secundarios (que pueden contener campos y nodos secundarios adicionales). Los datos de origen no se pueden asignar a los propios nodos de destino, sino solo a los campos que contienen. Una vez especificado un esquema de destino, pase el cursor sobre el nodo de destino para acceder a las opciones disponibles en cada nodo y haga clic en el botón Icono del menú de acciones. A continuación se describe cada acción posible.

Elemento del menú	Descripción
	Eliminar nodo de bucle elimina la definición de nodo de bucle. Esta acción solo está disponible en nodos que tienen un nodo de bucle definido manualmente. Nota Si elimina todas las asignaciones directas de hojas de un nodo de bucle definido manualmente, la definición del nodo de bucle aún existe.
	Eliminar nodo de bucle y asignaciones elimina la definición de nodo de bucle debido a asignaciones que son hojas secundarias directas asociadas con el nodo de bucle, y elimina esas asignaciones. Cualquier otra asignación dentro de los nodos de bucle secundarios debajo del nodo de bucle principal se conserva, y el nodo conserva su definición de nodo de bucle si se asigna al menos un nieto. Esta acción solo está disponible en nodos que tienen un nodo de bucle definido (ya sea manualmente o por generación automática).
	Eliminar todas las asignaciones debajo de este nodo elimina todas las asignaciones de los campos contenidos en el nodo, así como todas las asignaciones de los campos contenidos en los nodos secundarios de ese nodo. Al usar esta acción en un nodo raíz, se eliminan todas las asignaciones de una transformación. Al seleccionar esta acción, un mensaje le pedirá que confirme que desea eliminar las asignaciones.
	Eliminar todas las asignaciones no válidas elimina todas las asignaciones no válidas en los campos contenidos dentro del nodo, así como todas las asignaciones no válidas en los campos contenidos dentro de los nodos secundarios de ese nodo. Para obtener más información sobre las asignaciones no válidas, consulte Validez de la asignación de Transformación.
	Expandir todos los nodos debajo de este nodo expande todos los nodos secundarios debajo del nodo principal. (De manera predeterminada, los nodos se expanden hasta 8 niveles de profundidad para esquemas con 750 nodos o menos y hasta 5 niveles de profundidad para esquemas con más de 750 nodos).
	Duplicar nodo duplica el nodo y sus campos, así como cualquier nodo secundario y sus campos. Las asignaciones no se duplican. Esta acción está disponible en nodos raíz en esquemas planos y en nodos cuya cardinalidad(/es/integration-studio/design/transformations/basics/nodes-and-fields#nodesandfields-cardinalitykey) indica que los elementos pueden aparecer más de una vez. El nodo no debe ser un duplicado de otro. Solo para fines de visualización en tiempo de diseño, el nombre del nodo duplicado se añade con un numeral.y un número incrementado. Por ejemplo, al duplicar un nodo llamado transaction, el primer duplicado del nodo se muestra como transaction#1. Si luego duplicas el transaction nodo nuevamente, el segundo duplicado se muestra como transaction#2 Durante la tiempo de ejecución, el nombre del nodo original se utiliza tanto para el nodo original como para los nodos duplicados. Por ejemplo, los nodos mostrados como transaction, transaction#1, y transaction#2 se procesan cada uno con el nombre del nodo original transaction Los nodos duplicados no se pueden renombrar. Que un nodo duplicado se refleje en otras ubicaciones del proyecto depende de cómo se definió el esquema : Definido en una actividad: Si el esquema en el que está duplicado el nodo está definido en una actividad, el nodo duplicado se refleja en el esquema de la actividad. Si el esquema de la actividad sufre cambios posteriormente como resultado de una modificación en la configuración de la actividad o una actualización del esquema desde el extremo, la conservación de los nodos duplicados depende de si el nodo original duplicado aún existe: Si el nodo original existe, se conservan los nodos previamente duplicados. Si el nodo original ya no existe, se eliminan todos los nodos creados como duplicados de ese nodo. Definido en una Transformación: Si el esquema en el que se duplica el nodo está definido en una transformación, entonces el nodo duplicado no se refleja en el esquema de la actividad, ya que el esquema de la actividad no es parte de la transformación.
	Eliminar nodo duplicado elimina el nodo duplicado y sus campos, así como cualquier nodo secundario duplicado y sus campos. Esta acción solo está disponible en nodos que se crearon utilizando Nodo duplicado.
	Cambiar nombre de nodo duplicado permite cambiar el nombre de un nodo de destino duplicado. El nuevo nombre solo se muestra durante el diseño. En tiempo de ejecución, el nombre original del nodo duplicado (el nombre del nodo con un numeral añadido) (#)y se utiliza un número incrementado). Esta acción solo está disponible en nodos que se crearon utilizando Nodo duplicado.
	Añadir condición a nodo se utiliza para aplicar condicionalmente una asignación a los campos contenidos en un nodo. Esta acción solo está disponible en nodos que aún no tienen una condición aplicada. Al seleccionar esta acción, se abre el modo secuencia de comandos para crear la condición. Para más detalles sobre cómo crear la condición, consulte Asignación condicional.
	Editar condición abre el modo secuencia de comandos para editar la condición existente en secuencia de comandos modo. Esta acción solo está disponible en nodos que ya tienen una condición aplicada. Para más detalles, consulte Mapeo condicional.
	Eliminar condición elimina la condición. Esta acción solo está disponible en nodos que ya tienen una condición aplicada.

Campos objetivo

Para que una transformación genere datos de salida, debe asignarse a al menos un campo del esquema de transformación. Una vez especificado el esquema de destino, puede asignarse a los campos de destino de cualquiera de las maneras que se describen a continuación, incluyendo la asignación de objetos de origen, variables, secuencias de comandos o valores personalizados a los campos de destino, o la adición de otra lógica de secuencia de comandos.

• Mapeo automático
  El mapeo automático se utiliza para mapear automáticamente los campos de origen y destino cuyos nombres coinciden exactamente dentro de estructuras de datos idénticas. Puede realizar el mapeo automático utilizando toda la estructura de datos o dentro de los nodos de origen y destino seleccionados.
• Mapeo de objetos de origen
  Además de la asignación automática, los campos de origen se pueden asignar manualmente a un campo de destino. Al asignar un campo de origen a un campo de destino, la ruta de referencia del objeto de origen se inserta en un secuencia de comandos en el campo de destino.
• Variables de mapeo
  Al asignar una variable, la referencia de la variable se inserta en un secuencia de comandos en el campo de destino. Las referencias de variable se construyen con un signo de dólar ($) antes del nombre de la variable.
• Asignación de valores personalizados
  Los valores personalizados son valores (incluidos los valores codificados) y expresiones que se pueden asignar a un campo de destino.
• Mapeo con secuencias de comandos
  Todas las asignaciones de transformación se componen de secuencias de comandos en nodos y campos individuales dentro de un esquema de destino. Esta página explica cómo abrir secuencias de comandos de transformación y hacer referencia a componentes y funciones del proyecto dentro de ellos, aunque se puede usar cualquier lógica de secuencia de comandos válida.

Indicadores visuales de campos mapeados

Al ver objetos mapeados dentro de las pestañas Fuente o Variables, un número entre paréntesis y el color naranja indican la cantidad de veces que se hace referencia a cada objeto en el lado de destino de la transformación.

Además, al pasar el cursor sobre un objeto de origen, aparecen líneas que conectan el campo de origen con cualquier campo de destino al que esté asignado o con los nodos a los que esté referenciado. Haga clic directamente en el número para mostrar los campos o nodos de destino referenciados y haga clic para desplazarse automáticamente al objeto o nodo en la estructura de destino.

Al visualizar objetos mapeados dentro de la estructura Objetivo, al pasar el cursor sobre el campo, aparece una línea que conecta el campo de destino mapeado con sus orígenes en las pestañas Origen o Variables, si corresponde. Haga clic en el objeto de origen mapeado para acceder automáticamente a él en la pestaña.

Al hacer clic en el nombre de un objeto de destino asignado, este se contrae, de modo que sus objetos asignados no son visibles.

Si un nodo contraído contiene asignaciones de campos de destino, dicho nodo se muestra en negrita para indicar que contiene asignaciones:

Editar o eliminar una asignación

Puede editar o eliminar las asignaciones de campos de destino una a una o eliminar todas las asignaciones de campos contenidas en un nodo.

Editar o eliminar una asignación de campo único

Al pasar el cursor sobre un campo objetivo mapeado (indicado con una línea vertical morada y un... icono de secuencia de comandos en el bloque del campo), estas opciones estarán disponibles:

• Editar: Abre el editor de secuencia de comandos para el campo.

• Eliminar asignación: Elimina la asignación del campo.

Eliminar asignaciones de campos múltiples

Para las asignaciones en esquemas jerárquicos, las opciones para eliminar asignaciones de campos de destino múltiples están disponibles dentro del menú de acciones de un nodo (descrito anteriormente en Nodos de destino)