Christian Castelli
a- a+

Spedire e-mail con ColdFusion

SPEDIRE E-MAIL CON COLDFUSION

Configurazione dei settaggi

Alcuni dei settaggi per l'inoltro delle mail che possono essere fatti in in ColdFusion Administrator sono mostrati nella figura sottostante. Per modificare tali settaggi, aprire ColdFusion Administrator e cliccare sulla voce di menu Mail.

 

mail server settings
Fig 1: voce per i settaggi del servizio di e-mail

Ecco i settaggi principali:

  • Mail Server - il server mail di default;
  • Verify Mail Server Connection - quando questo campo viene marcato, si verifica che ColdFusion possa connettersi al mail server quando si clicca sul bottone "Salva le modifiche";
  • Backup mail servers (solo per l'edizione Enterprise) - una lista di server di backup ognuno dei quali viene separato da una virgola, da usare in caso il server di default non risponda;
  • Maintain Connection to Mail Server (solo per l'edizione Enterprise) - quando è marcato, le connessioni al mail server vengono manetnute aperte dopo aver spedito un messaggio, il che migliora la performance quando si spediscono messaggi multipli;
  • Connection Timeout - il numero di secondi per aspettare una risposta dal mail server;
  • Server Port - di solito la 25.

Ecco i settaggi per il servizio di spooling:

  • Spool Interval - numero di secondi per i quali il mail server aspetta di processare la mail memorizzata;
  • Mail Delivery Threads (solo per l'edizione Enterprise) - il numero massimo di thread simultanei usati per spedire la posta memorizzata;
  • Spool mail messages for delivery - quando viene marcato, i messaggi vengono spediti al mail spooler per la consegna, se invece non viene marcato, ColdFusion tenta di consegnare i messaggi immediatamente. Generalmente, marcherete questo campo;
  • Maximum number of messages spooled to memory (solo per l'edizione Enterprise) - il numero massimo di messaggi che ColdFusion MX dovrebbe memorizzare prima di passare al disk spooling.

Qui sotto i settaggi per i servizi di logging:

  • Error Log Severity - il livello di severità degli errori SMTP che ColdFusion dovrebbe loggare nel file mail.log.
  • Log all mail messages sent by ColdFusion - quando viene marcato, tutti i messaggi vengono loggati in mailsent.log (solo i campi To, From e Subject).

Infine il settaggio per la codifica:

  • Default CFMail Charset - il set di caratteri usato dal tag . UTF-8 per la maggior parte dei linguaggi.


Usare

Le email vengono spedite attraverso il tag . La tabella sottostante mostra alcuni dei suoi attributi più comuni:

Gli attributi di

Attributi

Descrizione

to Obbligatorio. L'indirizzo del destinatario.
from Obbligatorio. L'indirizzo del mittente.
subject Obbligatorio. Il soggetto della email.
cc Gli indirizzi email che devono essere copiati.
bcc Gli indirizzi email di tipo blind copy.
replyto L'indirizzo a cui va spedita la risposta.
type HTML. Se omesso, l'email viene spedita in puro testo.
username SMTP username
password SMTP password
query Query da usare quando si spediscono email multiple.
server Indirizzo del server SMTP. Ridefinisce i settaggi in ColdFusion Administrator.
timeout Secondi dopo i quali scatta il time out. Ridefinisce i settaggi presenti in ColdFusion Administrator.

Qui sotto un semplice esempio del tag .

Es.1: SimpleMail.cfm

<cfmail to="admin@webmasterpoint.org" from="info@webmasterpoint.org" subject="Salve!">
Salve! Grazie per aver visitato il nostro sito. Arrivederci.
</cfmail>

 

<a href="/img/22/iframe_CF_email1.html" title="Vedi esempio">Vedi codice</a>;

 

Le espressioni all'interno dei simboli di cancelletto all'interno di vengono calcolate. I tag non sono obbligatori e probabilmente causerebbero un errore o risultati indesiderati. Perché questo esempio funzioni, bisogna aver settato un mail server valido in ColdFusion Administrator. Alternativamente è possibile configurare il tag in modo che selezioni il server usando gli attributi server, username e password. Il vostro mail server potrebbe anche richiedere un indirizzo del mittente valido.

L'esempio qui sotto mostra come spedire un email di conferma con .

Es.2: Register.cfm

---- Codice omesso ----
  <cfif FORM.password EQ FORM.password2>
    <cfquery name="emailcheck" datasource="#APPLICATION.datasource#">
     SELECT * FROM Users
     WHERE email='#FORM.email#'
    </cfquery>
    <cfif emailcheck.RecordCount EQ 0>
     <cfquery datasource="#APPLICATION.datasource#">
      INSERT INTO Users (firstname, lastname, email, password)
      VALUES ('#FORM.firstname#', '#FORM.lastname#', '#FORM.email#', '#FORM.password#')
     </cfquery>
     <cfset SESSION.firstname = FORM.firstname>
     <cfset SESSION.lastname = FORM.lastname>
     <cfset SESSION.userid = emailcheck.userid>
     <cfmail to="#FORM.email#" from="info@webmasterpoint.org"
           subject="Registrazione avvenuta con successo">
      Congratulazioni!  Ti sei registrato con successo in Web Master Point!
     </cfmail>
     Grazie per esserti registrato.
    <cfelse>
     <p>Sembra che tu sia gi&grave; registrato.</p>
    </cfif>
   <cfelse>
    <p class="errors"><b>La tua password non corrisponde. Per favore 
       <a href="Register.cfm">riprova</a>.
	 </p>
   </cfif>
 ---- Codice omesso ----   

 

<a href="/img/22/iframe_CF_email2.html" title="Vedi esempio">Vedi codice</a>;

 


Spedire email in HTML

Le email possono essere spedite in formato di puro testo (default) o in HTML, settando l'attributo type di ad "html" (l'unico valore possibile). E' quindi possibile usare tag HTML all'interno del corpo del messaggio. I client abilitati alla lettura di messaggi HTML rappresentereanno il messaggio come una pagina HTML.

Usare

Certamente non potrete sapere sempre quale tipo di client email riceverà i vostri messaggi. Innestando i tag all'interno di è possibile fornire messaggi alternativi in puro testo e in formato HTML.

Gli attributi di

Attributo

Descrizione

type Obbligatorio. Le opzioni sono text, plain e html. text e plain specificano entrambi il formato text/plain. html specifica il formato HTML.
wraptext Usato per le email in puro testo per specificate il numero di caratteri per linea. Se omesso, il testo non ritornerà a capo.
charset Codifica dei caratteri.

Es.3: Register-2.cfm

---- Codice omesso ----

<cfmail to="#FORM.email#" from="runners@runnershome.com"
        subject="Successful Registration">
          <cfmailpart type="text" wraptext="72">
      		Congratulations!  You have successfully registered for Runners Home!
     	   </cfmailpart>
          <cfmailpart type="html">
          <b>Congratulations!</b>  You have successfully registered for
          Runners Home!<br> 
     </cfmailpart>     
</cfmail>
 ---- Codice omesso ----   

 

<a href="/img/22/iframe_CF_email3.html" title="Vedi esempio">Vedi codice</a>;

 


Gli allegati

I file possono essere allegati usando il tag . La sintassi è la seguente:

Non vi è limite al numero di tag che possono essere inclusi al tag .


Conclusioni

In questa lezione avete imparato ad inviare le email usando ColdFusion.



Ti potrebbe interessare anche

commenta la notizia

C'è 1 commento
Marcello
Ti è piaciuto l'articolo?