Configurazione¶
Una volta attivato il package nell’istanza, troveremo la voce di menu Email Config
che a sua volta includerà:
Accounts, dove sarà possibile aggiungere e configurare correttamente i nostri account di posta
Messaggi, dove sarà possibile ricevere e inviare messaggi ed eventualmente monitorare la coda di invio
Tabelle di Utilità, che raccoglie le tabelle di lookup
Accounts¶
All’interno di Accounts
possiamo configurare gli account che verranno utilizzati sia per la posta in arrivo che per l’invio delle email.
È obbligatorio se vogliamo che il package email faccia il suo lavoro.
La form è suddivisa in due aree: input (per la configurazione della ricezione delle e-mail) e output (per la configurazione dell’invio delle e-mail)
Input¶
Sono i dati imap e servono per poter ricevere (leggere) le email dal nostro account.
Significato dei campi della form
Account Name
Nome account / Es: mrossi
Address
indirizzo di posta elettronica / Es: mario.rossi@gmail.com
Full Name
Nome completo / Es: Mario Rossi
Ospite
(Host) È il nome del server imap / Es: imap.gmail.com
Port
Indica il numero della porta TCP su cui collegarsi / Es: 993
TLS / SSL
(Transport Layer Security) Va selezionato se il protocollo prevede la crittografia.
(Security Sockets Layer) Va selezionato per definire che la connessione va stabilita con un link criptato.
Suggerimento
L’utilizzo dei due parametri sopra è determinato dalla configurazione del server di posta. Attualmente la maggior parte dei servizi di posta utilizza tali impostazioni.
Nome utente
È il nome utente utilizzato per connettersi al server di posta / Es: mario.rossi@gmail.com
Password
È la password di collegamento al server di posta.
Schedulable
Indica che per questo account è attiva la schedulazione di invio automatica della posta. Questa è una funzionalità aggiuntiva qui non descritta. Si consiglia di flaggare comunque il campo.
Check Mail
Una volta finita la configurazione (e salvato il record) si può stabilire una connessione di prova al server di posta per verificare che tutto sia ok.
Suggerimento
Per configurare un account Gmail in ingresso e/o in uscita a causa di recenti aggiornamenti di Google è necessario aver preventivamente attivato l’accesso da parte delle app meno sicure e aver disattivato l’autenticazione a due fattori. Si faccia riferimento al link in fondo al documento nell’area Riferimenti
Nel sottostante tab Utenti
è possibile associare un utente all’indirizzo e-mail in modo che possa autonomamente eseguire l’operazione di invio utilizzando l’account che abbiamo creato invece di un proprio account.
Per aggiungere un utente è sufficiente cliccare sull’icona in alto a destra e trascinare un utente già esistente nel tab. A quel punto flaggando l’opzione Can Send verrà abilitato per l’invio.
Output¶
Significato di campi della form
SMTP host
È l’indirizzo del server di invio posta / Es: smtp.gmail.com
From address
È l’indirizzo da cui proviene il messaggio per chi riceve / Es: learn_genropy@gmail.com
Smtp username
È il nome utente utilizzato per connettersi al server di posta / Es: mario.rossi@gmail.com
Smtp password
È la password di collegamento al server di posta.
Smtp port
Indica il numero della porta TCP su cui collegarsi / Es: 465
Save output message
Indica al sistema se i messaggi in uscita devono essere archiviati localmente.
Suggerimento
Flaggare questo check è obbligatorio per tenere traccia dei record relativi alle `e-mail automatiche</docu/index/rst/package/email/inviare_email>`_. Se non flaggato, queste verranno inviate ugualmente, ma non vi sarà traccia dell’invio all’interno del sistema.
Smtp TLS / SSL
(Smtp Transport Layer Security) Va selezionato se il protocollo prevede la crittografia.
(SMTP Security Sockets Layer) Va selezionato per definire che la connessione va stabilita con un link criptato.
System bcc
Imposta un bcc (By Carbon Copy) automatico a cui il sistema invia le email.
Sending limit
Permette di impostare un limite massimo in termini di numero di invii e-mail per volta. Può essere utile per evitare agli utenti di inviare e-mail massivamente sovraccaricando il server o per evitare le quote massime di invio.
Suggerimento
L’uso combinato di Sending limit
e del batch di invio automatico può essere utile in caso di limiti all’invio imposti dai mailserver. Ipotizziamo per esempio un limite massimo di invio di 1000 messaggi all’ora: in questo caso imposteremo il sending limit a «80» e il batch per l’invio automatico ogni 5 minuti, così da evitare il superamento della quota imposta.
Debug address
Permette di inserire un indirizzo e-mail a scopo di test.
Suggerimento
Si noti che in caso sia presente il debug address, questo andrà a sostituire il campo del destinatario della mail sia in caso di invio manuale che di invio automatizzato. Dopo i test lasciare quindi in bianco.
Messaggi¶
Qui avremo il log dei messaggi inviati e ricevuti per l’utente corrente:
Entrando in un record vedremo tutti i dettagli in merito al messaggio: destinatario (to, cc, bcc), mittente, data e ora dell’invio (se avvenuto), contenuto del messaggio, eventuali messaggi di errore, allegati.
Si noti che il record relativo al messaggio non implica necessariamente che ci sia stato un invio. Affinché questo avvenga, infatti, è necessario premere il bottone Send message
per un invio manuale o in alternativa programmare automaticamente l’invio con un’operazione pianificata.
Tabelle utilità¶
L’unica tabella di lookup attiva di default è Message type, dove è possibile creare delle categorie con le quali classificare i messaggi in uscita.
Riferimenti¶
Configurazione account Gmail: https://support.google.com/mail/answer/7126229?hl=en
Accesso App meno sicure: https://www.google.com/settings/security/lesssecureapps
Autore della sezione: Riccardo Brazzale / Davide Paci