Tipos de Secuencia de Comandos y Creación

Introducción

Los Secuencias de Comandos, escritos en Jitterbit Script o JavaScript, brindan la flexibilidad y el poder para transformar datos, realizar cálculos o realizar validaciones lógicas más allá del simple mapeo de campos.

Los Secuencias de Comandos se pueden utilizar en varios lugares, incluso dentro del tela de diseño como pasos de una operación, así como dentro de transformaciones para aplicar una lógica o condiciones específicas a los datos. Los pasos para crear un secuencia de comandos y realizar otras acciones en un secuencia de comandos son diferentes según el tipo de secuencia de comandos, como se explica en esta página.

Tipos de Secuencia de Comandos

Hay tres tipos distintos de secuencias de comandos que difieren en cómo se crean y utilizan:

• El Secuencia de Comandos como componente del proyecto
  Este tipo de secuencia de comandos se puede utilizar como un paso en una operación y/o llamarse mediante el RunScript función. Este tipo de secuencia de comandos aparece como un componente de proyecto dentro de la paleta de componentes de secuencias de comandos, así como dentro del panel de proyecto. El lenguaje del secuencia de comandos puede ser Jitterbit Script o JavaScript.

• Secuencia de Comandos en un campo de destino en una transformación
  Este tipo de secuencia de secuencia de comandos se puede crear en un campo de una transformación para aplicar la lógica especificada a la asignación de transformación. El último valor devuelto en la secuencia de comandos se utiliza como valor para el campo de destino. Este tipo de secuencia de comandos solo está disponible en los campos de destino de una asignación de transformación. El lenguaje de la secuencia de comandos debe ser Jitterbit Script.

• secuencia de comandos de condición en un nodo de destino en una transformación Este tipo de secuencia de secuencia de comandos se puede aplicar en un nodo de una transformación para determinar si el registro de origen que se está procesando debe enviarse al destino. Si la secuencia de comandos se evalúa como true, entonces se genera el registro. Si el resultado del secuencia de comandos se evalúa como false, entonces se omite el registro. Este tipo de secuencia de secuencia de comandos solo está disponible en los nodos de destino en una asignación de transformación. El lenguaje de la secuencia de comandos debe ser Jitterbit Script.

El Secuencia de Comandos Como Componente del Proyecto

Este tipo de secuencia de comandos es un componente de proyecto que se puede utilizar como un paso en una operación o que puede ser llamado por otro secuencia de comandos utilizando el RunScript función. Por ejemplo, puede utilizar un secuencia de comandos como paso en una operación antes o después de una actividad para recuperar datos y luego procesar la lógica del secuencia de comandos, o puede ejecutar un secuencia de comandos de validación antes de proceder a una transformación.

Crear un Secuencia de Comandos

Se puede crear un nuevo secuencia de comandos como componente del proyecto desde estas ubicaciones:

• La pestaña Componentes del panel del proyecto usando la opción Crear nuevo en la categoría Secuencias de Comandos (vea menú de acciones de la pestaña Componentes en la pestaña Componentes del panel Proyecto).
• El tela de diseño que utiliza una área de inserción (vea menú de acciones de la zona de colocación en Lienzo de diseño).

Los nuevos secuencias de comandos se crean con el nombre predeterminado New Script. Las nuevas transformaciones posteriores con nombres predeterminados se agregan con un número incrementado entre paréntesis.

Al crear un nuevo secuencia de comandos, se abre el editor de secuencia de comandos para que pueda secuencia de comandos (consulte Editor de Secuencia de Comandos).

Menú de Acciones del Secuencia de Comandos

Después de crear un secuencia de comandos como componente del proyecto, las acciones del menú para ese secuencia de comandos son accesibles desde estas ubicaciones:

• La pestaña Flujos de Trabajo del panel del proyecto (vea menú de acciones del componente en la pestaña Flujos de Trabajo del panel Proyecto).
• La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestaña Componentes del panel Proyecto).
• El tela de diseño (vea menú de acciones del componente en Lienzo de diseño).

Están disponibles todas estas acciones del menú:

