Saltar al contenido

Editor de Secuencia de Comandos

Introducción

En un proyecto, el editor de secuencia de comandos completo se muestra para los secuencias de comandos creados como un 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 ícono 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:

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 botón icono emergente en la parte superior derecha del secuencia de comandos:

ventana 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. Se identifican en la siguiente imagen:

editor de secuencia de comandos en línea anotado

Leyenda

① Cambiar el nombre de un secuencia de comandos
②Añadir notas
③ Seleccione el idioma del secuencia de comandos
④ Activar o desactivar modos de secuencia de comandos
⑤Guardar estado
⑥ 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

Cuando crea un nuevo secuencia de comandos, su nombre predeterminado es New Script. Los secuencias de comandos nuevos posteriores con nombres predeterminados se agregan 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 (:) 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:

rebautizar

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

Agregar Notas

Puede agregar notas personalizadas a un secuencia de comandos que sirvan como documentación o recordatorios para usted o para los 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 puedes ingresar el texto de tu nota. Haz clic en Publicar para agregar la nota al secuencia de comandos:

nota de la publicación

Se muestra la 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 ícono de eliminación para cerrar la nota, haga clic en otra parte de la interfaz. Cuando hay una o más notas, se muestra un punto naranja en el ícono de la nota:

nota publicada

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:

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.

Cambiar 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, utilice 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, 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 nombre del secuencia de comandos. Estos son los estados posibles:

  • Guardado
  • Tienes cambios sin guardar
  • Guardando...
  • Secuencia de Comandos no guardado debido a 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:

el secuencia de comandos es válido

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:

mensaje de error truncado

Para ver el mensaje de error completo, haga clic en el ícono 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 redimensionar haciendo clic y arrastrando la esquina inferior izquierda del cuadro de diálogo:

cambiar el tamaño del cuadro de diálogo del mensaje de error

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:

paleta de componentes de secuencias de comandos

Para contraer la paleta de componentes de secuencias de comandos, haga clic en el icono de contraer ubicado en la parte superior derecha de la paleta. Cuando está contraída, 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, utilice el cuadro de búsqueda para ingresar una sola palabra clave o una cadena de palabras clave. Para borrar la búsqueda, haga clic en el ícono 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 dependiendo del idioma.

Pestaña
 Descripción
Objetos de origen La pestaña Objetos de origen está presente solo para los 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, 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), utilice 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 utilizar 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), utilice uno de estos métodos:

  • Arrastre la función desde la paleta hasta el 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 las variables que están disponibles para hacer referencia globalmente a lo largo de un proyecto, incluidas variables globales, variables del proyecto y variables Jitterbit. Dentro de un secuencia de comandos, puede utilizar 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 autocompletar. Seleccione una variable para insertar la sintaxis de la variable.
  • Ingrese manualmente la sintaxis de la variable.
Para obtener más detalles, consulte Variables en Jitterbit Script o Variables en JavaScript.
Plugins La pestaña Plugins proporciona una lista de complementos que se pueden ejecutar dentro de un secuencia de comandos. Dentro de un secuencia de comandos, puede usar un complemento como argumento para el script. 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 referencia del complemento.
  • Ingrese manualmente la referencia del complemento.
Para obtener más detalles, 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 solamente), use uno de estos métodos:

  • Arrastre la operación desde la paleta hasta el secuencia de comandos para insertar ambos 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 más detalles, consulte Operaciones en Jitterbit Script.
Notificaciones Las Notificaciones proporcionan 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 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 al secuencia de comandos para insertar tanto SendEmailMessage 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 autocompletar. Seleccione una notificación para insertar la referencia de notificación.
  • Ingrese manualmente la referencia de 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 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 el 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), use uno de estos métodos:

  • Arrastre el secuencia de comandos desde la paleta hasta el secuencia de comandos para insertar tanto 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, lo inverso 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 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 extremos como argumento para funciones insertando la ruta de referencia de conexión o actividad.

Para agregar una ruta de referencia de 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 adecuada.
  • Haga doble clic en la conexión o actividad en la paleta para insertar 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 referencia de conexión o 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 se ingresa un secuencia de comandos utilizando 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 requieran específicamente que el código se coloque 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 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 pasa 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 pasa la validación de sintaxis básica, aquí se proporciona información específica sobre el error, una línea a la vez. 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 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: Mientras 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. Cuando hay más de una sugerencia disponible, puede navegar por la lista utilizando las teclas de flecha del teclado y presionar 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 manera similar, Shift+TabMueve las líneas seleccionadas una tabulación hacia la izquierda. Si no hay texto seleccionado, Shift+Tab mueve la línea hacia 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.