Enviar y recibir correo electrónico con Office 365 adaptador de Outlook Email: BizTalk Server

  • Artículo

El adaptador de Email de Outlook Office 365 permite enviar y recibir correos de su Office 365 Outlook Email de 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 tipoen Office 365 outlook Email 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 BizTalk Server aprobación para el permiso de acceso:

    Office 365 permisos de correo del adaptador en BizTalk Server

  5. Configure las propiedades Office 365 Outlook Email General:

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

    Cuando haya terminado, las propiedades son similares a las siguientes:

    Office 365 propiedades generales de Outlook Email en BizTalk Server

  6. Configure las propiedades Office 365 Outlook Email Attachments:

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

    • Adjuntar elementos de mensaje de BizTalk: si está activado, los elementos no body del mensaje de BizTalk 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 ruta de acceso o las rutas de acceso especificadas deben ser accesibles para el host del adaptador en tiempo de ejecución. Valor predeterminado: vacío.

    Después de seleccionar algunos archivos, las propiedades de datos adjuntos son similares a las siguientes:

    Office 365 propiedades de datos adjuntos de Outlook Email en BizTalk Server

  7. Seleccione Aceptar para guardar los cambios.

Detalles importantes

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

    Nombre de propiedad Propiedad promocionada
    To OfficeMail.To
    CC OfficeMail.CC
    Subject OfficeMail.Subject
    Importancia OfficeMail.Importance
    Archivos adjuntos OfficeMail.AttachedFiles

  2. El valor de la propiedad OfficeMail.AttachedFiles es una 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 archivo simple y una ubicación para enviar mensajes a la Email de Outlook Office 365.

  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 la Office 365 propiedades de puerto de envío del adaptador de Outlook Email, establezca filtrosBTS.ReceivePortName == <Receive Port Name>en .

  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 Office 365 puerto de envío del adaptador de Outlook Email.

  5. Copie Office365Mail.xml mensaje de ejemplo en la carpeta receive (C:\Temp\In\). El puerto de envío envía el archivo XML como cuerpo del correo al Office 365 outlook Email. 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 BizTalk Server actualización acumulativa 4 de 2020.

Puede ajustar el número máximo de correos electrónicos que envía el adaptador de Office 365 outlook Email 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 Email de Outlook 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 Office365 Outlook Email.

  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.

    Office 365 configuración del controlador de envío de Outlook Email en BizTalk Server

  4. Establezca la propiedad Maximum concurrent sends (Número máximo de envíos simultáneos ).

    Office 365 configuración de propiedades del controlador de envío de Outlook Email en BizTalk Server

  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 seleccione Puerto de recepción unidireccional.

    Crear 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 Office 365 Outlook Email 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 BizTalk Server aprobación para el permiso de acceso:

    Permitir la aprobación de BizTalk Server permiso para acceder a los permisos de correo Office 365

  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.
    • Empezar desde: escriba cómo se recibe el correo electrónico de Office 365. Este valor indica receivedTimeStamp de un correo electrónico en Office 365 Outlook. Email más reciente que los valores especificados se reciben.
    • Solo correos no leídos: compruebe esto para leer solo el correo electrónico no leído. Mantenga desactivada la opción para leer todo el correo electrónico.
    • Acción posterior: seleccione una acción posterior que se 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 lectura 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 de forma óptima.

    Cuando haya terminado, las propiedades serán similares a las siguientes:

    Office 365 propiedades de punto de conexión de correo en BizTalk Server

  7. Configure las propiedades de carga del punto de conexión (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á seleccionado 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 parte del mensaje de BizTalk. Está desactivada de forma predeterminada. Cada parte del mensaje de BizTalk tiene la propiedad ContentType establecida en el tipo MIME de los datos adjuntos. Los datos adjuntos que son elementos de Outlook (correos electrónicos, eventos de calendario, contactos) se guardan en su representación MIME.

    Cuando haya terminado, las propiedades serán similares a las siguientes:

    Propiedades del punto de conexión de carga para Office 365 adaptador en BizTalk Server

  8. Seleccione Aceptar para guardar los cambios.

Prueba de la configuración de recepción

Puede usar un puerto simple de envío de archivos para recibir mensajes de su Office 365 Outlook Email.

  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 y en %MessageID%.xml.
  2. En las propiedades del puerto de envío de archivos, establezca filtrosBTS.ReceivePortName == <Receive Port Name>en .
  3. Inicie el Office 365 outlook Email ubicación de recepción y el puerto de envío de archivos.
  4. Busque mensajes en la carpeta de destino (c:\temp\out).

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

Nombre de propiedad Propiedad promocionada
Importancia OfficeMail.ReceivedMailImportance
Subject OfficeMail.ReceivedMailSubject
SenderName OfficeMail.SenderName
SenderAddress OfficeMail.SenderAddress
HasAttachments OfficeMail.HasAttachments

Pasos siguientes

Vea todos los adaptadores de Office 365.