Versioni e condivisione

Le automazioni mantengono una netta separazione tra la bozza che stai modificando e ciò che gira davvero, e possono spostarsi tra aree di lavoro sotto forma di file JSON portatile.

Panoramica rapida

1. Continua a modificare la bozza in libertà: mentre lavori, nulla di ciò che è attivo cambia.
2. Fai clic su Activate per convalidare la bozza, salvarne uno snapshot come nuova versione pubblicata e passare a eseguirla.
3. Usa Export su qualsiasi automazione per scaricarla come file JSON.
4. Usa Import per trasformare di nuovo un file JSON in una nuova automazione in bozza.

Riferimento dettagliato

Bozza e versione pubblicata

Il motore non esegue mai direttamente la tua bozza attiva. Ogni volta che attivi, la bozza corrente viene convalidata e, se supera i controlli, salvata come snapshot numerato e immutabile; a quel punto l'automazione punta a quello snapshot e ogni nuova esecuzione lo utilizza. In seguito puoi continuare a modificare la bozza, pubblicare a metà di una revisione oppure lasciarla com'è: niente di tutto questo tocca la versione attualmente in esecuzione finché non attivi di nuovo.

Ognuno di quegli snapshot viene conservato, non solo l'ultimo, così il grafo esatto usato da una data esecuzione non va mai perso, nemmeno dopo che hai attivato diverse altre volte.

Export

Dettaglio	Comportamento
Dove	Il menu della riga di qualsiasi automazione nella vista tabella (elenco) della panoramica
Formato	Un file .json che porta il nome dell'automazione
Contenuto	Nome, descrizione, tipo di trigger, il grafo della bozza corrente, i tag e le impostazioni
Esclude	Id, cronologia delle esecuzioni e log dei passaggi, così il file è portatile e non un backup legato a questa area di lavoro

Import

Dettaglio	Comportamento
Dove	Un pulsante Import nella barra degli strumenti della panoramica
Accetta	Un file .json esportato allo stesso modo
Risultato	Una nuova automazione in bozza, con il nome dell'originale seguito dal suffisso "(imported)", aperta direttamente nel builder
Convalida	Solo strutturale all'importazione; la pubblicazione (Activate) riconvalida il grafo per intero

Condivisione all'interno dell'area di lavoro

Le automazioni non sono personali. Ogni automazione che crei è visibile, modificabile ed eseguibile da chiunque altro abbia accesso alla tua area di lavoro; la colonna del proprietario nella panoramica serve solo a distinguere le automazioni che hai creato tu da quelle create da un collega.

Come usarlo

Procedura: testare una modifica rischiosa senza toccare ciò che è attivo

1. Apri l'automazione e apporta le modifiche alla bozza; nulla di ciò che è attivo cambia ancora, anche se poi esci dal builder.
2. Fai clic su Test tutte le volte che vuoi mentre iteri. Ogni Test riconvalida e pubblica una nuova versione esattamente come fa Activate, ma non tocca lo stato dell'automazione, che resta dov'era: Draft, Active o Paused.
3. Quando sei soddisfatto del risultato, fai clic su Activate per rendere questa la versione che il trigger reale esegue davvero.
4. Se non sei soddisfatto, continua a modificare la bozza. Niente di ciò che hai testato è attivo finché non lo attivi esplicitamente, a prescindere da quante volte hai premuto Test.

Procedura: spostare un'automazione in un'altra area di lavoro

1. Nell'area di lavoro di origine, apri il menu della riga dell'automazione nella vista tabella (elenco) e fai clic su Export; viene scaricato un file .json con il nome dell'automazione.
2. Apri la panoramica Automations dell'area di lavoro di destinazione e fai clic su Import nella barra degli strumenti; scegli quel file.
3. Viene ricreata come nuova Draft, con il suffisso "(imported)" nel nome, e si apre direttamente nel builder così puoi controllarla.
4. Completa ciò che l'esportazione non porta con sé: l'automazione non è ancora Active, attivala dopo averla rivista, e se usa un trigger Incoming webhook, il suo URL è diverso da quello originale (nuovo id dell'automazione), quindi aggiorna qualsiasi mittente esterno che puntava al vecchio.

Attività comuni

• Salvare uno snapshot di un'automazione funzionante come assicurazione prima di una revisione rischiosa. Esportala per prima cosa. Al momento nel builder non esiste un controllo per sfogliare le versioni o ripristinarle, quindi un file JSON esportato è il modo pratico per tornare a uno stato noto e funzionante se la revisione va male, reimportandolo come nuova bozza oppure ricopiando manualmente i campi in quella corrente.
• Dare a un collega un punto di partenza senza toccare il tuo originale. Esporta e passagli il file, oppure usa Duplicate se siete entrambi nella stessa area di lavoro.
• Promuovere un'automazione collaudata da staging a produzione. Esportala dall'area di lavoro di staging, importala in produzione, rivedi la bozza risultante e poi fai Activate.

Risoluzione dei problemi

• Ho premuto Test molte volte mentre iteravo e ora ho una lunga cronologia di versioni. È previsto: Test riconvalida e pubblica sempre una nuova versione esattamente come fa Activate, quindi un pomeriggio di iterazioni su una sola automazione può produrre molte versioni, anche se solo quella che hai attivato per ultima è davvero attiva.
• Voglio tornare a una versione precedente. Al momento nel builder non esiste un controllo per la cronologia delle versioni o il ripristino. Il ripiego pratico è aver esportato l'automazione prima della modifica, così puoi reimportare quel file come bozza nuova, oppure annullare manualmente le modifiche con Ctrl/Cmd+Z nella stessa sessione di modifica.
• Un file esportato contiene qualcosa di sensibile. L'esportazione include ogni campo di ogni nodo esattamente come è configurato, compresi eventuali segreti HMAC, URL di webhook Slack/Discord e header HTTP personalizzati che hai digitato nei nodi. Tratta un file JSON esportato come una credenziale, non come un backup innocuo.
• L'automazione importata non fa nulla. L'importazione crea sempre e solo una Draft; non viene mai attivata automaticamente, quindi aprila e fai clic su Activate dopo aver rivisto il grafo.
• Un'automazione webhook importata ha smesso di ricevere chiamate. Il suo URL in entrata è costruito a partire dall'id della nuova automazione, che è diverso da quello che aveva nell'area di lavoro di origine. Aggiorna con il nuovo URL qualsiasi sistema esterno che chiamava quello vecchio.

Suggerimenti

Esporta come copia portatile

L'esportazione è il modo per spostare un'automazione in un'altra area di lavoro, o per conservarne una copia offline fuori dall'app.

L'importazione non porta con sé la cronologia

L'importazione ricrea solo il grafo e le impostazioni. Parte come bozza nuova, senza cronologia delle esecuzioni, e non viene attivata automaticamente, quindi attivala di nuovo dopo averla controllata.

Correlati

• Panoramica
• Costruire un flusso di lavoro
• Esecuzione e monitoraggio