Resumen del módulo
Adobe Workfront Fusion distingue cinco tipos de módulos:
- Módulos de acción
- Buscar módulos
- 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 realiza 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 déclencheur, los módulos de acción se pueden colocar al principio, en el centro 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 (150+) puede afectar al rendimiento.
Ejemplos:
- Workfront>Upload a file envía un archivo a Workfront y devuelve su identificador.
- Image>Resize recibe una imagen, cambia su tamaño a las dimensiones especificadas y pasa la imagen redimensionada a la siguiente acción.
El tipo de acción tiene cuatro subtipos:
- Crear
- Leer
- Actualizar
- Eliminar
El subtipo Update 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 debe confundirse 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
erase
en 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. -
Empty
no cambia el contenido del campo. Si es necesario borrar el campo, se puede utilizar la siguiente fórmula: -
Actualmente no se admite dejar un campo sin cambiar cuando su contenido se evalúa como vacío.
Buscar módulos
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 (150+) puede afectar al rendimiento.
Ejemplo:
Workfront>Read Related Records lee registros que coinciden con la consulta de búsqueda especificada, en un objeto primario concreto.
Módulos de activador
Los déclencheur generan paquetes cuando se ha producido un cambio en un servicio determinado, como la creación o actualización de un registro.
Los déclencheur devuelven cero, uno o más paquetes, que luego pasan al siguiente módulo para su procesamiento.
Debido a que los Déclencheur 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 usa dos tipos de déclencheur: déclencheur de sondeo y déclencheur instantáneos.
Activador de sondeo
Los déclencheur en encuestas encuestan con regularidad un servicio determinado aunque no haya habido cambios desde que se ejecutó el escenario anterior. 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 déclencheur, el déclencheur devuelve paquetes que contienen información sobre el cambio. Si no hay ningún cambio que coincida con la configuración, el déclencheur no genera ningún paquete.
Para obtener instrucciones sobre cómo programar un escenario, vea Programar un escenario.
Los déclencheur de sondeo le permiten seleccionar el primer paquete que debe mostrarse a través de un panel que se muestra automáticamente después de guardar un déclencheur o cambiar la configuración del déclencheur. 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 déclencheur.
Ejemplos:
-
Workfront>Watch records devuelve registros que se agregaron recientemente después de la última vez que se ejecutó el escenario.
-
Google Sheets>Watch Rows devuelve las filas nuevas agregadas después de la última vez que se ejecutó el escenario.
Activadores instantáneos
Las déclencheur instantáneas 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 déclencheur 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 déclencheur instantáneo gestiona los datos entrantes, consulte déclencheur instantáneos (webhooks).
Ejemplos:
- Workfront>Watch Events devuelve información cuando se produce un determinado tipo de evento en Workfront, como la creación de una tarea.
- Google Sheets>Watch Changes devuelve información cada vez que se actualiza una celda.
Agregadores
Un módulo Aggregator acumula varios paquetes en uno solo.
Los acumuladores solo devuelven un paquete, que luego pasa al siguiente módulo para un procesamiento posterior.
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 (150+) puede afectar al rendimiento.
Ejemplos:
- Archive>Create an archive comprime varios archivos en un archivo zip.
- CSV>Aggregate to CSV combina varias cadenas de un archivo CSV en una sola fila.
- Tools>Text aggregator combina varias cadenas en una sola.
Para obtener más información, consulte Módulo de agregado.
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 (150+) puede afectar al rendimiento.
Ejemplo:
Email>Retrieve attachments divide una matriz de archivos adjuntos en paquetes separados.
Para obtener más información, consulte Módulo iterador y Asignar una matriz.