• Utilizzare la scheda Note per documentare lo scopo e il funzionamento delle regole di automazione. Questo rende le regole piu facili da mantenere e facilita la collaborazione tra utenti.
• Per modificare il modello a cui si applica la regola di automazione, cambiare modello prima di fare clic su Automazioni negli strumenti di personalizzazione, oppure attivare la modalita sviluppatore, creare o modificare una regola di automazione e selezionare il Modello nel modulo Regole di automazione.
• Le regole di automazione possono essere create da qualsiasi fase kanban facendo clic sull'icona ingranaggio che appare passando il mouse sul nome della fase kanban, poi selezionando Automazioni. In questo caso, il Trigger e impostato su La fase e impostata su per impostazione predefinita, ma puo essere modificato se necessario. ::

Trigger

Il Trigger viene utilizzato per definire quale tipo di evento deve verificarsi affinche la regola di automazione venga eseguita. I trigger disponibili dipendono dal modello. Cinque categorie di trigger sono disponibili in totale:

• Valori aggiornati
• Eventi email
• Condizioni temporali
• Personalizzato
• Esterno

Aggiunta di condizioni

I filtri di dominio consentono di determinare i record su cui una regola di automazione deve agire o quelli da escludere. Un filtraggio efficiente migliora le prestazioni complessive poiche evita elaborazioni non necessarie su record non coinvolti dalla regola.A seconda del trigger scelto, e possibile definire una o piu condizioni che un record deve soddisfare prima e/o dopo il verificarsi di un trigger.

• Il Dominio prima dell'aggiornamento definisce le condizioni che un record deve soddisfare prima del verificarsi dell'evento trigger, ad esempio il record deve avere Tipo = Fattura cliente e Stato = Registrato.
  Con la modalita sviluppatore attivata, fare clic su Modifica dominio, se disponibile, poi su Nuova regola.
• Il dominio Applica su definisce le condizioni che un record deve soddisfare dopo il verificarsi dell'evento trigger, ad esempio la fattura cliente deve avere Stato pagamento = Parzialmente pagato.
  Con la modalita sviluppatore attivata, fare clic su Modifica dominio poi su Nuova regola.

Quando si verifica un trigger, ad esempio lo stato di pagamento di una fattura cliente registrata viene aggiornato, la regola di automazione verifica le condizioni definite e esegue l'azione solo se il record soddisfa tali condizioni.

Valori aggiornati

Attiva azioni automatizzate quando si verificano modifiche specifiche nel database. I trigger disponibili in questa categoria dipendono dal modello e si basano su modifiche comuni, come l'aggiunta di un tag specifico (ad esempio a un'attivita) o l'impostazione del valore di un campo (ad esempio l'impostazione del campo Utente).Selezionare il trigger, poi selezionare un valore se richiesto.

Eventi email

Attiva azioni automatizzate alla ricezione o all'invio di email.

Condizioni temporali

Attiva azioni automatizzate in un momento relativo a un campo data o alla creazione o aggiornamento di un record. Sono disponibili i seguenti trigger:

• In base al campo data: l'azione viene attivata un periodo di tempo definito prima o dopo la data del campo data selezionato, ad esempio 30 giorni prima della data di fine contratto.
• Dopo la creazione: l'azione viene attivata un periodo di tempo definito dopo la creazione e il salvataggio di un record.
• Dopo l'ultimo aggiornamento: l'azione viene attivata un periodo di tempo definito dopo la modifica e il salvataggio di un record esistente.

Per configurare un trigger Condizioni temporali, con la modalita sviluppatore attivata:

1. Selezionare il Trigger appropriato dalla categoria Condizioni temporali. Se si seleziona il trigger In base al campo data, selezionare il campo data pertinente.
2. Configurare il Ritardo per determinare la data e ora di esecuzione delle azioni. Per farlo, inserire il numero di Minuti, Ore, Giorni o Mesi dopo i quali l'azione deve essere attivata. Se si e selezionato il trigger In base al campo data, l'azione puo essere attivata Dopo o Prima del campo data selezionato.
3. Facoltativamente, aggiungere condizioni che il record deve soddisfare prima e/o dopo l'attivazione della regola.
4. Fare clic su Salva manualmente.
5. Fare clic su Azione pianificata per aprire l'azione pianificata Regole di automazione: verifica e esegui.

6. Fare clic su Esegui manualmente in alto a sinistra.

7. Fare clic sul nome della regola di automazione nelle briciole di pane per tornare alla configurazione della regola di automazione.
8. Aggiungere le azioni da eseguire, poi, quando tutte le azioni sono state definite, fare clic su Salva manualmente.

L'azione viene eseguita la prima volta che l'azione pianificata Regole di automazione: verifica e esegui viene eseguita dopo il raggiungimento della data e ora di esecuzione e quando le condizioni sono soddisfatte.

Logica di esecuzione

