SendMail
El ejemplo SendMail muestra cómo usar el adaptador del Protocolo simple de transferencia de correo (SMTP) para enviar mensajes de correo electrónico desde una orquestación de Microsoft BizTalk Server. La información dinámica empleada para enviar los mensajes de correo se recupera de un mensaje XML mediante la funcionalidad de promoción de propiedades.
Descripción del ejemplo
Este ejemplo envía un mensaje de correo electrónico usando información obtenida de las propiedades promocionadas de un mensaje de pedido (PO) XML entrante, mediante la siguiente secuencia de pasos:
La orquestación de BizTalk Server recupera un mensaje de PO XML de entrada.
La orquestación BizTalk Server promueve las propiedades PONumber y Email para facilitar el acceso en el futuro.
La orquestación de BizTalk Server usa los valores de las propiedades promocionadas para establecer la dirección de destino del puerto de envío dinámico y para establecer el asunto del mensaje de correo electrónico.
La orquestación de BizTalk Server envía el mensaje de correo electrónico construido a través del adaptador de SMTP.
Ubicación del ejemplo
<Ruta de acceso de> ejemplos\AdaptersUsage\SendMail\
En la tabla siguiente se enumeran los archivos del ejemplo y se describe su propósito.
| Archivos | Descripción |
|---|---|
| AssemblyInfo.cs, SendMail.btproj, SendMail.sln | Proporciona archivos de información de proyectos, soluciones y ensamblados para este ejemplo. |
| Cleanup.bat | Anula la implementación de ensamblados y los elimina de la caché de ensamblados global (GAC); elimina puertos de envío y de recepción; elimina directorios virtuales de los Servicios de Microsoft Internet Information Server (IIS) según sea necesario. |
| PropertySchema.xsd, PurchaseOrder.xsd | Proporciona esquemas para las propiedades que se desea promocionar y para el mensaje de PO XML, respectivamente. |
| ReceiveSend.odx | Proporciona una orquestación de BizTalk Server que procesa el mensaje de PO XML entrante y envía un mensaje de correo electrónico basado en la información del mensaje. |
| SendMailInput.xml | Contiene un archivo de entrada de ejemplo con un PO especificado mediante XML. |
| Setup.bat | Crea e inicializa este ejemplo. Nota: Este archivo de instalación crea y enlaza puertos, etc., con un mecanismo diferente al de la mayoría de los archivos de instalación de los ejemplos del SDK. No requiere ningún archivo .xml complementario. |
Para generar e inicializar el ejemplo
En una ventana de comandos, desplácese a la siguiente carpeta:
<Ruta de acceso de> ejemplos\AdaptersUsage\SendMail
Ejecute el archivo Setup.bat que realiza las acciones siguientes:
Crea la siguiente carpeta de entrada para este ejemplo:
<Ruta de acceso de> ejemplos\AdaptersUsage\SendMail\In
Compila el proyecto de Visual Studio para este ejemplo.
Inicia la orquestación de BizTalk Server.
Nota
Debe confirmar que BizTalk no ha informado de ningún error durante el proceso de generación e inicialización antes de intentar ejecutar este ejemplo.
Nota
Si selecciona abrir y crear el proyecto de este ejemplo sin ejecutar el archivo Setup.bat, debe crear, en primer lugar, un par de claves de nombre seguro mediante la Utilidad de nombre seguro de .NET Framework (sn.exe). Utilice este par de claves para firmar el ensamblado resultante.
Nota
Para deshacer los cambios realizados por Setup.bat, ejecute Cleanup.bat y elimine todos los puertos de recepción y envío que tengan el prefijo SendMail_1.0.0.0_Microsoft.Samples.BizTalk.SendMail. Debe ejecutar Cleanup.bat antes de ejecutar Setup.bat por segunda vez.
En la consola de administración de BizTalk Server, busque el puerto de recepción con el prefijo SendMail_1.0.0.0_Microsoft.Samples.BizTalk.SendMail. Actualice la ubicación de recepción para que este puerto de recepción señale a un directorio del sistema de archivos para su uso como ubicación de entrada.
Con un programa como el Bloc de notas, modifique el archivo SendMailInput.xml para que el elemento Email especifique una dirección de correo electrónico legítima en la que desea recibir el mensaje de correo electrónico generado por este ejemplo.
Haga clic en Inicio, seleccione Programas, Microsoft BizTalk Server 20xx y, a continuación, haga clic en Administración de BizTalk Server.
En la consola de administración de BizTalk Server, expanda el árbol grupo de BizTalk.
Expanda el árbol Configuración de la plataforma en el panel izquierdo.
Expanda la carpeta Adaptadores , haga clic en el nodo SMTP y, a continuación, haga doble clic en la fila del adaptador SMTP en el panel derecho.
En el cuadro de diálogo Propiedades del controlador de adaptadores SMTP , haga clic en Propiedades.
En el cuadro de diálogo Propiedades de transporte SMTP , en la pestaña Propiedades , proporcione los valores adecuados para las propiedades Nombre del servidor SMTP y From (dirección de correo electrónico) y, a continuación, haga clic en Aceptar.
Estos valores se usarán para construir la dirección de correo electrónico De para cualquier mensaje de correo electrónico enviado a través de este adaptador de SMTP.
Nota
Si tiene que autenticarse con el servidor SMTP, debe asegurarse de que la dirección de correo electrónico De pertenezca a la misma cuenta que usa para la autenticación.
Detenga el servicio de BizTalk y después reinícielo (BizTalkServerApplication) para que la orquestación adopte estos cambios.
Para ejecutar el ejemplo
Coloque una copia del archivo modificado SendMailInput.xml en la carpeta de entrada.
Observe si llega un mensaje de correo electrónico a la dirección especificada en el procedimiento anterior.