Editor de Secuencia de comandos en Jitterbit Integration Studio

Introducción

En un proyecto, el editor de secuencia de comandos completo se muestra para los secuencias de comandos creados como componente del proyecto. El editor de secuencia de comandos en línea está presente en las transformaciones, que se pueden expandir al editor de secuencia de comandos completo haciendo clic en el icono de expansión. en la parte superior derecha de un secuencia de comandos.

El editor de secuencia de comandos completo contiene todas las opciones cubiertas en esta página, mientras que el editor en línea ofrece una versión reducida para una edición rápida.

Para obtener más información sobre los tipos de secuencias de comandos, consulte Tipos de Secuencia de comandos y creación.

Acceder al editor de secuencia de comandos

El editor de secuencia de comandos completo es el editor de secuencia de comandos predeterminado para los secuencias de comandos creados como un componente del proyecto:

Para acceder al editor de secuencia de comandos completo desde la versión en línea presente en las transformaciones, haga clic en el botón Icono emergente en la parte superior derecha del secuencia de comandos:

Las herramientas y regiones de la página se mencionan a lo largo de esta página. Se identifican en la imagen a continuación:

Leyenda① Cambiar el nombre de un secuencia de comandos
②Añadir notas
③ Seleccionar el idioma del secuencia de comandos
④ Activar y desactivar modos de secuencia de comandos
⑤Estado de guardado
⑥ Validación de Secuencia de comandos
⑦ paleta de componentes de Secuencia de comandos
⑧ secuencia de comandos "> Secuencia de comandos

Cambiar el nombre de un secuencia de comandos

Al crear un nuevo secuencia de comandos, su nombre predeterminado es Nuevo script. Los secuencias de comandos nuevos posteriores con nombres predeterminados se añaden con un número incremental entre paréntesis. Los nombres de los Secuencia de comandos deben ser únicos y no deben contener barras diagonales (/) o dos puntos (:) para ser válido.

Para cambiar el nombre de un secuencia de comandos desde el editor de secuencia de comandos, edite el campo en la parte superior izquierda:

Los Secuencias de comandos también se pueden renombrar desde estas ubicaciones:

• La pestaña Flujos de trabajo del panel del proyecto (vea menú de acciones de componentes 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ñaComponentes del panel Proyecto).
• El tela de diseño (vea Cambio de nombre de flujos de trabajo, operaciones y pasos de operación en Lienzo de diseño)

Añadir notas

Puedes agregar notas personalizadas a un secuencia de comandos que sirvan como documentación o recordatorios para ti o para tus colaboradores del proyecto. Para agregar una nota, haz clic en el icono de nota. junto al campo Tipo de Secuencia de comandos.

Se abrirá un área editable donde puedes escribir el texto de tu nota. Haz clic en Publicar para añadir la nota al secuencia de comandos.

Se muestra la nota publicada, junto con tu nombre y una marca de tiempo. Cualquier persona con acceso de edición al secuencia de comandos puede eliminar notas haciendo clic en el icono de eliminar. Para cerrar la nota, haga clic en otra parte de la interfaz. Cuando haya una o más notas, se mostrará un punto naranja en el icono de la nota:

Seleccione el idioma del secuencia de comandos

Los Secuencias de comandos creados como un componente del proyecto se abren en Jitterbit Script idioma predeterminado. El idioma se puede cambiar a JavaScript utilizando el menú Tipo de Secuencia de comandos:

Los Secuencias de comandos creados dentro de una transformación, ya sea en un campo de destino o en un nodo, están limitados a Jitterbit Script idioma.

Activar o desactivar los modos de secuencia de comandos

Los Secuencias de comandos se abren en modo de edición por defecto. Para abrir el secuencia de comandos en modo de prueba, utilice el interruptor de la esquina superior derecha para seleccionar Prueba:

Para más detalles, consulte Prueba de Secuencia de comandos.

Guardar estado

Después de realizar cambios en un secuencia de comandos, guarde el secuencia de comandos usando Control+S (Windows o Linux) o Command+S (macOS).

El estado de guardado se muestra en la parte superior del secuencia de comandos, debajo del secuencia de comandos. Estos son los estados posibles:

• Guardado
• Tienes cambios sin guardar
• Guardando...
• Secuencia de comandos no guardado debido a un conflicto con otro usuario