Quando si utilizza un trigger basato sul tempo, un'azione viene eseguita solo quando la data e ora di esecuzione cade tra l'ultima esecuzione dell'azione pianificata e l'esecuzione corrente (pianificata o eseguita manualmente), cioe:ultima esecuzione --> data e ora di esecuzione --> esecuzione corrente

Personalizzato

Attiva azioni automatizzate:

• Alla creazione: quando un record viene salvato per la prima volta.
• Alla creazione e modifica: quando un record viene salvato per la prima volta e ogni volta successiva.
• All'eliminazione: quando un record viene eliminato.
• Al cambio nell'interfaccia: quando il valore di un campo viene modificato nella vista Modulo, anche prima che il record venga salvato.

Per i trigger Alla creazione e modifica e Al cambio nell'interfaccia, e necessario selezionare i campi da utilizzare per attivare la regola di automazione nel campo Quando si aggiorna.Facoltativamente, e anche possibile definire condizioni aggiuntive da soddisfare per attivare la regola di automazione nel campo Applica su.

Esterno

Attiva azioni automatizzate in base a un evento specifico in un sistema o applicazione esterna tramite un webhook.Dopo che il webhook e stato configurato in Laundry ERP, dove viene generato l'URL del webhook e definito il record di destinazione, deve essere implementato nel sistema esterno.

Azioni

Una volta definito il trigger della regola di automazione, fare clic su Aggiungi un'azione nella scheda Azioni da eseguire per definire le azioni da eseguire.

Aggiorna record

Questa azione viene utilizzata per aggiornare uno dei campi (correlati) del record. Sono disponibili le seguenti opzioni:

• Aggiorna: aggiorna il campo selezionato con il valore specificato.
• Aggiorna con IA: aggiorna il campo selezionato in modo dinamico basandosi sul prompt IA fornito. Questa opzione richiede l'installazione dell'app Laundry ERP AI.
• Sequenza: aggiorna il campo selezionato con una sequenza definita.
• Calcola: aggiorna il campo selezionato in modo dinamico utilizzando codice Python.

Per definire l'azione:

1. Con l'opzione Aggiorna, Aggiorna con IA, Sequenza o Calcola selezionata, a seconda del caso, selezionare o cercare il campo da aggiornare o calcolare. Se necessario, fare clic sulla freccia destra accanto al nome del campo per accedere all'elenco dei campi correlati.
2. Fornire le informazioni pertinenti in base all'opzione selezionata.

Aggiorna

Selezionare o inserire il valore aggiornato per il campo.Se si aggiorna un campo many2many, scegliere se il campo deve essere aggiornato Aggiungendo, Rimuovendo o Impostandolo su il valore selezionato oppure Svuotandolo.

Aggiorna con IA

Inserire un prompt per istruire l'IA di Laundry ERP su come aggiornare il campo. Digitare / per aprire gli strumenti prompt IA; utilizzare Selettore campo per indicare all'IA quali campi correlati controllare per il contesto, e Selettore record per fornire i valori possibili per il campo aggiornato.

Sequenza

Selezionare una sequenza esistente oppure, per creare una nuova sequenza:

1. Fare clic su Cerca altro, poi su Nuovo.
2. Nella finestra che si apre, inserire il Nome della sequenza.
3. Nella scheda Sequenza, configurare la sequenza:

• Prefisso: caratteri aggiunti prima del prossimo numero nella sequenza.
• Suffisso: caratteri aggiunti dopo il prossimo numero nella sequenza.
• Dimensione sequenza: determina il numero di cifre in ogni numero della sequenza. Se necessario, vengono aggiunti zeri iniziali prima del numero per raggiungere la dimensione della sequenza indicata, ad esempio per una dimensione di 5, il primo numero della sequenza e 00001.
• Passo: determina gli incrementi tra i numeri nella sequenza.
• Prossimo numero: il prossimo numero che verra utilizzato nella sequenza, senza zeri iniziali.

4. Fare clic su Salva.

Calcola

Inserire il codice da utilizzare per calcolare il valore del campo.

Crea record e Duplica record

Queste azioni vengono utilizzate per creare un record nuovo o duplicato su qualsiasi modello.Per definire l'azione:

1. Con Crea record o Duplica record selezionato come Tipo di azione, a seconda del caso, selezionare il modello richiesto nel campo Record da creare; il campo contiene il modello corrente per impostazione predefinita.
2. Specificare un Nome per il record oppure, se l'azione duplica un record, indicare il record da duplicare nel campo Duplica da.
3. Se il record nuovo o duplicato viene creato su un altro modello, selezionare un campo nel campo Campo di collegamento per collegare il record che ha attivato la creazione del record nuovo o duplicato.

Crea attivita

Questa azione viene utilizzata per pianificare una nuova attivita collegata al record.Per definire l'azione:

