Saltar al contenido

Editor de Secuencia de Comandos

Introducción

En un proyecto, se muestra el editor de secuencia de comandos completo 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 que se tratan 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.

Accede 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 componente del proyecto:

editor de secuencia de comandos completo

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

salida emergente del editor de secuencia de comandos en línea

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

editor de secuencia de comandos en línea anotado

Cambiar el Nombre de un Secuencia de Comandos

Cuando crea un nuevo secuencia de comandos, su nombre predeterminado es Nuevo script. Los nuevos secuencias de comandos subsiguientes con nombres predeterminados se añaden con un número incrementado entre paréntesis. Los nombres de los Secuencia de Comandos deben ser únicos y no deben contener barras diagonales (/) o dos puntos (:) 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:

rebautizar

También se puede cambiar el nombre de los Secuencias de Comandos desde estas ubicaciones:

Agregar Notas

Puede agregar notas personalizadas a un secuencia de comandos que sirvan como documentación o recordatorios para usted o sus colaboradores del proyecto. Para agregar una nota, haga clic en el ícono de nota junto al campo Tipo de Secuencia de Comandos.

Se abre un área editable, donde puede ingresar el texto de su nota. Haga clic en Publicar para agregar la nota al secuencia de comandos:

nota de la publicación

Se muestra su nota publicada, junto con su 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 eliminación. . Para cerrar la nota, haga clic en otra parte de la interfaz. Cuando hay una o más notas presentes, se muestra un punto naranja en el icono de nota:

nota publicada

Seleccione el Idioma de Secuencia de Comandos

Los Secuencias de Comandos creados como componente del proyecto se abren en Jitterbit Script idioma de forma predeterminada. El idioma se puede cambiar a JavaScript usando el menú Tipo de Secuencia de Comandos:

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.

Alternar Modos de Secuencia de Comandos

Los Secuencias de Comandos se abren en modo de edición de forma predeterminada. Para abrir el secuencia de comandos en modo de prueba, use el interruptor en la parte superior derecha para seleccionar Prueba:

editar prueba

Para obtener más detalles, consulte Prueba de Secuencia de Comandos.

Guardar Estado

Después de realizar cambios en un secuencia de comandos, la configuración del secuencia de comandos se guarda automáticamente. Para guardar manualmente el secuencia de comandos, presione 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 nombre del secuencia de comandos. Estos estados son posibles:

  • Salvado
  • Tiene 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 Cloud 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:

secuencia de comandos es válido

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

mensaje de error truncado

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

Se puede cambiar el tamaño del cuadro de diálogo del mensaje de error haciendo clic y arrastrando la esquina inferior izquierda del cuadro de diálogo:

diálogo de mensaje de error de cambio de tamaño

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 del secuencia de comandos brindan acceso a varios componentes que se pueden usar dentro de un secuencia de comandos:

paleta de componentes de secuencias de comandos

Para contraer la paleta de componentes de secuencias de comandos, haga clic en el icono contraer ubicado en la parte superior derecha de la paleta. Cuando está contraído, puede expandir la paleta de componentes de secuencias de comandos haciendo clic en una de las pestañas de la paleta.

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

Cada pestaña de la paleta de componentes de secuencias de comandos se resume a continuación, con detalles adicionales proporcionados en Jitterbit Script o JavaScript dependiendo del idioma.

Pestaña
Descripción
Objetos de origen La pestaña Objetos de origen está presente solo para secuencias de comandos creados dentro de una transformación. Como este tipo de secuencia de comandos está limitado a aquellos que usan Jitterbit Script lenguaje, que hace 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 datos de origen insertando la ruta de referencia de un campo, o puede hacer referencia a nodos de datos de origen insertando la ruta de referencia de un nodo.

Para agregar un campo o una ruta de referencia de nodo a un secuencia de comandos de transformación ( Jitterbit Script únicamente), use uno de estos métodos:

  • Arrastre el objeto desde la paleta al secuencia de comandos para insertar la ruta de referencia del objeto.
  • Haga doble clic en el objeto en la paleta para insertar el 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 utilizar funciones insertando la sintaxis de función apropiada para el lenguaje del secuencia de comandos.

Para agregar la sintaxis de la 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 en la ubicación del cursor dentro del secuencia de comandos. Al insertar la sintaxis de la función, el primer argumento de la función se resalta y el cursor se mueve al final del argumento.
  • Comience a escribir el nombre de la función y luego presione Control+Space para mostrar una lista de sugerencias de autocompletar. Seleccione una función para insertar la sintaxis de la función.
  • Ingrese 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 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 utilizar variables insertando la sintaxis de la variable.

Para agregar la sintaxis de la 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 autocompletar. Seleccione una variable para insertar la sintaxis de la variable.
  • Ingrese manualmente la sintaxis de la variable.
Para obtener detalles adicionales, consulte Variables en Jitterbit Script o Variables en JavaScript.

