Variables de Mapeo¶

Introducción¶

Las variables se pueden asignar a un campo de destino en modo de asignación o modo secuencia de comandos. Cuando asigna una variable, la referencia de la variable se inserta en un secuencia de comandos en el campo de destino. Las referencias variables se construyen con un signo de dólar]($) que precede al nombre de la variable. Para obtener información sobre la creación, configuración y uso de variables, consulte Variables.

Acceder a Variables para Mapeo¶

En el modo de asignación, las variables existentes se enumeran por tipo dentro de la pestaña Variables en el lado de origen de la transformación:

Dentro de la lista, el tipo de cada variable se indica mediante el icono al lado del nombre:

• para variable global
• para la variable del proyecto
• para la variable Jitterbit

El fondo del ícono es sólido si la variable tiene un valor predeterminado, o está vacía si no es así.

En el modo de secuencia de comandos, las variables existentes se enumeran en la pestaña Variables de la paleta de componentes de secuencias de comandos en subpestañas para cada tipo:

Ambos modos tienen un cuadro de búsqueda donde puede ingresar una palabra clave o palabras clave separadas por comas. Se devuelven las variables que tienen alguna parte de las palabras clave en su nombre.

Las variables de proyecto, globales y Jitterbit están disponibles para usar en la transformación:

• Variables del proyecto: Variables del proyecto que ya se han creado y están disponibles para su uso globalmente dentro del proyecto. Para crear o editar una nueva variable de proyecto:

  • Modo de asignación: Para crear una nueva variable de proyecto, haga clic en Crear nueva variable de proyecto, o para editar una variable de proyecto existente, coloque el cursor sobre la variable y haga clic en el icono de edición.editar.

  • Modo Secuencia de Comandos: Para crear una nueva variable de proyecto, haga clic en Agregar nuevo, o para editar una variable de proyecto existente, haga clic en el nombre de la variable.

• Variables globales: Variables globales que se han definido en cualquier parte del proyecto.

  Advertencia

  Las variables globales deben declararse arriba en la cadena de la transformación para usarse dentro de la transformación. Si la variable global no se ha inicializado, el valor predeterminado de una variable global está vacío.

• Variables de Jitterbit: variables de Jitterbit que están disponibles para su uso global dentro del proyecto.

  Precaución

  Algunas variables de Jitterbit que se enumeran pueden no ser aplicables a la operación específica. Consulte la documentación sobre cada variable en Variables Jitterbit.

Asignar a un Campo de Destino¶

Las variables se pueden asignar arrastrando y soltando, haciendo doble clic o insertando manualmente la ruta de referencia de la variable:

• Arrastrar y soltar: Arrastrar y soltar variables se puede realizar en modo de mapeo y en modo de secuencia de comandos:

  • Modo de mapeo: Dentro de la pestaña Variables de la izquierda, arrastre una variable de la izquierda a un campo de destino apropiado a la derecha:

    

  • Modo Secuencia de Comandos: Dentro de la pestaña Variables de la derecha, arrastre una variable de la derecha a un campo de destino apropiado a la izquierda:

    

• Doble clic: En modo secuencia de comandos, haga doble clic en la variable en la pestaña Variables para insertar la referencia de la variable en la ubicación del cursor dentro del secuencia de comandos.

• Inserción manual: Puede abrir un área de secuencia de comandos editable para ingresar manualmente referencias de variables desde el modo de mapeo o el modo de secuencia de comandos. Para agregar una nueva secuencia de comandos en un campo de destino, realice una de las siguientes acciones:

  • Haga doble clic en el nombre del campo.

  • Pase el cursor sobre el campo de destino y haga clic en el ícono Agregar en la esquina superior derecha para abrir un menú de acciones. En el menú, seleccione Agregar Secuencia de Comandos:

    

Una variable referenciada se muestra visualmente dentro del campo de destino asignado, con un icono de secuencia de comandos agregado en la parte superior derecha para indicar que el campo tiene una asignación:

Para ver o editar la asignación como una secuencia de comandos, haga doble clic en el nombre del campo o haga clic en el icono de secuencia de comandos para abrir el área de secuencia de comandos editable para el campo de destino en modo secuencia de comandos:

Asignar a un Campo con una Asignación Existente¶

Al arrastrar y soltar una variable en un campo de destino que ya tiene una asignación, se le presenta la opción de copiar la referencia de la variable a su portapapeles para que pueda pegar esa referencia manualmente en la lógica del secuencia de comandos:

Al hacer clic en Continuar, el campo de destino se expande con un área de secuencia de comandos editable para que pueda pegar la referencia de la variable en modo secuencia de secuencia de comandos. Para las asignaciones que contienen varias referencias, debe agregar lógica de script para que el secuencia de comandos sea válido. Por ejemplo:

Al agregar referencias de variables adicionales mediante doble clic o inserción manual, no se presenta el cuadro de diálogo para copiar una referencia de variable. Sin embargo, puede agregar varias referencias de variables en el área de secuencia de comandos editable haciendo doble clic, arrastrando y soltando, o insertando manualmente las referencias.

Eliminar una Asignación¶

Puede eliminar las asignaciones de campos de destino una a la vez (Eliminar una asignación de campo único) o todos a la vez para todas las asignaciones de campos contenidas dentro de un nodo (Eliminar asignaciones de campos múltiples).

Eliminar una Asignación de Campo Único¶

Para eliminar una asignación de una sola variable de un campo de destino (a veces denominado desasignación de un campo), coloque el cursor sobre la variable dentro del campo de destino y haga clic en el icono de eliminar :

Para asignaciones con múltiples objetos o secuencias de comandos asignados, coloque el cursor sobre la variable dentro del campo de destino y haga clic en el ícono de edición.editar, luego edite el secuencia de comandos para eliminar la asignación de variables:

También se puede acceder al área de secuencia de comandos editable haciendo clic en el icono de secuencia de comandos en el campo de destino.

Dentro del área de secuencia de comandos editable, también puede borrar manualmente el contenido de la secuencia de comandos del campo de destino para eliminar toda la asignación.

Eliminar Asignaciones de Campos Múltiples¶

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

Desde cualquier modo de mapeo o modo secuencia de comandos, coloque el cursor sobre el nombre de un nodo y haga clic en el icono del menú de acciones para abrir el menú de acciones. En el menú, seleccione una de estas opciones de eliminación de mapeo:

Opción del menú	Descripción
	Eliminar nodos de bucle y asignaciones elimina la definición del nodo de bucle debido a las 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 conservan y el nodo conserva su definición de nodo de bucle si se asigna al menos un nieto. Esta acción está disponible solo 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 en los campos contenidos dentro del nodo, así como todas las asignaciones en los campos contenidos dentro de los nodos secundarios de ese nodo. Usar esta acción en un El nodo raíz elimina todas las asignaciones en 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 en los nodos secundarios de ese nodo. Para obtener más información sobre las asignaciones no válidas asignaciones, consulte Validez de asignación de Transformación.