Editor de scripts en Jitterbit Studio

Introducción

En un proyecto, el editor de scripts completo se muestra para los scripts creados como un componente del proyecto. El editor de scripts en línea está presente en las transformaciones, que se puede expandir al editor de scripts completo haciendo clic en el ícono de popout 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:

editor de scripts en línea popout

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
② Estado de guardado
③ Agregar notas
④ Seleccionar el idioma del script
⑤ Alternar modos de script
⑥ Buscar y reemplazar
⑦ Revertir cambios
⑧ 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 subsiguientes 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, haz clic y edita el campo de nombre en la parte superior izquierda. Los scripts también se pueden renombrar desde estas ubicaciones:

La pestaña Flujos de trabajo del panel del proyecto (ver Menú de acciones del componente en Pestaña de flujos de trabajo del panel del proyecto).
La pestaña Componentes del panel del proyecto (ver Menú de acciones del componente en Pestaña de componentes del panel del proyecto).
El lienzo de diseño (ver Renombrar flujos de trabajo, operaciones y pasos de operación en Lienzo de diseño).

Estado de guardado

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

Si hay cambios no guardados, se muestra un * asterisco junto al nombre del script.

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

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 a los campos de nombre del script y estado de guardado. Se abre un área editable, donde puedes ingresar el texto de tu nota. Haz clic en Publicar para agregar la nota al script.

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:

Seleccionar el idioma del script

Los scripts creados como un componente de proyecto se abren en el idioma de Jitterbit Script por defecto. El idioma se puede cambiar a JavaScript utilizando el menú 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 idioma 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 Editar/Probar para seleccionar Probar.

Para más detalles, consulta Pruebas de script.

Buscar y reemplazar

Puedes buscar y reemplazar texto dentro del área de script del script actualmente abierto utilizando la herramienta de buscar y reemplazar. Haz clic en Buscar o presiona Control + F (Windows o Linux) o Command + F (macOS) para abrir la herramienta:

buscar y reemplazar

Expandir: Haz clic para expandir las opciones de Reemplazar debajo de las opciones de Buscar. Control + H (Windows o Linux) o Command + H (macOS) abre automáticamente la herramienta de buscar y reemplazar en este estado expandido.
Buscar: Ingresa una cadena para buscar en el área de script. La cadena de búsqueda se maneja de manera diferente dependiendo de los modificadores seleccionados:
- Coincidir mayúsculas y minúsculas: Haz clic para habilitar la coincidencia sensible a mayúsculas.
- Coincidir palabra: Haz clic para habilitar la coincidencia de palabras, que excluye coincidencias parciales de palabras de los resultados.
Al buscar, el Navegador de resultados muestra el número de resultados coincidentes dentro del área de script. Incluye botones Anterior y Siguiente para la navegación de resultados de búsqueda.
Reemplazar: Ingresa una cadena para reemplazar los resultados coincidentes. Los siguientes botones controlan cómo se aplica la cadena de reemplazo:
- Reemplazar: Haz clic para reemplazar el resultado de búsqueda actualmente seleccionado en el Navegador de resultados.
- Reemplazar todo: Haz clic para reemplazar todos los resultados de búsqueda a la vez.
Cerrar: Haz clic para cerrar la herramienta de buscar y reemplazar.

Revertir cambios

Puedes revertir todos los cambios realizados en el script actualmente abierto a un punto de retroceso creado cuando se abrió por última vez el editor de scripts en la sesión actual, independientemente del estado de guardado. Cerrar y volver a abrir un editor de scripts para un script creará un nuevo punto de retroceso.

Esto es útil para probar posibilidades de scripts y luego restaurar el script a su estado antes de la edición.

Haz clic en Restaurar para abrir el diálogo de Revertir cambios:

revert changes

Haz clic en Revertir para revertir los cambios al Punto de retroceso identificado o en Cancelar para cerrar el diálogo.

Validación de scripts

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

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

script is valid

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. 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:

truncated error message

El diálogo del mensaje de error se puede redimensionar haciendo clic y arrastrando la esquina inferior izquierda del diálogo.

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:

script component palette