Para obtener más información sobre el guardado automático, consulte Permisos, colaboración y guardado de Integration Studio.

Validación de Secuencia de comandos

La validación de un secuencia de comandos se comprueba con cada pulsación de tecla.

Cuando un secuencia de comandos es válido, se muestra un mensaje El Secuencia de comandos es válido en verde:

Cuando se detecta un error, se muestra un mensaje de error truncado en rojo con la línea de secuencia de comandos que contiene el error resaltada:

Para ver el mensaje de error completo, haga clic en el icono de expansión. El mensaje de error completo se abre en un cuadro de diálogo.

El cuadro de diálogo del mensaje de error se puede ajustar de tamaño haciendo clic y arrastrando la esquina inferior izquierda:

Paleta de componentes de Secuencia de comandos

La paleta de componentes de secuencias de comandos es uno de los dos tipos de paletas de componentes. (El otro tipo es la paleta de componentes de diseño.)

Las pestañas de la paleta de componentes de secuencia de comandos brindan acceso a varios componentes que se pueden usar dentro de un secuencia de comandos:

Para contraer la paleta de componentes de secuencias de comandos, haga clic en el icono de contraer Se encuentra en la esquina superior derecha de la paleta. Al contraerse, puede expandir la paleta de componentes de secuencias de comandos haciendo clic en una de sus pestañas.

Para buscar dentro de una pestaña, utilice el cuadro de búsqueda para introducir una sola palabra clave o una cadena de palabras clave. Para borrar la búsqueda, haga clic en el icono de eliminar. .

A continuación se resume cada pestaña de la paleta de componentes de secuencias de comandos, con detalles adicionales proporcionados en Jitterbit Script o JavaScript según el idioma.

