Saltar al contenido

Editor de scripts en Jitterbit Integration Studio

Introducción

En un proyecto, se muestra el editor de scripts completo para los scripts creados como un componente del proyecto. El editor de scripts en línea está presente en las transformaciones, el cual se puede expandir al editor de scripts completo haciendo clic en el ícono de expansión en la esquina superior derecha de un script.

El editor de scripts completo contiene todas las opciones cubiertas en esta página, mientras que el editor en línea ofrece una versión simplificada para ediciones rápidas.

Para más información sobre los tipos de scripts, consulta Tipos de scripts y creación.

Acceder al editor de scripts

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

editor de scripts completo

Para acceder al editor de scripts completo desde la versión en línea presente en las transformaciones, haz clic en el ícono de popout en la esquina superior derecha del script:

popout del editor de scripts en línea

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:

editor de scripts en línea anotado

Leyenda

① Renombrar un script
② Agregar notas
③ Seleccionar el idioma del script
④ Alternar modos de script
⑤ Estado de guardado
⑥ Validación de script
⑦ Paleta de componentes de script
⑧ Script

Renombrar un script

Cuando creas un nuevo script, su nombre predeterminado es Nuevo Script. Los scripts nuevos posteriores con nombres predeterminados se les añade un número incrementado entre paréntesis. Los nombres de los scripts deben ser únicos y no deben contener barras diagonales (/) o dos puntos (:) para ser válidos.

Para renombrar un script desde el editor de scripts, edita el campo en la parte superior izquierda:

rename

Los scripts también se pueden renombrar desde estas ubicaciones:

Agregar notas

Puedes agregar notas personalizadas a un script que sirvan como documentación o recordatorios para ti o para los colaboradores del proyecto. Para agregar una nota, haz clic en el ícono de nota junto al campo Tipo de Script.

Se abre un área editable, donde puedes ingresar el texto de tu nota. Haz clic en Publicar para agregar la nota al script:

note post

Tu nota publicada se muestra, junto con tu nombre y una marca de tiempo. Cualquiera con acceso de edición al script puede eliminar notas haciendo clic en el ícono de eliminar . Para cerrar la nota, haz clic en otra parte de la interfaz. Cuando hay una o más notas presentes, se muestra un punto naranja en el ícono de nota:

note posted

Seleccionar el lenguaje de script

Los scripts creados como un componente de proyecto se abren en el lenguaje de Jitterbit Script por defecto. El lenguaje se puede cambiar a JavaScript utilizando el menú Tipo de Script:

tipo de script

Los scripts creados dentro de una transformación, ya sea en un campo de destino o en un nodo, están limitados al lenguaje de Jitterbit Script.

Alternar modos de script

Los scripts se abren en modo de edición por defecto. Para abrir el script en modo de prueba, utiliza el interruptor en la parte superior derecha para seleccionar Prueba:

editar prueba

Para más detalles, consulta Pruebas de script.

Estado de guardado

Después de realizar cambios en un script, guarda el script utilizando Control+S (Windows o Linux) o Command+S (macOS).

El estado de guardado se muestra en la parte superior del script, debajo del nombre del script. Estos estados son posibles:

  • Guardado
  • Tienes cambios no guardados
  • Guardando...
  • Script no guardado debido a un conflicto con otro usuario

Para aprender más sobre el guardado automático, consulta Permisos de Integration Studio, colaboración y guardado.

Validación de script

La validación de un script se verifica con cada pulsación de tecla.

Cuando un script es válido, se muestra un mensaje El script es válido en verde:

el script es válido

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

mensaje de error truncado

Para ver el mensaje de error completo, haz clic en el ícono de expandir . El mensaje de error completo se abre en un 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:

redimensionar cuadro de mensaje de error

Paleta de componentes de script

La paleta de componentes de script 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 script proporcionan acceso a varios componentes que se pueden utilizar dentro de un script:

paleta de componentes de script

Para colapsar la paleta de componentes de script, haga clic en el ícono de colapso ubicado en la parte superior derecha de la paleta. Cuando está colapsada, puede expandir la paleta de componentes de script 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 una cadena de palabras clave. Para borrar la búsqueda, haga clic en el ícono de eliminar .

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

Pestaña
 Descripción
Objetos de origen La pestaña Objetos de origen está presente solo para scripts creados dentro de una transformación. Dado que este tipo de script está limitado a aquellos que utilizan el lenguaje Jitterbit Script, hacer referencia a objetos de origen en scripts escritos en JavaScript no es aplicable.

Dentro de un script 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 una ruta de referencia de campo o nodo a un script de transformación (solo Jitterbit Script), use uno de estos métodos:

  • Arrastre el objeto desde la paleta al script 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 script.
  • 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 script para el lenguaje seleccionado en el script (ya sea Jitterbit Script o JavaScript). Dentro de un script, puede usar funciones insertando la sintaxis de función apropiada para el lenguaje del script.

Para agregar la sintaxis de función a un script (Jitterbit Script o JavaScript), use uno de estos métodos:

  • Arrastre la función desde la paleta al script para insertar la sintaxis de función.
  • Haga doble clic en la función en la paleta para insertar la sintaxis de función en la ubicación del cursor dentro del script. Al insertar la sintaxis de 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 función.
  • Ingrese manualmente la sintaxis de 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 a lo largo de un proyecto, incluyendo variables globales, variables de proyecto y variables de Jitterbit. Dentro de un script, puede usar variables insertando la sintaxis de variable.

