Enviar y recibir correo electrónico con el adaptador de correo electrónico de Outlook de Office 365- BizTalk Server

El adaptador de correo electrónico de Office 365 Outlook le permite enviar y recibir correos de su correo electrónico de Office 365 Outlook desde BizTalk.

Envío de correo mediante un puerto de envío

1. En la consola de administración de BizTalk Server, haga clic con el botón derecho en Puertos de envío, seleccione Nuevo y seleccione Puerto de envío unidireccional estático.

   Crear un puerto de envío proporciona algunas instrucciones.

2. Escriba un nombre. En Transporte, establezca el tipo en Correo electrónico de Office 365 Outlook y seleccione Configurar.

3. Seleccione Iniciar sesión ... e inicie sesión en su cuenta de Office 365. La cuenta se rellena automáticamente con la dirección de correo electrónico.

4. Permitir la aprobación de BizTalk Server para el permiso de acceso:

   

5. Configure las propiedades generales del correo electrónico de Outlook de Office 365:

   • Para: Escriba sus direcciones de correo predeterminadas, separadas por ';' (máximo de 256 caracteres)
   • CC: escriba las direcciones de correo CC predeterminadas separadas por ';' (Máximo de 256 caracteres)
   • Asunto: mencione su asunto de correo predeterminado. (Máximo de 256 caracteres)
   • Importancia: seleccione el valor de Importancia. La lista desplegable contiene los valores Low, Normal y High con Normal como valor predeterminado.

   Cuando termine, las propiedades tienen un aspecto similar al siguiente:

   

6. Configure las propiedades de los datos adjuntos de correo electrónico de Outlook de Office 365:

   El cuerpo del correo electrónico que se envía corresponde al cuerpo del mensaje de BizTalk. Para agregar datos adjuntos al correo electrónico, haga lo siguiente:

   • Adjuntar partes del mensaje de BizTalk: Si se marca, las partes del mensaje de BizTalk que no son del cuerpo se agregan como datos adjuntos al correo electrónico enviado.
   • Archivos: especifica que un archivo o archivos se adjuntan al mensaje de correo electrónico y la ruta de acceso completa al archivo o archivos. La(s) ruta(s) de acceso especificada(s) deben ser accesibles para el host del adaptador durante su ejecución. Valor predeterminado: vacío.

   Después de seleccionar algunos archivos, las propiedades de los datos adjuntos tienen un aspecto similar al siguiente:

   

7. Seleccione Aceptar para guardar los cambios.

Detalles importantes

1. Las propiedades predeterminadas también se pueden actualizar mediante las propiedades promocionadas:

   Nombre de propiedad	Propiedad Promocionada
   A	OfficeMail.To
   CC	OfficeMail.CC
   Asunto	OfficeMail.Asunto
   Importancia	Importancia de OfficeMail
   Archivos adjuntos	OfficeMail.ArchivosAdjuntos

2. El valor de la propiedad OfficeMail.AttachedFiles es la lista de archivos con "|" como delimitador entre archivos diferentes. Por ejemplo: "C:\Attachments\File1.pdf|C:\Attachments\File2.xml".

3. La propiedad ContentType de la parte del cuerpo del mensaje de BizTalk se puede establecer en "Text" o "Html" para indicar el tipo del cuerpo del correo electrónico. De forma predeterminada, será "Texto".

4. Cuando se adjuntan partes de un mensaje de BizTalk de varias partes, la propiedad ContentType de un elemento, si se proporciona, se usa como tipo MIME para los datos adjuntos creados. De forma predeterminada, el tipo MIME de los datos adjuntos se establece en "application/octet-stream".

5. Al adjuntar archivos, el tipo MIME de los datos adjuntos se determina a partir de la extensión de nombre de archivo. El tipo MIME predeterminado es "application/octet-stream".

Prueba del puerto de envío

Puede usar un puerto de recepción de archivos simple y una ubicación para enviar mensajes al correo electrónico de Office 365 Outlook.

1. Cree un puerto de recepción mediante el adaptador de archivo. En la ubicación de recepción, establezca la carpeta Receive en C:\Temp\In\y establezca la máscara de archivo en *.xml.

2. En las propiedades del puerto de envío del adaptador de correo electrónico de Office 365 para Outlook, configure los filtros aBTS.ReceivePortName == <Receive Port Name>.

3. Pegue lo siguiente en un editor de texto y guarde el archivo como Office365Mail.xml. Este es el mensaje de ejemplo.

   <ns0:Root xmlns:ns0="http://BizTalk_Server_Project1.Schema1"> 
       <Record> 
           <Name>BizTalk User</Name> 
           <ID>001</ID> 
       </Record> 
   </ns0:Root> 
   

4. Inicie la ubicación de recepción del archivo y el puerto de envío del adaptador de correo electrónico de Outlook de Office 365.

5. Copie Office365Mail.xml mensaje de ejemplo en la carpeta de recepción (C:\Temp\In\). El puerto de envío envía el archivo XML como cuerpo del correo electrónico a su correo electrónico de Office 365 Outlook. Los archivos especificados en la pestaña Datos adjuntos de la configuración del puerto se adjuntan al correo electrónico.

Configuración adicional en el controlador de envío

Disponible a partir de la actualización acumulativa 4 de BizTalk Server 2020.