Tab	Descripción
Objetos de origen	La pestaña Objetos de origen solo está disponible para secuencias de comandos creados dentro de una transformación. Dado que este tipo de secuencia de comandos está limitado a quienes usan Jitterbit Script lenguaje, haciendo referencia a objetos fuente en secuencias de comandos escritos en JavaScript no es aplicable. Dentro de un secuencia de comandos de transformación, puede hacer referencia a los datos de origen insertando la ruta de referencia de un campo, o puede hacer referencia a los nodos de datos de origen insertando la ruta de referencia de un nodo. Para agregar una ruta de referencia de campo o nodo a un secuencia de comandos de transformación ( Jitterbit Script solamente), use uno de estos métodos: Arrastre el objeto desde la paleta hasta el secuencia de comandos para insertar la ruta de referencia del objeto. Haga doble clic en el objeto en la paleta para insertar la ruta de referencia del objeto en la ubicación del cursor dentro del secuencia de comandos. Ingrese manualmente la ruta de referencia al objeto de origen. Para obtener detalles adicionales, consulte Objetos de origen en Jitterbit Script.
Funciones	La pestaña Funciones proporciona una lista de funciones disponibles para usar en un secuencia de comandos para el idioma seleccionado en el secuencia de comandos (ya sea Jitterbit Script o JavaScript). Dentro de un secuencia de comandos, puede usar funciones insertando la sintaxis de función apropiada para el lenguaje del secuencia de comandos. Para agregar la sintaxis de función a un secuencia de comandos (Jitterbit Script o JavaScript), use uno de estos métodos: Arrastre la función desde la paleta al secuencia de comandos para insertar la sintaxis de la función. Haga doble clic en la función en la paleta para insertar la sintaxis de la función donde se encuentre el cursor dentro del secuencia de comandos. Al insertar la sintaxis de la función, el primer argumento de la función se resaltará y el cursor se moverá al final del argumento. Empiece a escribir el nombre de la función y luego presione Control+Space Para mostrar una lista de sugerencias de autocompletado. Seleccione una función para insertar su sintaxis. Introduzca manualmente la sintaxis de la función. Para obtener más información, consulte la documentación de cada función por categoría en Funciones.
Variables	La pestaña Variables proporciona acceso a las variables que están disponibles para hacer referencia globalmente en todo un proyecto, incluidas variables globales, variables del proyecto y variables de Jitterbit. Dentro de un secuencia de comandos, puede usar variables insertando la sintaxis de variable. Para agregar la sintaxis de variable a un secuencia de comandos (Jitterbit Script o JavaScript), use uno de estos métodos: Arrastre la variable desde la paleta al secuencia de comandos para insertar la sintaxis de la variable. Haga doble clic en la variable en la paleta para insertar la sintaxis de la variable en la ubicación del cursor dentro del secuencia de comandos. Comience a escribir el nombre de la variable y luego presione Control+Space Para mostrar una lista de sugerencias de autocompletado. Seleccione una variable para insertar su sintaxis. Introduzca manualmente la sintaxis de la variable. Para más detalles, consulte Variables en Jitterbit Script o Variables en JavaScript.
Plugins	La pestaña Plugins proporciona una lista de plugins que se pueden ejecutar dentro de un secuencia de comandos. Dentro de un secuencia de comandos, puedes usar un complemento como argumento para... RunPlugin función insertando la ruta de referencia del complemento. Para agregar una ruta de referencia del complemento a un secuencia de comandos (Jitterbit Script solamente), use uno de estos métodos: Arrastre el complemento desde la paleta hasta el secuencia de comandos para insertar ambos RunPlugin función y la referencia del complemento. Haga doble clic en el complemento en la paleta para insertar la referencia del complemento en la ubicación del cursor dentro del secuencia de comandos. Comience a escribir el nombre del complemento y luego presione Control+Space Para mostrar una lista de sugerencias de autocompletado. Seleccione un complemento para insertar la complemento. Introduzca manualmente la referencia del complemento. Para más detalles, consulte Complementos en Jitterbit Script.
Operaciones	Esta pestaña proporciona una lista de operaciones del proyecto que se pueden referenciar en un secuencia de comandos. Dentro de un secuencia de comandos, se puede usar una operación como argumento para funciones insertando su ruta de operación. Para agregar una ruta de operación a un secuencia de comandos (Jitterbit Script solamente), utilice uno de estos métodos: Arrastre la operación desde la paleta hasta el secuencia de comandos para insertar tanto la RunOperation función y la referencia de la operación. Haga doble clic en la operación en la paleta para insertar la referencia de la operación en la ubicación del cursor dentro del secuencia de comandos. Comience a escribir el nombre de la operación y luego presione Control+Space Para mostrar una lista de sugerencias de autocompletado. Seleccione una operación para insertar la referencia de la operación. Introduzca manualmente la referencia de la operación. Para obtener más detalles, consulte Operaciones en Jitterbit Script.
Notificaciones	Notificaciones proporciona una lista de notificaciones del proyecto que se pueden consultar en un secuencia de comandos. Dentro de un secuencia de comandos, se puede consultar una notificación como argumento para SendEmailMessage función insertando la ruta de referencia de notificación. Para agregar una ruta de referencia de notificación a un secuencia de comandos (Jitterbit Script solamente), use uno de estos métodos: Arrastre la notificación desde la paleta hasta el secuencia de comandos para insertar tanto SendEmailMessage función y la referencia de notificación. Haga doble clic en la notificación en la paleta para insertar la referencia de notificación en la ubicación del cursor dentro del secuencia de comandos. Comience a escribir el nombre de la notificación y luego presione Control+Space Para mostrar una lista de sugerencias de autocompletado. Seleccione una notificación para insertar la referencia de la notificación. Ingrese manualmente la referencia de la notificación. Para ver un ejemplo, consulte Notificaciones en Jitterbit Script.
Secuencias de comandos	La pestaña Secuencias de comandos proporciona una lista de todos los demás secuencias de comandos de componentes de proyecto independientes en el proyecto, escritos en Jitterbit Script o JavaScript — que se pueden referenciar en un secuencia de comandos. Dentro de un secuencia de comandos, se puede hacer referencia a otro secuencia de comandos como argumento para RunScript función insertando la ruta de referencia del secuencia de comandos. Para agregar una ruta de referencia de secuencia de comandos a un secuencia de comandos (Jitterbit Script solamente), utilice uno de estos métodos: Arrastre el secuencia de comandos desde la paleta hasta el secuencia de comandos para insertar tanto el RunScript función y la referencia del secuencia de comandos. Haga doble clic en el secuencia de comandos en la paleta para insertar la referencia del secuencia de comandos en la ubicación del cursor dentro del secuencia de comandos. Comience a escribir el nombre del secuencia de comandos y luego presione Control+Space Para mostrar una lista de sugerencias de autocompletado. Seleccione un secuencia de comandos para insertar la secuencia de comandos. Ingrese manualmente la referencia del secuencia de comandos. Para ver un ejemplo, consulte Secuencias de comandos en Jitterbit Script. Nota Si bien un Jitterbit Script puede llamar a un JavaScript, lo contrario no es cierto. Un JavaScript Jitterbit no puede llamar a otro secuencia de comandos de ningún lenguaje.
Extremos	La pestaña Extremos proporciona una lista de extremos del proyecto que se pueden referenciar en un secuencia de comandos. Dentro de un secuencia de comandos, se pueden referenciar extremos como argumento para funciones insertando la ruta de referencia de la conexión o actividad. Para agregar una ruta de referencia de la conexión o actividad a un secuencia de comandos (Jitterbit Script o JavaScript), utilice uno de estos métodos: Arrastre la conexión o actividad desde la paleta hasta el secuencia de comandos para insertar la referencia apropiada. Haga doble clic en la conexión o actividad en la paleta para insertar la referencia apropiada en la ubicación del cursor dentro del secuencia de comandos. Comience a escribir el nombre de la conexión o actividad y luego presione Control+Space Para mostrar una lista de sugerencias de autocompletado. Seleccione una conexión o actividad para insertar la referencia correspondiente. Introduzca manualmente la referencia de la conexión o actividad. Según el extremo, puede usar la pestaña Funciones para agregar funciones que usen la referencia de la conexión o actividad como argumento. Para obtener más información, consulte Extremos en Jitterbit Script o Extremos en JavaScript.

