Trigger

Ogni workflow inizia con esattamente un trigger, in cima all'editor. I passaggi sottostanti possono usare i suoi dati.

Manualmente

Gira solo quando qualcuno preme Esegui workflow. Puoi dare all'esecuzione un input facoltativo, disponibile ai passaggi come {{run.input}}.

Usalo mentre stai costruendo, e per i lavori in cui serve davvero che sia una persona a decidere che è il momento.

Secondo una pianificazione

Un orario fisso, in un fuso orario che scegli tu. Le preimpostazioni coprono le forme abituali (ogni ora, ogni giorno, nei giorni feriali, ogni settimana, ogni mese), e c'è un'opzione personalizzata che usa cron per tutto il resto.

Puoi dare alle esecuzioni pianificate un input fisso, e spegnere la pianificazione senza eliminare il workflow.

Quando succede qualcosa

Invece di aspettare un orologio, un workflow può girare quando qualcosa cambia: arriva un'email, si sposta un evento di calendario, un file atterra in una cartella di Drive, un documento compare in una delle tue raccolte.

L'elenco esatto sta crescendo, quindi controlla il selettore Quando deve essere eseguito questo workflow? nell'editor per vedere cosa è disponibile oggi per te. Quello che segue è come si comportano tutti, che è la parte che vale la pena imparare una volta sola.

Il trigger passa i suoi dati ai tuoi passaggi

Qualunque cosa abbia fatto scattare il trigger è disponibile a ogni passaggio sottostante, come {{trigger.qualcosa}}. Un trigger di calendario passa il titolo dell'evento e l'ora di inizio, un trigger di Drive passa il nome del file e il link, e così via.

Digita / in un campo qualsiasi di un passaggio per vedere cosa offre questo particolare trigger e inserirlo, invece di tirare a indovinare il nome.

Alcuni trigger passano un puntatore, non il contenuto

Vale la pena saperlo perché cambia il modo in cui costruisci il primo passaggio.

Il trigger di Gmail è l'esempio più chiaro: passa solo gli id dei messaggi, non l'oggetto o il corpo, perché Asteria Cloud non tiene una copia della tua posta. Un passaggio che deve leggere il messaggio lo fa tramite lo strumento Gmail, in quel momento.

La conseguenza pratica: a un passaggio che reagisce a un'email serve lo strumento Gmail allegato. Il trigger da solo non gli avrà passato il contenuto. Se un passaggio torna vuoto, questa è la prima cosa da controllare.

Sorvegliare una cartella o una raccolta

Due cose colgono di sorpresa.

I trigger di Drive sorvegliano solo il contenuto diretto. Un file aggiunto in una sottocartella di quella che hai nominato non li fa scattare. Puntali alla cartella dove le cose atterrano davvero.

Una raccolta è di solito condivisa, quindi un trigger su una raccolta scatta per quello che ci mettono colleghi e agenti, non solo per i tuoi caricamenti. Normalmente è proprio quello il punto, dato che è così che si lavora su un mucchio condiviso di documenti in arrivo. Significa però che una raccolta molto attiva può avviare parecchie esecuzioni.

Quando un trigger non si accende

I trigger sugli eventi hanno bisogno di una connessione funzionante, e l'editor ti dice quale pezzo manca invece di fallire in silenzio. I messaggi si dividono in tre gruppi:

Puoi risolverlo tu. Tutto ciò che ti dice di collegare o ricollegare il tuo account: vai su Profilo e poi Connessioni. Un trigger che funzionava e adesso dice di essere scollegato è quasi sempre un permesso scaduto o revocato.

Deve risolverlo un amministratore. Tutto ciò che menziona l'applicazione della tua organizzazione o la sua configurazione. Non sono cose che puoi concederti da solo, quindi manda al tuo amministratore il messaggio che stai vedendo.

La sottoscrizione non è riuscita. Spegni e riaccendi il trigger e, se persiste, chiedi al tuo amministratore.

Ogni trigger sugli eventi mostra quando è stato l'Ultimo controllo. È il modo più rapido per distinguere un trigger vivo da uno che ha smesso di ascoltare in silenzio, e vale la pena dargli un'occhiata quando un workflow "non gira da un po'".