Invio eMail

Introduzione

Questa action permette di inviare una mail, componendola ed inviandola in modo completamente automatico oppure dando ad un utente la possibilità di verificarla, eventualmente correggerla e poi inviarla.

Parametri

Modalità [IN]

Permette di specificare se si vuole un invio interattivo oppure automatico:

• Interattivo: Viene creata una attività nella to do list degli utenti specificati. L'attività verrà descritta tramite il parametro Descrizione e Note (compaiono solo in modalità interattiva). L'utente potrà visualizzare la mail e modificarla prima dell'invio. Attualmente non è prevista la possibilità di terminare l'attività senza inviare la mail.
• Automatico: Tutta la parte sopra viene saltata e il motore di workflow invierà la mail immediatamente, eseguando tutte le operazioni lato server.

Descrizione [IN]

Nella modalità interattiva, permette di dare una descrizione all'attività che si verrà a creare nella to do list. Se non viene specificato un valore l'attività verrà descritta con l'oggetto della mail e, in caso di mancanza anche di tale valore, verrà descritta con una generica descrizione di invio mail.

Note [IN]

Nella modalità interattiva, permette di definire delle note aggiuntive per l'attività che si verrà a creare nella to do list.

Account di invio [IN]

Permette di specificare quale account utilizzare per l'invio della mail. E' possibile lasciare DEFAULT ACCOUNT, nel qual caso verrà utilizzato l'account di default definito nel sistema, oppure specificare un account esplicito.

Importante: In caso di modalità interattiva l'account specificato deve essere accessibile all'utente che eseguirà l'azione, altrimenti il sistema eseguirà uno switch automatico (previo avvertimento) sul primo account cui l'utente ha accesso in invio.

Mittente [IN]

Specifica il mittente della mail.

Nota: alcuni provider di posta pongono delle restrizioni sul mittente, che ad esempio dev'essere un utente definito sul server di posta, oppure deve essere una mail con il dominio del server di posta. Per maggiori dettagli sulle regole da rispettare è necessario consultare il gestore del server di posta che si sta utilizzando.

Destinatario [IN]

Destinatari della mail. E' possibile specificare più destinatari separando gli indirizzi con il carattere punto e virgola ;.

CC [IN]

Carbon copy. Valgono le stesse considerazioni del campo Destinatario.

BCC [IN]

Blind carbon copy. Valgono le stesse considerazioni del campo Destinatario.

Oggetto [IN]

Oggetto della mail. Viene utilizzato anche come descrizione dell'attività in caso di modalità interattiva, quando non viene specificata una descrizione.

Testo [IN]

Testo della mail. Come tutti gli altri campi testuali, può essere fisso oppure contenere delle espressioni formula per generare un testo dinamicamente a runtime.

ID doc. allegati [IN]

Un parametro che specifica i pkid dei documenti contenuti nel repository documentale che devono essere utilizzati come allegati della mail.

Strategia di invio [IN]

La strategia di invio indica la modalità che il sistema segue per l'invio della mail:

• Sincrono: Mentre la mail viene inviata il sistema resta in attesa dell'esito. Quando l'operazione termina vengono tornati i valori ID messaggio e ID DAC messaggio (quando opportuno). In caso di errore è possibile intercettare l'anomalia e gestirle tramite gli strumenti del workflow.
• Asincrono: In questo caso la action pone in una coda di invio la mail e termina immediatamente. Il workflow potrà proseguire con l'iter anche se la mail non è ancora stata inviata. L'invio avverrà in un momento successivo, in funzione del carico di sistema e di altri parametri di gestione. Il vantaggio è di liberare immediatamente l'iter dall'attesa dell'invio, lo svantaggio è che non sarà possibile accedere ai valori ID messaggio e ID DAC messaggio (perchè non ancora calcolati all'atto della terminazione dell'azione) e in caso di errore il workflow non sarà in grado di intraprendere alcuna azione correttiva (dovrà farlo un amministratore di sistema, che verrà avvertito dell'anomalia).

Persistenza [IN]

Indica se salvare la mail nel database o meno. In funzione del valore di questo parametro sarà o meno disponibile l'output ID DAC messaggio.

Link al documento [IN]

Pkid dell'elemento documentale da agganciare alla mail.

Link al protocollo [IN]

Pkid del protocollo da agganciare alla mail.

ID messaggio [OUT]

Torna l'ID messaggio che il server di posta assegna al messaggio appena inviato. E' una stringa che varia da provider a provider. Viene tornata solo se la strategia di invio è Sincrono. Viene tornata anche se si sceglie di non persistere il messaggio nel database in quanto si tratta di una informazione ritornata dal server di posta.

ID DAC messaggio [OUT]

A differenza di ID messaggio, questo campo è il pkid del record che rappresenta il messaggio memorizzato nel database. E' una informazione numerica completamente scollegata con l'informazione tornata del server di posta. Viene tornato solo se la strategia di invio è Sincrono, e se si sceglie di persistere il messaggio nel database.