Para colapsar la paleta de componentes de script, haz clic en el ícono de colapso ubicado en la parte superior derecha de la paleta. Cuando esté colapsada, puedes 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, utiliza el cuadro de búsqueda para ingresar una sola palabra clave o una cadena de palabras clave. Para borrar la búsqueda, haz 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, no es aplicable hacer referencia a objetos de origen en scripts escritos en JavaScript. Dentro de un script de transformación, puedes hacer referencia a datos de origen insertando la ruta de referencia de un campo, o puedes 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), utiliza uno de estos métodos: Arrastra el objeto desde la paleta al script para insertar la ruta de referencia del objeto. Haz doble clic en el objeto en la paleta para insertar la ruta de referencia del objeto en la ubicación de tu cursor dentro del script. Ingresa manualmente la ruta de referencia al objeto de origen. Para más detalles, consulta 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, puedes 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), utiliza uno de estos métodos: Arrastra la función desde la paleta al script para insertar la sintaxis de la función. Haz doble clic en la función en la paleta para insertar la sintaxis de la función en la ubicación de tu cursor dentro del script. Al insertar la sintaxis de la función, el primer argumento de la función se resalta y tu cursor se mueve al final del argumento. Comienza a escribir el nombre de la función para mostrar una lista de sugerencias de autocompletar. Selecciona una función para insertar la sintaxis de la función. Copia un ejemplo de función usando el botón Copiar código presente en la documentación del producto. Ingresa manualmente la sintaxis de la función. Para más información, consulta 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. Dependiendo de la variable, los siguientes íconos están disponibles: Editar: Visible solo para variables de proyecto al pasar el mouse. Haz clic para modificar el nombre, valor, etiqueta o descripción de la variable. Información: Visible solo para variables de proyecto al pasar el mouse. Haz clic para ver información detallada sobre la variable. Esto incluye su etiqueta, valor actual (si Enmascarar Valor está deshabilitado), y descripción (si se proporciona). Expandir/Colapsar: Visible solo para variables de proyecto y globales que están actualmente en uso. Haz clic para ver u ocultar detalles de uso, incluyendo qué componentes leen o escriben en la variable. Puedes hacer clic en el nombre de cualquier componente para abrir su pantalla de configuración mientras preservas el contexto actual de la paleta de componentes. Dentro de un script, puedes usar variables insertando la sintaxis de variable. Para agregar la sintaxis de variable a un script (Jitterbit Script o JavaScript), utiliza uno de estos métodos: Arrastra la variable desde la paleta al script para insertar la sintaxis de la variable. Haz doble clic en la variable en la paleta para insertar la sintaxis de la variable en la ubicación de tu cursor dentro del script. Comienza a escribir el nombre de la variable para mostrar una lista de sugerencias de autocompletar. Selecciona una variable para insertar la sintaxis de la variable. Ingresa manualmente la sintaxis de la variable. Para más detalles, consulta 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, puedes 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), utiliza uno de estos métodos: Arrastra el plugin desde la paleta al script para insertar tanto la función `RunPlugin` como la referencia del plugin. Haz doble clic en el plugin en la paleta para insertar la referencia del plugin en la ubicación de tu cursor dentro del script. Comienza a escribir el nombre del plugin para mostrar una lista de sugerencias de autocompletar. Selecciona un plugin para insertar la referencia del plugin. Ingresa manualmente la referencia del plugin. Para más detalles, consulta 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, puedes 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), utiliza uno de estos métodos: Arrastra la operación desde la paleta al script para insertar tanto la función `RunOperation` como la referencia de la operación. Haz doble clic en la operación en la paleta para insertar la referencia de la operación en la ubicación de tu cursor dentro del script. Comienza a escribir el nombre de la operación para mostrar una lista de sugerencias de autocompletar. Selecciona una operación para insertar la referencia de la operación. Ingresa manualmente la referencia de la operación. Para más detalles, consulta 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, puedes 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), utiliza uno de estos métodos: Arrastra la notificación desde la paleta al script para insertar tanto la función `SendEmailMessage` como la referencia de la notificación. Haz doble clic en la notificación en la paleta para insertar la referencia de la notificación en la ubicación de tu cursor dentro del script. Comienza a escribir el nombre de la notificación para mostrar una lista de sugerencias de autocompletar. Selecciona una notificación para insertar la referencia de la notificación. Ingresa manualmente la referencia de la notificación. Para un ejemplo, consulta 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, puedes hacer referencia a otro script como argumento para la función `RunScript` insertando la ruta de referencia del script. Si un script contiene variables de proyecto o globales, un botón de Expandir/Colapsar será visible. Haz clic para ver u ocultar la lista de variables de proyecto y globales presentes en ese script. Para agregar una ruta de referencia de script a un script (solo Jitterbit Script), utiliza uno de estos métodos: Arrastra el script desde la paleta al script para insertar tanto la función `RunScript` como la referencia del script. Haz doble clic en el script en la paleta para insertar la referencia del script en la ubicación de tu cursor dentro del script. Comienza a escribir el nombre del script para mostrar una lista de sugerencias de autocompletar. Selecciona un script para insertar la referencia del script. Ingresa manualmente la referencia del script. Para un ejemplo, consulta Scripts en Jitterbit Script. Nota Mientras que 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, puedes hacer referencia a puntos finales 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 script (Jitterbit Script o JavaScript), utiliza uno de estos métodos: Arrastra la conexión o actividad desde la paleta al script para insertar la referencia apropiada. Haz doble clic en la conexión o actividad en la paleta para insertar la referencia apropiada en la ubicación de tu cursor dentro del script. Comienza a escribir el nombre de la conexión o actividad para mostrar una lista de sugerencias de autocompletar. Selecciona una conexión o actividad para insertar la referencia apropiada. Ingresa manualmente la referencia de conexión o actividad. Dependiendo del punto final, puedes usar la pestaña Funciones para agregar funciones para las cuales usar la referencia de conexión o actividad como argumento. Para más detalles, consulta Puntos finales en Jitterbit Script o Puntos finales en JavaScript.