Puede ajustar el número máximo de correos electrónicos que envía el adaptador de correo electrónico de Outlook de Office 365 a la vez en todos sus puertos de envío en la instancia de host. El valor se establece en 20 de forma predeterminada y se puede cambiar estableciendo la propiedad Número máximo de envíos simultáneos en las propiedades del controlador de envío para el adaptador de correo electrónico de Outlook de Office 365.

1. En la consola de administración de BizTalk Server, expanda Administración de BizTalk Server, expanda Grupo de BizTalk, expanda Configuración de la Plataforma y, a continuación, expanda Adaptadores.

2. En la lista de adaptadores expandidos, haga clic en Correo electrónico de Outlook de Office365.

3. En el panel derecho, haga clic con el botón derecho en el controlador de envío que desea configurar y, a continuación, haga clic en Propiedades.

   

4. Establezca la propiedad Número máximo de envíos simultáneos .

   

5. Seleccione Aceptar para guardar los cambios.

Recibir correo electrónico mediante un puerto de recepción

1. En la consola de administración de BizTalk Server, haga clic con el botón derecho en Puertos de recepción, seleccione Nuevo y seleccioneOne-Way puerto de recepción.

   La creación de un puerto de recepción proporciona algunas instrucciones.

2. Escriba un nombre y seleccione Ubicaciones de recepción.

3. Seleccione Nuevo y Asigne el nombre a la ubicación de recepción. En Transporte, seleccione Correo electrónico de Outlook de Office 365 en la lista desplegable Tipo y, a continuación, seleccione Configurar.

4. Seleccione Iniciar sesión ... e inicie sesión en su cuenta de Office 365. La cuenta se rellena automáticamente con la dirección de correo electrónico.

5. Permitir la aprobación de BizTalk Server para el permiso de acceso:

   

6. Configure las propiedades generales del punto de conexión:

   • Carpeta: seleccione la carpeta para obtener correo electrónico. La carpeta predeterminada es Bandeja de entrada. Tenga en cuenta que las carpetas no son recursivas por naturaleza. Por ejemplo, no se recupera el correo electrónico de las subcarpetas.
   • Comenzar desde: escriba cómo se recibe el correo electrónico desde Office 365. Este valor indica la marca de tiempo de recepción (receivedTimeStamp) de un correo electrónico en Outlook de Office 365. Se recibe un correo electrónico más reciente que los valores especificados.
   • Solo correos no leídos: compruebe esto para leer solo correo electrónico no leído. Mantenga desactivado para leer todo el correo electrónico.
   • Acción posterior: seleccione una acción de publicación que se va a realizar después de leer un correo electrónico. Ninguno es el valor predeterminado y no hace nada después de que BizTalk reciba el correo electrónico. Marcar como leído implica que, después de recibir un correo electrónico por BizTalk, el correo electrónico del buzón se marca como leído. Eliminar implica que, después de recibir un correo electrónico por BizTalk, se elimina el correo electrónico del buzón. Las acciones posteriores se realizan en la medida de lo posible.

   Cuando termine, las propiedades tienen un aspecto similar al siguiente:

   

7. Configure las propiedades del punto de conexión Payload (disponibles a partir de BizTalk Server 2020 y versiones posteriores):

   • Entregar MIME: guarda la representación MIME de un correo electrónico. El contenido MIME incluye el cuerpo del correo electrónico y todos los datos adjuntos.
   • Contenido del proceso: guarda el cuerpo del correo electrónico. Está seleccionada de forma predeterminada. El tipo de contenido del cuerpo del correo electrónico se guarda en la propiedad ContentType del mensaje de BizTalk creado.
   • Incluir datos adjuntos: guarda los datos adjuntos de correo electrónico como partes del mensaje de BizTalk. Está desactivada de forma predeterminada. Cada elemento de mensaje de BizTalk tiene la propiedad ContentType establecida en el tipo MIME del anexo. Los datos adjuntos que son elementos de Outlook (correos electrónicos, eventos de calendario, contactos) se guardan en su representación MIME.

   Cuando termine, las propiedades tienen un aspecto similar al siguiente:

   

8. Seleccione Aceptar para guardar los cambios.

Prueba de la configuración de recepción

Puede usar un puerto de envío de archivo simple para recibir mensajes del correo electrónico de Office 365 Outlook.

1. Cree un puerto de envío mediante el adaptador de archivo. Dentro de las propiedades del puerto de envío, establezca la carpeta Destino en C:\Temp\Out\, y establezca el nombre de archivo en %MessageID%.xml.
2. En las propiedades del puerto de envío de archivos, establezca los filtros en BTS.ReceivePortName == <Receive Port Name>.
3. Inicie la ubicación de recepción del correo electrónico de Outlook de Office 365 y el puerto de envío de archivos.
4. Busque mensajes en la carpeta de destino (c:\temp\out).

Propiedades promocionadas de la canalización de recepción

Las siguientes propiedades de la canalización de recepción se promueven de forma predeterminada:

Nombre de propiedad	Propiedad promocionada
Importancia	OfficeMail.ImportanciaCorreoRecibido
Asunto	AsuntoCorreoRecibido.OfficeMail
SenderName	OfficeMail.SenderName
SenderAddress	OfficeMail.DirecciónDelRemitente
HasAttachments	OfficeMail.TieneAdjuntos

Pasos siguientes

Vea todos los adaptadores de Office 365.