Elemento del menú	Descripción
	Ver/Editar abre el editor de secuencia de comandos para que puedas crear el secuencia de comandos (vea Editor de Secuencia de Comandos).
	Cortar coloca una copia del secuencia de comandos en el portapapeles y elimina el secuencia de comandos original del proyecto (vea Reutilización de componentes).
	Copiar coloca una copia del secuencia de comandos en su portapapeles (vea Reutilización de componentes).
	Duplicado crea un nuevo secuencia de comandos sin referencia que utiliza la misma configuración que el secuencia de comandos original (vea Reutilización de componentes).
	Cambiar nombre posiciona el cursor en el nombre del secuencia de comandos para que usted pueda realizar las modificaciones necesarias.
	Ver dependencias cambia la vista en el panel del proyecto para mostrar cualquier otra parte del proyecto de la que dependa el secuencia de comandos específico (consulte Dependencias de componentes, eliminación y remoción).
	Agregar al grupo abre un cuadro de diálogo para crear un nuevo grupo personalizado o para agregar el secuencia de comandos a un grupo existente (vea Grupos de componentes).
	Eliminar elimina permanentemente el secuencia de comandos (consulte Dependencias de componentes, eliminación y remoción).
	Eliminar elimina las referencias al secuencia de comandos como un etapa de operación en el tela de diseño (consulte Dependencias de componentes, eliminación y remoción).

Secuencia de Comandos en un Campo de Destino en una Transformación

Este tipo de secuencia de secuencia de comandos se puede agregar a un campo en una transformación para aplicar la lógica especificada a la asignación de transformación. El último valor devuelto en la secuencia de comandos se utiliza como valor para el campo de destino. Como ejemplo, puede utilizar secuencias de comandos para cambiar los datos de campo de un string a un integer, concatenar valores o utilizar una búsqueda en base de datos para un campo.

La creación de un nuevo secuencia de comandos en un campo de destino se realiza durante el mapeo de transformación en modo de mapeo o modo secuencia de comandos y está limitado a Jitterbit Script idioma.

Para agregar un nuevo secuencia de comandos en un campo de destino, haga doble clic en el nombre del campo o pase el cursor sobre el campo de destino y haga clic en el botón agregue un icono en la parte superior derecha de un campo de destino para abrir un menú de acciones. En el menú, seleccione Agregar Secuencia de Comandos:

Para editar un secuencia de comandos en un campo de destino que ya tiene una asignación, haga doble clic en el nombre del campo o haga clic en el botón icono de secuencia de comandos en la parte superior derecha de un campo de destino.

Estos abren el área de secuencia de comandos editable en el campo de destino en modo de secuencia de comandos, donde puede ingresar o editar la lógica del secuencia de comandos para la asignación:

Para ver el editor de secuencia de comandos completo con todas las opciones disponibles para el secuencia de comandos, haga clic en el botón icono emergente en la esquina superior derecha. Para obtener más detalles, consulte Editor de Secuencia de Comandos. Cierre el editor de secuencia de comandos completo para volver a esta pantalla.

Para eliminar el secuencia de comandos, simplemente borre el texto del secuencia de comandos. Para obtener más información sobre este tipo de secuencia de comandos, consulte Mapeo con secuencias de comandos.

Secuencia de Comandos de Condición en un Nodo de Destino en una Transformación

Se crea un secuencia de comandos de condición en un nodo de destino en una transformación para determinar si el registro de origen que se está procesando debe enviarse al destino según una condición definida. La condición determina (sí o no) si el registro está asignado. Como parte de esa determinación, puede incluir lógica para establecer qué valores se utilizan en la asignación. Por ejemplo, un registro solo se puede utilizar si el tamaño de un campo de texto es menor que un máximo especificado.

La creación de un nuevo secuencia de comandos en un nodo de destino se realiza durante el mapeo de transformación en modo de mapeo o modo secuencia de comandos y está limitado a Jitterbit Script lenguaje. Las condiciones se pueden agregar como secuencias de comandos en nodos de destino en cualquier nivel de una estructura de datos.

Para agregar un nuevo secuencia de comandos en un nodo de destino, pase el cursor sobre el nombre del nodo y haga clic en el botón icono del menú de acciones para abrir el menú de acciones. En el menú, seleccione Agregar condición al nodo:

Esto abre el área de secuencia de comandos editable en el nodo de destino en modo de secuencia de comandos, donde puede ingresar o editar la lógica del secuencia de comandos de condición según corresponda. Por ejemplo, el siguiente secuencia de comandos de condición requiere que el objeto de origen CleanStatus evalúa a true para que el expediente sea procesado. Si CleanStatus evalúa a false, entonces se omite el nodo y no se procesará este registro en particular.

Para ver el editor de secuencia de comandos completo con todas las opciones disponibles para el secuencia de comandos de condición, haga clic en el botón icono emergente en la esquina superior derecha. Para obtener más detalles, consulte Editor de Secuencia de Comandos. Cierre el editor de secuencia de comandos completo para volver a esta pantalla.

Para editar o eliminar la condición, pase el cursor sobre el nombre del nodo y haga clic en el botón icono del menú de acciones para abrir el menú de acciones. En el menú, seleccione Editar condición o Eliminar condición:

Para obtener más información sobre este tipo de secuencia de comandos, consulte Mapeo condicional.