Attività personalizzata SendMail

L'esempio SendMail dimostra come creare un'attività personalizzata che deriva da AsyncCodeActivity per inviare messaggi di posta elettronica tramite il protocollo SMTP da usare in un'applicazione flusso di lavoro. Nell'attività personalizzata vengono usate le funzionalità di SmtpClient per inviare messaggi di posta elettronica in modo asincrono e con autenticazione. Nell'attività sono inoltre disponibili funzionalità per l'utente finale, ad esempio la modalità test, la sostituzione dei token, i modelli di file e il percorso di rilascio di prova.

Nella tabella seguente vengono indicati in dettaglio gli argomenti per l'attività SendMail.

Contenuto della soluzione

Nella soluzione sono contenuti due progetti.

Ulteriore configurazione dell'attività SendMail

Sebbene non illustrato nell'esempio, gli utenti possono configurare ulteriormente l'attività SendMail. Nelle tre sezioni successive viene illustrato come eseguire questa operazione.

Invio di un messaggio di posta elettronica usando token specificati nel corpo del messaggio

In questo frammento di codice viene illustrato come è possibile inviare messaggi di posta elettronica nel cui corpo sono presenti token. Si noti il modo in cui i token vengono specificati nella proprietà Body. I valori per tali token vengono specificati nella proprietà Token.

IDictionary<string, string> tokens = new Dictionary<string, string>();
tokens.Add("@name", "John Doe");
tokens.Add("@date", DateTime.Now.ToString());
tokens.Add("@server", "localhost");

new SendMail
{
    From = new LambdaValue<MailAddress>(ctx => new MailAddress("john.doe@contoso.com")),
    To = new LambdaValue<MailAddressCollection>(
                    ctx => new MailAddressCollection() { new MailAddress("someone@microsoft.com") }),
    Subject = "Test email",
    Body = "Hello @name. This is a test email sent from @server. Current date is @date",
    Host = "localhost",
    Port = 25,
    Tokens = new LambdaValue<IDictionary<string, string>>(ctx => tokens)
};

Invio di un messaggio di posta elettronica tramite un modello

In questo frammento di codice viene illustrato come inviare un messaggio di posta elettronica usando un token del modello nel corpo. Si noti che quando si imposta la proprietà BodyTemplateFilePath non è necessario specificare il valore per la proprietà Body (il contenuto del file modello verrà copiato nel corpo).

new SendMail
{
    From = new LambdaValue<MailAddress>(ctx => new MailAddress("john.doe@contoso.com")),
    To = new LambdaValue<MailAddressCollection>(
                    ctx => new MailAddressCollection() { new MailAddress("someone@microsoft.com") }),
    Subject = "Test email",
    Host = "localhost",
    Port = 25,
    Tokens = new LambdaValue<IDictionary<string, string>>(ctx => tokens),
    BodyTemplateFilePath = @"..\..\..\SendMail\Templates\MailTemplateBody.htm",
};

Invio di messaggi di posta elettronica in modalità test

In questo frammento di codice viene illustrato come impostare le due proprietà di test. Se si imposta TestMailTo, tutti i messaggi verranno inviati a john.doe@contoso.con, indipendentemente dai valori impostati per il destinatario effettivo e i destinatari in copia. Se si imposta TestDropPath, tutti i messaggi di posta elettronica in uscita verranno inoltre salvati nel percorso specificato. È possibile impostare queste proprietà in modo indipendente l'una dall'altra perché non sono correlate.

new SendMail
{
   From = new LambdaValue<MailAddress>(ctx => new MailAddress("john.doe@contoso.com")),
   To = new LambdaValue<MailAddressCollection>(
                    ctx => new MailAddressCollection() { new MailAddress("someone@microsoft.com") }),
   Subject = "Test email",
   Host = "localhost",
   Port = 25,
   Tokens = new LambdaValue<IDictionary<string, string>>(ctx => tokens),
   BodyTemplateFilePath = @"..\..\..\SendMail\Templates\MailTemplateBody.htm",
   TestMailTo= new LambdaValue<MailAddress>(ctx => new MailAddress("john.doe@contoso.com")),
   TestDropPath = @"c:\Samples\SendMail\TestDropPath\",
};

Istruzioni di configurazione

Per eseguire l'esempio, è necessario disporre dell'accesso a un server SMTP.

Per altre informazioni sulla configurazione di un server SMTP, vedere i collegamenti seguenti.

• Configurazione del servizio SMTP (IIS 6.0)

• IIS 7.0: Configurare la posta elettronica SMTP

• Installazione del servizio SMTP

Per eseguire il download, sono disponibili emulatori SMTP forniti da terze parti.

Per eseguire questo esempio

1. In Visual Studio aprire il file di soluzione SendMail.sln.

2. Verificare di disporre dell'accesso a un server SMTP valido. Vedere le istruzioni di configurazione.

3. Configurare il programma con l'indirizzo del server e gli indirizzi e-mail del mittente e del destinatario.

   Per eseguire correttamente l'esempio, può essere necessario configurare il valore degli indirizzi e-mail del mittente e del destinatario e l'indirizzo del server SMTP in Program.cs e in Sequence.xaml. Poiché i messaggi di posta elettronica vengono inviati in due modalità diverse, sarà necessario modificare l'indirizzo in entrambi i percorsi.

4. Per compilare la soluzione, premere CTRL+MAIUSC+B.

5. Per eseguire la soluzione, premere CTRL+F5.