Secuencia de comandos

El área de secuencia de comandos es el área de texto donde se ingresa un secuencia de comandos usando el lenguaje apropiado: Jitterbit Script o JavaScript.

En Jitterbit Script, los secuencias de comandos deben estar encerrados dentro de un <trans> etiqueta de apertura y </trans> etiqueta de cierre, a menos que se utilicen funciones que soliciten específicamente que se coloque código fuera de estas etiquetas, como varias Funciones de base de datos.

En JavaScript, los secuencias de comandos deben estar encerrados dentro de un <javascript> etiqueta de apertura y </javascript> etiqueta de cierre.

Estas son las principales características del área de secuencia de comandos:

• Resaltado de sintaxis: Se utilizan diferentes colores para distinguir las diferentes partes de una expresión, como nombres de funciones, cadenas y variables.

Resaltado de corchetes: Si coloca el cursor inmediatamente antes o después de un corchete que forma parte de un conjunto de corchetes de apertura y cierre, cada corchete del conjunto se muestra con un borde alrededor para resaltarlo. Estos conjuntos de corchetes se resaltan: (), [], {}.

• Numeración de líneas: Los números de línea se muestran a lo largo del margen izquierdo del área del secuencia de comandos.

• Validación automática: Harmony proporciona una comprobación de sintaxis básica y resalta las líneas con errores. Si el secuencia de comandos supera la validación de sintaxis básica, una línea debajo del área del secuencia de comandos indica El script es válido. Si el secuencia de comandos no supera la validación de sintaxis básica, se proporciona información específica del error línea por línea. Es decir, tras resolver un error en una línea, se pueden informar errores de sintaxis adicionales para las líneas posteriores.

• Arrastrar y soltar: Al arrastrar un elemento desde la paleta de componentes al área de secuencia de comandos, se inserta automáticamente el elemento en la sintaxis adecuada para su uso dentro del secuencia de comandos.

• Autocompletar: A medida que escribe, puede mostrar sugerencias de autocompletar que comiencen con la cadena ingresada utilizando Control+Space Cuando solo hay una sugerencia disponible, se inserta automáticamente. Si hay más de una, puede navegar por la lista con las flechas del teclado y pulsar Enter o Tab para insertar la sugerencia en el área de secuencia de comandos.

• Sangría de bloque: Cuando se selecciona una o más líneas completas, al presionar Tab Sangra las líneas seleccionadas una pestaña a la derecha. De forma similar, Shift+TabMueve las líneas seleccionadas una tabulación a la izquierda. Si no hay texto seleccionado, Shift+Tab mueve la línea a la izquierda donde está el cursor.

Además, se pueden utilizar las funciones estándar del navegador para deshacer, controlar el tamaño de fuente y buscar dentro del secuencia de comandos.