Para agregar la sintaxis de variable a un script (Jitterbit Script o JavaScript), use uno de estos métodos:

  • Arrastre la variable desde la paleta al script para insertar la sintaxis de variable.
  • Haga doble clic en la variable en la paleta para insertar la sintaxis de variable en la ubicación del cursor dentro del script.
  • 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 variable.
  • Ingrese manualmente la sintaxis de variable.
Para obtener detalles adicionales, 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 script. Dentro de un script, puede usar un plugin como argumento para la función RunPlugin insertando la ruta de referencia del plugin.

Para agregar una ruta de referencia de plugin a un script (solo Jitterbit Script), use uno de estos métodos:

  • Arrastre el plugin desde la paleta al script para insertar tanto la función RunPlugin como la referencia del plugin.
  • Haga doble clic en el plugin en la paleta para insertar la referencia del plugin en la ubicación del cursor dentro del script.
  • Comience a escribir el nombre del plugin y luego presione Control+Space para mostrar una lista de sugerencias de autocompletar. Seleccione un plugin para insertar la referencia del plugin.
  • Ingrese manualmente la referencia del plugin.
Para obtener detalles adicionales, consulte Plugins en Jitterbit Script.
Operaciones Esta pestaña proporciona una lista de operaciones en el proyecto que están disponibles para hacer referencia en un script. Dentro de un script, puede usar 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 script (solo Jitterbit Script), use uno de estos métodos:

  • Arrastre la operación desde la paleta al script para insertar tanto la función RunOperation como 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 script.
  • 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 La pestaña Notificaciones proporciona una lista de notificaciones en el proyecto que están disponibles para hacer referencia en un script. Dentro de un script, puede hacer referencia a una notificación como argumento para la función SendEmailMessage insertando la ruta de referencia de la notificación.

Para agregar una ruta de referencia de notificación a un script (solo Jitterbit Script), use uno de estos métodos:

  • Arrastre la notificación desde la paleta al script para insertar tanto la función SendEmailMessage como 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 script.
  • 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 un ejemplo, consulte Notificaciones en Jitterbit Script.
Scripts La pestaña Scripts proporciona una lista de todos los demás scripts de componentes de proyecto independientes en el proyecto, escritos en Jitterbit Script o JavaScript, que están disponibles para hacer referencia en un script. Dentro de un script, puede hacer referencia a otro script como argumento para la función RunScript insertando la ruta de referencia del script.

Para agregar una ruta de referencia de script a un script (solo Jitterbit Script), use uno de estos métodos:

  • Arrastre el script desde la paleta al script para insertar tanto la función RunScript como la referencia del script.
  • Haga doble clic en el script en la paleta para insertar la referencia del script en la ubicación del cursor dentro del script.
  • Comience a escribir el nombre del script y luego presione Control+Space para mostrar una lista de sugerencias de autocompletar. Seleccione un script para insertar la referencia del script.
  • Ingrese manualmente la referencia del script.
Para un ejemplo, consulte Scripts en Jitterbit Script.

Nota

Mientras un Jitterbit Script puede llamar a un JavaScript, lo contrario no es cierto. Un JavaScript de Jitterbit no puede llamar a otro script de ningún lenguaje.
Puntos finales La pestaña Puntos finales proporciona una lista de puntos finales en el proyecto que están disponibles para hacer referencia en un script. Dentro de un script, puede hacer referencia a puntos finales como argumento para funciones insertando la ruta de referencia de la conexión o actividad.

Para agregar una ruta de referencia de conexión o actividad a un script (Jitterbit Script o JavaScript), use uno de estos métodos:

  • Arrastre la conexión o actividad desde la paleta al script 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 script.
  • 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 apropiada.
  • Ingrese manualmente la referencia de conexión o actividad.
Dependiendo del punto final, 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 Puntos finales en Jitterbit Script o Puntos finales en JavaScript.

Script

El área de script es el área de texto donde se ingresa un script utilizando el lenguaje apropiado: Jitterbit Script o JavaScript.

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

En JavaScript, los scripts deben estar encerrados dentro de una etiqueta de apertura <javascript> y una etiqueta de cierre </javascript>.

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

  • 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 colocas 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 de script.

  • Auto-validación: Harmony proporciona una verificación básica de sintaxis y resalta las líneas con errores. Si el script pasa la validación básica de sintaxis, una línea debajo del área de script indica El script es válido. Si el script no pasa la validación básica de sintaxis, se proporciona información específica sobre el error aquí, una línea a la vez. Es decir, después de resolver un error en una línea, se pueden informar errores de sintaxis adicionales a resolver para las líneas siguientes.

  • Arrastrar y soltar: Arrastra componentes desde la paleta y suéltalos en el área de script o en un campo de destino para insertarlos automáticamente con la sintaxis adecuada.

  • Auto-completado: A medida que escribes, puedes mostrar sugerencias de autocompletado que comienzan con la cadena ingresada utilizando Control+Espacio. Cuando solo hay una sugerencia disponible, se inserta automáticamente. Cuando hay más de una sugerencia disponible, puedes navegar por la lista utilizando las teclas de flecha del teclado y presionar Enter o Tab para insertar la sugerencia en el área de script.

  • Sangrado de bloque: Cuando se selecciona una línea completa o líneas, presionar Tab sangra las líneas seleccionadas un espacio de tabulación a la derecha. De manera similar, Shift+Tab mueve las líneas seleccionadas un espacio de tabulación a la izquierda. Si no se selecciona texto, Shift+Tab mueve la línea hacia la izquierda hasta donde está el cursor.

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