Panoramica del modulo
Adobe Workfront Fusion distingue cinque tipi di moduli:
- Moduli di azione
- Moduli ricerca
- Moduli trigger
- Aggregatori
- Iteratori
Aggregatori e Iteratori sono per scenari avanzati.
Moduli di azione
I moduli di azione sono il tipo di modulo più comune. Un modulo di azione tipico esegue un’azione e restituisce un singolo bundle, che quindi passa al modulo successivo per l’elaborazione.
A differenza dei moduli di attivazione, i moduli di azione possono essere posizionati all’inizio, al centro o alla fine di uno scenario.
Gli scenari possono contenere un numero illimitato di moduli di azione, anche se un numero elevato di moduli (oltre 150) può influire sulle prestazioni.
Esempi:
- Workfront > Carica un file invia un file a Workfront e restituisce il relativo identificatore.
- Immagine > Ridimensiona riceve un'immagine, la ridimensiona in base alle dimensioni specificate e la trasmette all'azione successiva.
Il tipo di azione è costituito da quattro sottotipi:
- Creare
- Letto
- Aggiornamento
- Elimina
Il sottotipo Update include le tre operazioni seguenti:
-
Cancellare il contenuto di un campo. Questa operazione viene eseguita quando il contenuto del campo viene valutato in base alla parola chiave
erase(da non confondere conempty).
-
Lasciare invariato il contenuto di un campo. Questa operazione viene eseguita quando il campo viene lasciato vuoto o il contenuto del campo viene valutato come vuoto (rappresentato da null in JSON).
-
Sostituisci il contenuto di un campo. Questa operazione viene eseguita in tutti gli altri casi diversi da quelli sopra descritti.
-
Se non vedi la parola chiave
erasenel pannello di mappatura, il modulo non è un modulo di aggiornamento o non è stato aggiornato alle specifiche più recenti per l'app. -
Emptynon modifica il contenuto del campo. Se è necessario cancellare il campo, puoi utilizzare la seguente formula:
-
Non è al momento possibile lasciare un campo invariato quando il relativo contenuto viene valutato come vuoto.
Moduli ricerca
I moduli di ricerca restituiscono zero, uno o più bundle, che quindi passano al modulo successivo per l’elaborazione.
È possibile posizionare i moduli di ricerca all'inizio, al centro o alla fine di uno scenario.
Gli scenari possono contenere un numero illimitato di moduli di ricerca, anche se un numero elevato di moduli (oltre 150) può influire sulle prestazioni.
Esempio:
Workfront > Leggi record correlati legge i record che corrispondono alla query di ricerca specificata, in un particolare oggetto padre.
Moduli trigger
I trigger generano bundle quando si è verificata una modifica in un determinato servizio, ad esempio la creazione o l’aggiornamento di un record.
I trigger restituiscono zero, uno o più bundle, che quindi passano al modulo successivo per l’elaborazione.
Poiché i trigger determinano l’inizio dell’esecuzione degli scenari, è possibile posizionarli solo all’inizio di uno scenario.
Ogni scenario può contenere un solo trigger.
Workfront Fusion utilizza due tipi di trigger: Polling triggers e Instant triggers.
Trigger di polling
I trigger di polling eseguono regolarmente il polling di un determinato servizio anche se non sono state apportate modifiche dall’esecuzione dello scenario precedente. È consigliabile pianificare uno scenario contenente un trigger di polling da eseguire a intervalli regolari. Se una modifica corrisponde alla configurazione del trigger, quest’ultimo restituisce bundle contenenti informazioni sulla modifica. Se non vi è alcuna modifica che corrisponda alla configurazione, il trigger non restituisce alcun bundle.
Per istruzioni sulla pianificazione di uno scenario, vedere Pianificare uno scenario.
I trigger di polling consentono di selezionare il primo bundle che deve essere emesso tramite un pannello che viene visualizzato automaticamente dopo il salvataggio di un trigger o la modifica delle relative impostazioni. Questa selezione influisce solo sulla prima esecuzione del modulo. Dopo che il modulo è stato eseguito una volta, le esecuzioni successive verificano solo le modifiche che si verificano dopo l’esecuzione più recente.
Per ulteriori informazioni, vedere Scegliere la posizione di inizio di un modulo trigger.
Esempi:
-
Workfront > Osserva i record restituisce i record appena aggiunti dopo l'ultima esecuzione dello scenario.
-
Google Sheets> Righe di controllo restituisce nuove righe aggiunte dopo l'ultima esecuzione dello scenario.
Trigger istantanei
I trigger istantanei consentono a un servizio di notificare a Workfront Fusion una modifica subito dopo che si è verificata. È consigliabile pianificare uno scenario contenente un trigger istantaneo da eseguire immediatamente.
Per istruzioni, consulta Pianificare uno scenario.
Per informazioni dettagliate sulla gestione dei dati in arrivo tramite un trigger immediato, vedere Trigger istantanei (webhook).
Esempi:
- Workfront > Osserva eventi restituisce informazioni quando si verifica un determinato tipo di evento in Workfront, ad esempio la creazione di un'attività.
- Google Sheets> Osserva modifiche restituisce informazioni ogni volta che una cella viene aggiornata.
Aggregatori
Un modulo Aggregator accumula più bundle in un singolo bundle.
Gli aggregatori restituiscono un solo bundle, che quindi passa al modulo successivo per l’ulteriore elaborazione.
È possibile posizionare gli aggregatori solo nel mezzo di uno scenario.
Gli scenari possono contenere un numero illimitato di aggregatori, anche se un numero elevato di moduli (oltre 150) può influire sulle prestazioni.
Esempi:
- Archivia > Crea un archivio comprime più file in un archivio zip.
- CSV > Aggrega in CSV unisce più stringhe da un file CSV in un'unica riga.
- Strumenti > Aggregatore di testo combina più stringhe in un'unica stringa.
Per ulteriori informazioni, vedere Modulo aggregatore.
Iteratori
Un iteratore è un tipo di modulo che divide gli array in bundle separati.
Gli iteratori restituiscono uno o più bundle, che quindi passano al modulo successivo per l’elaborazione.
È possibile posizionare gli iteratori solo nel mezzo di uno scenario.
Gli scenari possono contenere un numero illimitato di iteratori, anche se un numero elevato di moduli (oltre 150) può influire sulle prestazioni.
Esempio:
E-mail > Recupera allegati suddivide un array di allegati in bundle separati.
Per ulteriori informazioni, vedere Modulo iteratore e Mappare un array.