Información general del módulo
Adobe Workfront Fusion distingue cinco tipos de módulos:
- Módulos de acción
- Módulos de búsqueda
- Módulos de activador
- Agregadores
- Iteradores
Los agregadores e iteradores son para escenarios avanzados.
Módulos de acción
Los módulos de acción son el tipo más común de módulo. Un módulo de acción típico lleva a cabo una acción y devuelve un solo paquete, que luego pasa al siguiente módulo para su procesamiento.
A diferencia de los módulos de activador, los de acción se pueden colocar al principio, al medio o al final de un escenario.
Los escenarios pueden contener un número ilimitado de módulos de acción, aunque un gran número de módulos (más de 150) puede afectar al rendimiento.
Ejemplos:
- Workfront > Cargar un archivo envía un archivo a Workfront y devuelve su identificador.
- Imagen > Cambiar tamaño recibe una imagen, la cambia a las dimensiones especificadas y pasa la imagen cambiada a la siguiente acción.
El tipo de acción tiene cuatro subtipos:
- Crear
- Leer
- Actualizar
- Eliminar
El subtipo Actualizar incluye las tres operaciones siguientes:
-
Borrar el contenido de un campo. Esta operación tiene lugar cuando el contenido del campo se evalúa como la palabra clave
erase(no confundir conempty).
-
No modificar el contenido de un campo. Esta operación se realiza cuando el campo se deja vacío o cuando el contenido del campo se evalúa como vacío (representado mediante “null” en JSON).
-
Reemplazar el contenido de un campo. Esta operación tiene lugar en todos los demás casos que no sean los dos descritos anteriormente.
-
Si no ve la palabra clave
eraseen el panel de asignación, el módulo no es un módulo de actualización o no se ha actualizado a las especificaciones más recientes para la aplicación. -
Emptyno cambia el contenido del campo. Si es necesario borrar el campo, se puede utilizar la siguiente fórmula:
-
Actualmente, no es posible dejar un campo sin cambiar cuando su contenido se evalúa como vacío.
Módulos de búsqueda
Los módulos de búsqueda devuelven cero, uno o más paquetes que luego pasan al siguiente módulo para su procesamiento.
Puede colocar módulos de búsqueda al principio, al medio o al final de un escenario.
Los escenarios pueden contener un número ilimitado de módulos de búsqueda, aunque un gran número de módulos (más de 150) puede afectar al rendimiento.
Ejemplo:
Workfront > Leer registros relacionados lee los registros que coinciden con la consulta de búsqueda especificada en un objeto principal concreto.
Módulos de activador
Los activadores generan paquetes cuando se ha producido un cambio en un servicio determinado, como la creación o actualización de un registro.
Los activadores puede devolver cero, uno o más paquetes que luego pasan al siguiente módulo para su procesamiento.
Debido a que los activadores hacen que los escenarios comiencen a ejecutarse, solo se pueden colocar al principio de un escenario.
Cada escenario solo puede contener un activador.
Workfront Fusion utiliza dos tipos de activadores: de sondeo e instantáneos.
Activadores de sondeo
Los activadores de sondeo sondean de manera regular un servicio determinado, aunque no haya habido cambios desde la ejecución anterior del escenario. Le recomendamos que programe un escenario que contenga un activador de sondeo para que se ejecute a intervalos regulares. Si hay un cambio que coincide con la configuración del activador, este devuelve paquetes que contienen información sobre el cambio. Si no se produce ningún cambio que coincida con la configuración, el activador no genera ningún paquete.
Para obtener más información sobre cómo programar un escenario, consulte Programar un escenario.
Los activadores de sondeo le permiten seleccionar el primer paquete a generar mediante un panel que se muestra automáticamente después de guardar un activador o cambiar su configuración. Esta selección solo afecta a la primera ejecución del módulo. Una vez que el módulo se ha ejecutado una vez, las ejecuciones posteriores solo inspeccionan los cambios que se producen después de la ejecución más reciente.
Para obtener más información, consulte Elegir dónde se inicia un módulo de activador.
Ejemplos:
-
Worfront > Ver registros devuelve registros que se han añadido recientemente desde la última vez que se ejecutó el escenario.
-
Google Sheets> Ver filas devuelve las nuevas filas añadidas desde la última vez que se ejecutó el escenario.
Activadores instantáneos
Los activadores instantáneos permiten que un servicio notifique a Workfront Fusion un cambio inmediatamente después de que se produzca. Le recomendamos que programe un escenario que contenga un activador instantáneo para que se ejecute de inmediato.
Para obtener instrucciones, consulte Programar un escenario.
Para obtener más información sobre cómo un activador instantáneo gestiona los datos entrantes, consulte Activadores instantáneos (webhooks).
Ejemplos:
- Workfront > Ver eventos devuelve información cuando se produce un determinado tipo de evento en Workfront, como la creación de una tarea.
- Google Sheets> Observar cambios devuelve información cada vez que se actualiza una celda.
Agregadores
Un módulo agregador acumula varios paquetes en uno solo.
Cada agregador devuelve solo un paquete, que luego pasa al siguiente módulo para su posterior procesamiento.
Puede colocar agregadores solo en medio de un escenario.
Los escenarios pueden contener un número ilimitado de agregadores, aunque un gran número de módulos (más de 150) puede afectar al rendimiento.
Ejemplos:
- Archivo > Crear un archivo comprime varios archivos en un archivo zip.
- CSV > Agregado a CSV combina varias cadenas de un archivo CSV en una sola fila.
- Herramientas > Agregador de texto combina varias cadenas en una sola.
Para obtener más información, consulte Módulo agregador.
Iteradores
Un iterador es un tipo de módulo que divide las matrices en paquetes independientes.
Los iteradores devuelven uno o más paquetes, que luego pasan al siguiente módulo para su procesamiento.
Puede colocar iteradores solamente en medio de un escenario.
Los escenarios pueden contener un número ilimitado de iteradores, aunque un gran número de módulos (más de 150) puede afectar al rendimiento.
Ejemplo:
Correo electrónico > Recuperar archivos adjuntos divide una matriz de archivos adjuntos en paquetes separados.
Para obtener más información, consulte Módulo iterador y Asignar una matriz.