Script

La actividad Script utiliza JavaScript para habilitar la manipulación de datos personalizada dentro de tu flujo de trabajo. Se integra en los flujos de trabajo de la API, lo que te permite:

• Extraer, formatear y reestructurar las respuestas de la API.
• Agregar y consolidar datos.
• Realizar cálculos y transformaciones de datos.
• Estandarice los formatos de datos para pasos posteriores.
• Ejecutar dentro del contexto de ejecución del flujo de trabajo, accediendo solo a los datos del flujo de trabajo existente y a las salidas de los pasos.

Utiliza la actividad Script para refinar las respuestas de la API anidadas o fragmentadas antes de pasarlas a actividades de flujo de trabajo posteriores.

Limitaciones conocidas

• No puedes realizar llamadas a la API utilizando la actividad Script . Utiliza la actividad de solicitud HTTP en su lugar.
• La ejecución del código JavaScript tiene un tiempo de espera de 30 segundos.

Utilizar la actividad Script

Para añadir una actividad de Script a tu flujo de trabajo:

1. En el lienzo del diseñador de flujo de trabajo de la API, selecciona el icono más (+). Aparecerá el menú Añadir actividad .
2. Selecciona Script.
3. En el panel Propiedades , expande el editor de expresiones y luego escribe tu lógica JavaScript en el panel Código .
4. Depura el flujo de trabajo para ejecutar la actividad y generar campos de salida para su uso posterior.

Para un uso óptimo, utiliza las siguientes recomendaciones:

• Utiliza la declaración return para estructurar de forma eficiente las salidas JSON.
• Utiliza .map() para transformar matrices en objetos estructurados.
• Utiliza el generador de expresiones de Autopilot para generar automáticamente JavaScript en función del contexto del flujo de trabajo, minimizando el esfuerzo de codificación manual. Por ejemplo: "Obtuve respuestas de 3 llamadas HTTP, combínelas en un objeto JavaScript".

Ejemplo de actividad de script

El siguiente ejemplo consolida los datos de varios pasos del flujo de trabajo en un objeto JSON estructurado utilizando la actividad Script . Este enfoque es especialmente útil con las API de Workday, que a menudo requieren varias llamadas de punto final para recuperar conjuntos de datos completos, como detalles de empleados, gerentes e informes directos.

La siguiente imagen muestra el flujo de trabajo original, que se va a consolidar en un objeto JSON con la actividad Script.

Abre la ventana de configuración Depurar , luego pega y guarda la siguiente sintaxis JSON:

{
  "first_name": "Betty",
  "last_name": "Liu"
}

1. En el lienzo del diseñador de flujo de trabajo de la API, añade una actividad de Script .
2. Abre el editor de expresiones y pega la siguiente implementación:

   return {
   
       // Details on the worker
       worker: {
           name: $currentItem.descriptor,
           email: $currentItem.person.email
       },
   
       // Details of their manager
       manager: {
           name: $context.outputs.Workers_3.content.descriptor,
           email: $context.outputs.Workers_3.content.person.email
       },
   
           // Details for their direct reports
       reports: $context.outputs.Workday_REST_HTTP_Request_4.content.data.map(report => ({
           name: report.descriptor,
           email: report.primaryWorkEmail
       }))
   }
   

Presta atención a las siguientes áreas en este ejemplo:

• Uso de $context.outputs para recuperar datos de llamadas API anteriores.
• Uso de .map()para transformar matrices en listas estructuradas de informes.
• Combinar varias respuestas de API en un único objeto JSON.