1. Con Crea attivita selezionato come Tipo di azione, selezionare il Tipo di attivita appropriato dal menu a discesa.
2. Inserire un Titolo.
3. Indicare entro quando l'attivita deve essere completata specificando un numero di Giorni, Settimane o Mesi nel campo Scadenza tra.
4. Selezionare un Tipo di utente:

• Per assegnare sempre l'attivita allo stesso utente, selezionare Utente specifico, poi aggiungere l'utente nel campo Responsabile.
• Per selezionare dinamicamente un utente collegato al record, selezionare Utente dinamico (basato sul record). Se necessario, modificare il Campo utente facendo clic sul nome del campo segnaposto e selezionando o cercando il campo utente nell'elenco che appare. Fare clic sulla freccia destra accanto al nome del campo per accedere ai campi correlati se necessario.

5. Facoltativamente, aggiungere una Nota per fornire ulteriori informazioni sull'attivita.

Invia email e Invia SMS

Queste azioni vengono utilizzate per inviare un'email o un messaggio di testo a un contatto collegato a un record specifico.Per definire l'azione:

1. Con Invia email o Invia SMS selezionato come Tipo di azione, a seconda del caso, selezionare o creare un Modello email o Modello SMS.
2. Nel campo Invia email come o Invia SMS come, scegliere come si desidera inviare l'email o il messaggio di testo.

Per un'email, selezionare:

• Email: per inviare il messaggio come email ai destinatari del Modello email.
• Messaggio: per pubblicare il messaggio sul record e notificare i follower del record.
• Nota: per inviare il messaggio come nota interna visibile agli utenti interni nel chatter.

Per un messaggio di testo, selezionare:

• SMS (senza nota): per inviare il messaggio come SMS ai destinatari del Modello SMS.
• SMS (con nota): per inviare il messaggio come SMS ai destinatari del Modello SMS e pubblicarlo come nota interna nel chatter.
• Solo nota: per pubblicare solo il messaggio come nota interna nel chatter.

Invia WhatsApp

Questa azione viene utilizzata per inviare un messaggio WhatsApp a un contatto collegato a un record specifico.Con Invia WhatsApp selezionato come Tipo di azione, selezionare il Modello WhatsApp appropriato dal menu a discesa.

Aggiungi follower e Rimuovi follower

Questa azione viene utilizzata per iscrivere/disiscrivere contatti esistenti come follower del record.Con Aggiungi follower o Rimuovi follower selezionato come Tipo di azione, a seconda del caso, selezionare un Tipo di follower:

• Per aggiungere/rimuovere sempre gli stessi contatti, selezionare Follower specifici e selezionare i contatti dal menu a discesa. E possibile aggiungere/rimuovere piu contatti.
• Per aggiungere/rimuovere dinamicamente un contatto collegato al record, selezionare Follower dinamici. Se necessario, modificare il Campo follower facendo clic sul nome del campo segnaposto e selezionando o cercando il campo partner nell'elenco che appare. Fare clic sulla freccia destra accanto al nome del campo per accedere ai campi correlati se necessario.

Esegui codice

Questa azione viene utilizzata per eseguire codice Python. E possibile scrivere il codice nella scheda Codice utilizzando le seguenti variabili:

• env: ambiente su cui viene attivata l'azione
• model: modello del record su cui viene attivata l'azione; e un recordset vuoto
• record: record su cui viene attivata l'azione; puo essere vuoto
• records: recordset di tutti i record su cui viene attivata l'azione in modalita multipla; puo essere lasciato vuoto
• time, datetime, dateutil, timezone: librerie Python utili
• float_compare: funzione di utilita per confrontare numeri decimali basata su una precisione specifica
• log(message, level='info'): funzione di registrazione per annotare informazioni di debug nella tabella ir.logging
• _logger.info(message): logger per emettere messaggi nei log del server
• UserError: classe di eccezione per visualizzare messaggi di avviso rivolti all'utente
• Command: namespace per i comandi x2many
• action = {...}: per restituire un'azione

Invia notifica webhook

Questa azione viene utilizzata per inviare una richiesta API POST con i valori dei Campi selezionati all'URL del webhook specificato nel campo URL.Il Payload di esempio fornisce un'anteprima dei dati inclusi nella richiesta utilizzando i dati di un record casuale o dati fittizi se non e disponibile alcun record.

Multi azioni

Questa azione viene utilizzata per attivare piu azioni (collegate al modello corrente) contemporaneamente.Per definire le azioni:

1. Con Multi azioni selezionato come Tipo di azione, fare clic su Aggiungi un'azione.
2. Nel pop-up Aggiungi: Azioni figlie:

• selezionare una o piu azioni esistenti e fare clic su Seleziona; oppure
• fare clic su Nuovo, definire l'azione da eseguire, poi fare clic su Salva e chiudi oppure, per creare azioni aggiuntive, Salva e nuovo.

3. Ripetere quante volte necessario.