Modo de Secuencia de Comandos¶

Introducción¶

El modo de Secuencia de Comandos proporciona vistas detalladas de los campos y herramientas avanzadas para agregar secuencias de comandos al mapeo. Consulte también Elementos del modo común para elementos de la interfaz de usuario que son compartidos por múltiples modos de visualización.

Acceder al Modo Secuencia de Comandos¶

El modo de Secuencia de Comandos le permite explorar en profundidad el nivel de secuencia de comandos de cada campo de destino y proporciona más control sobre la asignación de cada campo. Puede ingresar al modo de secuencia de comandos desde cualquier campo de destino individual desde dentro del modo de asignación de cualquiera de estas formas:

• Haga doble clic en el nombre de un campo de destino.
• Para los campos de destino que aún no tienen una asignación, pase el cursor sobre el campo de destino y luego haga clic en el botón agregue un icono y seleccione Agregar Secuencia de Comandos.
• Para los campos de destino que ya tienen una asignación, haga clic en el botón icono de secuencia de comandos.

En el modo de secuencia de comandos, la estructura y las asignaciones de destino se muestran en el lado izquierdo. Cuando el cursor se centra en el secuencia de comandos de un campo de destino determinado, se muestra un borde violeta alrededor del campo de destino. Todos los componentes disponibles para su uso en un secuencia de comandos en particular se muestran en la paleta de componentes en el lado derecho:

Al acceder a una transformación que abrió anteriormente, Cloud Studio se desplaza automáticamente a la ubicación en el esquema a la que accedió por última vez. Además, si sale de una transformación mientras el foco del cursor está dentro de un secuencia de comandos, Cloud Studio recuerda el último secuencia de comandos al que accedió y lo abre automáticamente y se desplaza hasta él la próxima vez que acceda a la transformación.

Nodos de Destino¶

Un esquema de destino específico se compone de nodos que pueden contener campos, así como otros nodos secundarios que también pueden contener campos. Los datos de origen no se pueden asignar a los nodos de destino en sí, ya que solo se pueden asignar a los campos que contienen los nodos de destino. Una vez que haya especificado un esquema de destino, para acceder a las opciones disponibles en cada nodo, pase el cursor sobre el nodo de destino y luego 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 del 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 del nodo de bucle debido a asignaciones que son hojas secundarias directas asociadas con el nodo de bucle, y elimina esas asignaciones. Se conservan otras asignaciones dentro de los nodos de bucle secundarios debajo del nodo de bucle principal, 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 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 nodo raíz elimina todas las asignaciones en una transformación. Al seleccionar esta acción, un mensaje le solicita 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 asignaciones no válidas, consulte Validez de las asignaciones 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).
	Nodo duplicado 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 los nodos raíz en esquemas planos y en los nodos cuya cardinalidad indica que los elementos pueden aparecer más de una vez. El nodo no debe ser un duplicado de otro nodo. Solo para fines de visualización en tiempo de diseño, el nombre del nodo duplicado se adjunta con un símbolo hash (#) y un número incrementado. Por ejemplo, cuando duplicas 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 el 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 que se muestran como transaction, transaction#1, y transaction#2 se procesan cada uno con el nombre de nodo original transaction. Los nodos duplicados no se pueden renombrar. El hecho de que un nodo duplicado se refleje en otras ubicaciones a lo largo 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, entonces el nodo duplicado se refleja en el esquema de la actividad. Si el esquema de la actividad sufre posteriormente algún cambio como resultado de una configuración de actividad modificada o una actualización del esquema desde el extremo, la retención de nodos duplicados depende de si el nodo original que se duplicó todavía existe: Si el nodo original existe, se conservan todos los nodos duplicados previamente. 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 el nombre de un nodo duplicado le permite cambiar el nombre de un nodo de destino duplicado. El nuevo nombre es solo para fines de visualización durante el tiempo de diseño. En tiempo de ejecución, el nombre del nodo duplicado original (el nombre del nodo con un símbolo hash adjunto) se muestra en la ventana de configuración.#) y se utiliza un número incrementado). Esta acción solo está disponible en nodos que se crearon utilizando Nodo duplicado.
	Agregar condición al nodo se utiliza para aplicar condicionalmente una asignación a los campos contenidos dentro de 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 de secuencia de comandos para que usted cree la condición. Para obtener detalles sobre cómo crear la condición, consulte Asignación condicional.
	Editar condición abre el modo de secuencia de comandos para editar la condición existente en el modo de secuencia de comandos. Esta acción solo está disponible en nodos que ya tienen una condición aplicada. Para obtener 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 asignación de transformación genere datos de salida de la transformación, debe asignar al menos un campo en el esquema de destino. Una vez que haya especificado un esquema de destino, puede asignar a los campos de destino de cualquiera de las formas que se describen a continuación, incluso asignando objetos de origen, variables, secuencias de comandos o valores personalizados a los campos de destino o agregando 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. Cuando asigna 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
  Cuando asigna 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 ($) que precede al 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 utilizar cualquier lógica de secuencia de comandos válida.

Editar o Eliminar una Asignación¶

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

Editar o Eliminar una Asignación de Campo Individual¶

Al pasar el cursor sobre un campo objetivo mapeado (indicado con una línea vertical violeta y un icono de secuencia de comandos en el bloque del campo) cuyo secuencia de comandos no está abierto actualmente, 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).