Área de 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:

Numeración de líneas: Los números de línea se muestran a lo largo del margen izquierdo 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. Al usar Jitterbit Script, los colores de las variables se basan en su tipo:
- Local: localVariableBlue
- Global: $globalVariableOrange
- Project: $projectVariableBlack
- Jitterbit: $jitterbit.variable.green
Resaltado de nombres de variables: Si haces doble clic en el nombre de una variable en el área de script, todas las referencias a ella se resaltan para mayor visibilidad:
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: (), [], {}.
Arrastrar y soltar: Arrastra componentes desde la paleta de componentes y suéltalos en el área de script o en un campo de destino para insertarlos automáticamente con la sintaxis adecuada. Indicadores visuales muestran dónde puedes soltar el componente.
Auto-validación: Harmony proporciona 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, pueden informarse errores de sintaxis adicionales que deben resolverse en líneas posteriores.
Auto-completado: A medida que escribes, se muestran sugerencias de autocompletado. Si las sugerencias están ocultas, presiona Control + Espacio para revelarlas nuevamente. 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.
Comentarios en el código: Cuando se selecciona una línea completa o múltiples líneas de código, presiona Control + / (Windows o Linux) o Command + / (macOS) para aplicar el formato de comentario (//) a las líneas seleccionadas.
Navegación de referencias: Cuando hay referencias de script u operación presentes en un área de script utilizando funciones como RunScript o RunOperation, haz clic con Control (Windows o Linux) o Command (macOS) en la referencia para navegar directamente a ella en el lienzo de diseño:

Nota

La navegación de referencias en el área de script guarda automáticamente el estado actual del script.
Renombrado inteligente de variables: Haz clic derecho en el nombre de una variable de proyecto o variable global en el área de script para renombrar la variable seleccionada y todas las referencias existentes a ella con la opción Renombrar variable en el menú contextual que aparece:

Haz clic en Renombrar variable para habilitar el modo de renombrado, resaltando todas las referencias a la variable seleccionada para renombrar:

Presiona Enter después de renombrar la variable seleccionada a un nombre válido para mostrar el cuadro de diálogo de confirmación Cambiar nombre de variable:

Haz clic en Renombrar para actualizar todas las referencias en el script actualmente abierto y en los otros componentes listados en el cuadro de diálogo de confirmación. Esta lista puede incluir otros scripts y conexiones y actividades de conectores.

Haz clic en Cancelar para regresar al modo de renombrado sin confirmar ningún cambio. Para salir del modo de renombrado y restaurar el nombre anterior de la variable, haz clic en cualquier parte del área del script y presiona Escape.
Referencia de atajos: Presiona Control + Shift + / (Windows o Linux) o Command + Shift + / (macOS) para revelar un popup de referencia de atajos que lista varios atajos explicados en esta página.

Además, se pueden utilizar las funciones estándar del navegador para controlar el tamaño de la fuente del texto para mejorar la accesibilidad.