.. _package/email/configurazione: 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. .. image:: /_static/images/email/package-email-input.jpg :width: 100% :align: center **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. .. hint:: 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. .. hint:: 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 ~~~~~~ .. image:: /_static/images/email/package-email-output.jpg :width: 500px :align: center **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. .. hint:: Flaggare questo check è obbligatorio per tenere traccia dei record relativi alle `e-mail automatiche`_. 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. .. hint:: L'uso combinato di ``Sending limit`` e del :ref:`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. .. hint:: 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: .. image:: /_static/images/email/package-email-messaggi.jpg :width: 100% :align: center 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 .. sectionauthor:: Riccardo Brazzale / Davide Paci