Referencia del módulo JavaScript

Utilidades de Bridge: JavaScript

La utilidad JavaScript de Bridge sólo incluye un módulo: Ejecutar script. Utilice este módulo para escribir funciones JavaScript y activar las funciones que ha escrito.

Configurar la utilidad JavaScript

1. Inicie sesión en Bridge.
2. Vaya a la página Integraciones .
3. Busque y seleccione JavaScript.

Ejecutar módulo Script

El módulo contiene los siguientes campos, puede utilizar referencias de datos en todos ellos:

• Nombre del script: El nombre del script a ejecutar.
• Parámetros del script: Los parámetros que el script espera al ejecutarse, representados como un mapa de objetos clave: Objetos de valor.
  • Clave: El nombre del parámetro que aparece en el script.
  • Valor: El valor asignado a la clave que el script utiliza mientras se ejecuta el script.

El número de parámetros de script permitidos es ilimitado y se añade dinámicamente.

Para configurar el script que desea ejecutar:

1. Seleccione el icono del engranaje en la parte superior del módulo.
2. Amplíe la sección Scripts .
3. Seleccione Añadir a Scripts.
4. Rellene los campos Nombre del guión y Cuerpo del guión .
5. Seleccione Guardar.

Brandfolder Image

Una vez que Bridge ejecuta el módulo Ejecutar script, la siguiente información está disponible en el panel Registro de ejecución:

• Datos
  • resultado: La salida de JavaScript
• Estado: Sección que indica si el módulo funcionó o no
  • Código: El código de éxito/error que el módulo extrae de Smartsheet.
  • Mensaje: Mensaje generado por el sistema que el módulo extrae de Smartsheet. Por ejemplo, si el módulo no puede encontrar un valor, el mensaje que aparece es No encontrado
  • Estado: El estado que el módulo extrae de Smartsheet. Las etiquetas de estado que puede encontrar son Exitoso y Fallido

Ejemplos

Ejemplo 1: Hello world (Hola, mundo)

1. Crea un script en el que el Cuerpo del Script sea: return "Hola" + a.

Debes teclear return en cada script para tener una salida.

2. En el módulo, añade el parámetro a con el valor world.
3. Ejecutar flujo de trabajo:

Asegúrese de que la clave del generador de módulos coincide con el parámetro del campo Cuerpo del script . 

El valor es la entrada intercambiable. Por ejemplo, puede provenir de una salida de una respuesta anterior del módulo.

El Nombre del script no requiere comillas para las entradas de cadena, pero el Cuerpo del script sí. De lo contrario, aparecerá un mensaje de error.

Ejemplo 2: Operaciones básicas

Para concatenar dos cadenas:

1. Crear un script con el cuerpo Script: return a + b.
2. En el módulo, añade los parámetros a y b con los valores 3 y 2, respectivamente. 
3. Ejecutar flujo de trabajo:

Brandfolder Image

Este método concatena los dos valores pero no los suma. 

Brandfolder Image

Las variables establecidas a través de Bridge se tratan como cadenas.

Para sumar números:

1. Cree una secuencia de comandos con el campo Cuerpo de la secuencia de comandos: devolver Número(a) + Número(b).
2. Ejecutar flujo de trabajo:

Con los mismos parámetros del ejemplo siguiente, el resultado esta vez es 5.

Brandfolder Image

Ejemplo 3: Iterar sobre una matriz

Para este ejemplo, tenemos un flujo de trabajo con el módulo Hojas de Lista. Cuando se ejecuta el flujo de trabajo, el registro de ejecución proporciona los resultados que se muestran a continuación, donde los datos se marcan como Array [100]. Esto significa que el campo es un array.

Brandfolder Image

Es necesario ejecutar el flujo de trabajo para obtener la información del registro de ejecución.

1. Seleccione los tres puntos situados junto a los datos y, a continuación, seleccione Copiar referencia de datos.

Brandfolder Image

2. Añade un nuevo módulo Ejecutar Script al flujo de trabajo.
3. Cree un nuevo script JavaScript. Para este ejemplo, lo llamamos getFirstElementOfListSheets, y el Cuerpo del Script es returnlistSheets[0]. Devuelve el primer elemento de la matriz de datos.

El número entre corchetes define qué elemento de la matriz se devuelve. 0 devuelve la primera, 1 devuelve la segunda, y así sucesivamente.

En el módulo JavaScript:

4. Establece getFirstElementOfListSheets como Nombre de Script.
5. Añade un parámetro de script con la Clave #1 llamado listSheets.
6. Pegue la referencia de datos copiada en el Paso 1 en el Valor nº 1

Brandfolder Image

Si ejecutamos el flujo de trabajo, el registro de ejecución proporciona los siguientes resultados. 

Brandfolder Image

Los elementos situados debajo del resultado forman parte del primer elemento de la matriz.

Limitaciones del producto o de la función

• Solo puede procesar solicitudes y respuestas de carga útil de 6 MB.

  Esto está sujeto a cambios con las próximas actualizaciones.

• No se valida el script durante su creación. Si un script tiene errores, es responsabilidad del desarrollador depurar/corregir cualquier problema o error que se genera durante la ejecución del script.
• El equipo de Smartsheet no realiza un seguimiento ni gestiona las versiones y el historial de los scripts.
• Bridge es adecuado para un evento o flujos de trabajo basados en cronogramas fijos. No sustituye la funcionalidad de la sincronización unidireccional o bidireccional proporcionada por los conectores. Por diseño, Bridge no garantiza el orden ni conserva estados sobre los cambios realizados en un sistema u otro. Por lo tanto, las configuraciones similares a los conectores no son confiables y no se aconsejan.