Complementos La pestaña Complementos proporciona una lista de complementos que se pueden ejecutar dentro de un secuencia de comandos. Dentro de un secuencia de comandos, puede utilizar un complemento como argumento para el RunPlugin función insertando la ruta de referencia del complemento.

Para agregar una ruta de referencia de complemento a un secuencia de comandos (Jitterbit Script únicamente), use uno de estos métodos:

  • Arrastre el complemento desde la paleta al secuencia de comandos para insertar tanto el 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 autocompletar. Seleccione un complemento para insertar la referencia del complemento.
  • Ingrese manualmente la referencia del complemento.
Para obtener detalles adicionales, consulte Complementos en Jitterbit Script.

Operaciones Esta pestaña proporciona una lista de operaciones en el proyecto que están disponibles para hacer referencia en un secuencia de comandos. Dentro de un secuencia de comandos, puede utilizar una operación como argumento para funciones insertando la ruta de referencia de la operación.

Para agregar una ruta de referencia de operación a un secuencia de comandos (Jitterbit Script únicamente), utilice uno de estos métodos:

  • Arrastre la operación desde la paleta al secuencia de comandos para insertar tanto el 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 autocompletar. Seleccione una operación para insertar la referencia de la operación.
  • Ingrese manualmente la referencia de la operación.
Para obtener detalles adicionales, consulte Operaciones en Jitterbit Script.

Notificaciones Notificaciones proporciona una lista de notificaciones en el proyecto que están disponibles para hacer referencia en un secuencia de comandos. Dentro de un secuencia de comandos, puede hacer referencia a una notificación como argumento para SendEmailMessage funcionan insertando la ruta de referencia de notificación.

Para agregar una ruta de referencia de notificación a un secuencia de comandos (Jitterbit Script únicamente), utilice uno de estos métodos:

  • Arrastre la notificación desde la paleta al secuencia de comandos para insertar tanto el SendEmailMessage y la referencia de la notificación.
  • Haga doble clic en la notificación en la paleta para insertar la referencia de la 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 autocompletar. 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 independientes del proyecto, escritos en Jitterbit Script o JavaScript — que están disponibles para hacer referencia en un secuencia de comandos. Dentro de un secuencia de comandos, puede hacer referencia a otro secuencia de comandos como argumento para RunScript funcionan 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 únicamente), utilice uno de estos métodos:

  • Arrastre el secuencia de comandos desde la paleta al secuencia de comandos para insertar tanto el RunScript 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 autocompletar. Seleccione un secuencia de comandos para insertar la referencia del 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, no ocurre lo contrario. Un JavaScript Jitterbit no puede llamar a otro secuencia de comandos de ningún idioma.

Extremos La pestaña Extremos proporciona una lista de extremos del proyecto que están disponibles para hacer referencia en un secuencia de comandos. Dentro de un secuencia de comandos, puede hacer referencia a extremos como argumento para funciones insertando la ruta de referencia de conexión o actividad.

Para agregar una conexión o ruta de referencia de 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 al secuencia de comandos para insertar la referencia adecuada.
  • Haga doble clic en la conexión o actividad en la paleta para inserte la referencia adecuada 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 autocompletar. Seleccione una conexión o actividad para insertar la referencia adecuada.
  • Ingrese manualmente la referencia de conexión o actividad.
Dependiendo del extremo, puede usar la pestaña Funciones para agregar funciones para las cuales usar la conexión o referencia de actividad como argumento.

Para obtener detalles adicionales, consulte Extremos en Jitterbit Script o Extremos en JavaScript.

Secuencia de Comandos

El área de secuencia de comandos es el área de texto donde ingresa una secuencia de comandos usando el idioma 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 requieran 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 del corchete para resaltar el conjunto. Estos conjuntos de corchetes están resaltados: (), [], {}.

  • 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 verificación de sintaxis básica y resaltado de líneas con errores. Si el secuencia de comandos pasa la validación de sintaxis básica, una línea debajo del área del secuencia de comandos dice El script es válido. Si el secuencia de comandos no pasa la validación de sintaxis básica, aquí se proporciona información de error específica, línea por línea. Es decir, después de resolver un error en una línea, es posible que se informen errores de sintaxis adicionales para resolver en las líneas siguientes.

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

  • Completado automático: A medida que escribe, puede mostrar sugerencias de autocompletar que comienzan con la cadena ingresada usando Control+Space. Cuando solo hay una sugerencia disponible, se inserta automáticamente. Cuando hay más de una sugerencia disponible, puede navegar por la lista usando las teclas de flecha del teclado y presionar Enter o Tab para insertar la sugerencia en el área del secuencia de comandos.

  • Bloque de sangría: Cuando se selecciona una línea o líneas completas, al presionar Tab sangra las líneas seleccionadas una pestaña a la derecha. Similarmente, Shift+Tab mueve las líneas seleccionadas una tabulación hacia la izquierda. Si no se selecciona ningún texto, Shift+Tab mueve la línea hacia la izquierda hasta donde está el cursor.

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