Share via

Entidades de actividad de correo electrónico

  • Artículo

 

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

La actividad de correo electrónico permite realizar el seguimiento y administrar comunicaciones de correo electrónico con los clientes.Microsoft Dynamics 365 incluye el software E-mail Router que administra el enrutamiento de correo electrónico hacia o desde Microsoft Dynamics 365. La actividad de correo electrónico se entrega con protocolos de correo electrónico.E-mail Router admite los siguientes protocolos de correo electrónico: Servicios web de Exchange, POP3 y SMTP. Además del software de E-mail Router, la actividad de correo electrónico también se puede ofrecer mediante Microsoft Dynamics 365 para Outlook.

En este tema

Acciones en una actividad de correo electrónico

Correo electrónico en masa

Datos adjuntos de correo electrónico

Acciones en una actividad de correo electrónico

Mediante SDK de Microsoft Dynamics 365, puede realizar las siguientes acciones sobre una actividad de correo electrónico:

  • Crear, recuperar, actualizar y eliminar la actividad de correo electrónico.

  • Enviar mensajes de correo electrónico o enviar mensajes de correo electrónico mediante plantillas de correo electrónico (Template). Para obtener más información acerca de las plantillas de correo electrónico, consulte Métodos y mensajes de la entidad de plantilla (plantilla de correo electrónico).

  • Adjunte archivos como datos adjuntos mediante el atributo (ActivityMimeAttachment) en el mensaje de correo electrónico.

  • Enviar mensajes de correo electrónico en masa.

  • Configurar mensajes de correo electrónico entrantes para que se entreguen desde Microsoft Exchange Server a cualquier usuario o cola, o mensajes salientes para que se envíen desde cualquier usuario o cola a Microsoft Exchange Server. Para obtener información sobre cómo configurar mensajes de correo electrónico entrantes para colas, consulte Configurar correo electrónico para los mensajes entrantes.

    Si los atributos de organización Organization.RequireApprovalForuserEmail y Organization.RequireApprovalForQueueEmail (correos electrónicos de proceso solo para usuarios o colas aprobados) se establecen en true (1), se produce lo siguiente: los mensajes de correo electrónico se entregan o se envían solamente desde un usuario o una cola si la dirección de correo electrónico principal del usuario o cola está aprobada. Los atributos SystemUser.EmailRouterAccessApproval y Queue.EmailRouterAccessApproval indican el estado de la dirección de correo electrónico principal del usuario y la cola respetivamente, y el valor debe establecerse como 1. De lo contrario, los mensajes entrantes y salientes se bloquearán. Puede actualizar el registro de usuarios o de colas para cambiar el valor del atributo, si no está ya en estado aprobado, siempre que su cuenta de usuario disponga del privilegio prvApproveRejectEmailAddress asignado. Para obtener más información, vea Asignación de la interfaz de usuario de rol de seguridad a privilegios.

Nota

En Microsoft Dynamics 365 (en línea y local), el atributo Email.StatusCode no puede ser null.

Correo electrónico en masa

Microsoft Dynamics 365 admite el envío de correo electrónico a una lista importante de destinatarios a través de una solicitud de correo electrónico en masa. Cuando se envía una solicitud de correo electrónico en masa a Microsoft Dynamics 365, se crea una operación asincrónica en la cola de servicio asincrónica que envía los mensajes de correo electrónico mediante un proceso en segundo plano. Esto le proporciona un rendimiento del sistema mejorado.

Los mensajes SendBulkMailRequest y BackgroundSendEmailRequest se usan para enviar mensajes de correo electrónico en masa. A continuación se enumera la secuencia utilizada para enviar correo electrónico en masa:

  1. Ejecute la solicitud SendBulkMail. Esta solicitud contiene una consulta que selecciona los destinatarios de correo electrónico de destino y una plantilla de correo electrónico para redactar cada correo electrónico.

  2. El servicio asincrónico crea actividades de correo electrónico para cada destinatario.

  3. El servicio asincrónico envía cada mensaje de correo electrónico. Los mensajes de correo electrónico tienen estado de envío "pendiente".

  4. El enrutador de correo electrónico, Microsoft Dynamics 365 para Outlook, o un componente de envío de correo electrónico de terceros sondea Microsoft Dynamics 365 en busca de mensajes de correo electrónico pendientes y, si se encuentra uno, los descarga mediante la solicitud BackgroundSendEmail.

  5. La solicitud BackgroundSendEmail realiza las operaciones siguientes: comprueba si hay mensajes de correo electrónico pendientes, descarga el correo electrónico al llamador del mensaje BackgroundSendEmailRequest y sincroniza las descargas si hay varios llamadores.

  6. El llamador del mensaje BackgroundSendEmailRequest recibe el mensaje de correo electrónico descargado y, a continuación, lo envía.

Datos adjuntos de correo electrónico

Los datos adjuntos de correo electrónico son archivos que pueden adjuntarse a mensajes de correo electrónico o a plantillas de correo electrónico. Un archivo adjunto puede estar en cualquier formato de archivo de equipo estándar como documentos Microsoft Office Word, hojas de cálculo de Microsoft Office Excel , archivos de CAD y archivos PDF. Puede adjuntar varios archivos como datos adjuntos de correo electrónico a un correo electrónico o a una plantilla de correo electrónico.El tamaño máximo de los archivos que se pueden cargar se determina mediante la propiedad Organization.MaxUploadFileSize. Esta propiedad se define en la pestaña Correo electrónico de Configuración del sistema en la aplicación Dynamics 365. Esta configuración limita el tamaño de los archivos que pueden adjuntarse a los mensajes de correo electrónico, notas y recursos web. La configuración predeterminada es 5 MB.

Para adjuntar datos adjuntos de correo electrónico con un mensaje o una plantilla de correo electrónico, utilice los atributos ActivityMimeAttachment.ObjectId y ActivityMimeAttachment.ObjectTypeCode mientras está creando o actualizando un registro de adjunto MIME de actividad.

La muestra de código siguiente muestra cómo adjuntar datos adjuntos de correo electrónico en un correo electrónico:

ActivityMimeAttachment _sampleAttachment = new ActivityMimeAttachment{
    ObjectId = new EntityReference(Email.EntityLogicalName, _emailId),
    ObjectTypeCode = Email.EntityLogicalName,
    Subject = "Sample Attachment”,
    Body = System.Convert.ToBase64String(new ASCIIEncoding().GetBytes("Example Attachment")),
    FileName = "ExampleAttachment.txt"};

De forma similar, para adjuntar los datos adjuntos de correo electrónico a una plantilla en vez de a un correo electrónico, se reemplazarán los valores de los atributos ActivityMimeAttachment.ObjectId y ActivityMimeAttachment.ObjectTypeCode del modo siguiente en el código anterior:

ObjectId = new EntityReference(Template.EntityLogicalName, _templateId), ObjectTypeCode = Template.EntityLogicalName,

Para obtener una muestra de código completa acerca de cómo crear datos adjuntos de correo electrónico, consulte Ejemplo: crear, recuperar, actualizar y eliminar datos adjuntos de correo electrónico.

Reutilización de datos adjuntos de correo electrónico

Cuando se crea un registro de datos adjuntos de correo electrónico, el archivo adjunto se guarda como BLOB de archivo. El atributo ActivityMimeAttachment.AttachmentId del registro de datos adjuntos de correo electrónico identifica de forma exclusiva al BLOB de archivo. Esto se hace para facilitar la reutilización de los datos adjuntos del archivo con otros registros de correo electrónico y de plantilla de correo electrónico, sin crear y almacenar varias copias del mismo archivo en la base de datos.

Para volver a usar datos adjuntos de un archivo existente:

  1. Recupere el registro de ActivityMimeAttachment que contiene el archivo adjunto que desea volver a usar tal y como se muestra en el siguiente ejemplo de código:

    ActivityMimeAttachment retrievedAttachment = (ActivityMimeAttachment)_serviceProxy.Retrieve(ActivityMimeAttachment.EntityLogicalName, _emailAttachmentId, new ColumnSet(true));

  2. Cree un nuevo registro de datos adjuntos de correo electrónico, asócielo con el registro requerido de correo electrónico o de plantilla de correo electrónico y diríjalo al archivo adjunto del registro ActivityMimeAttachment recuperado, tal y como se muestra en el siguiente ejemplo de código:

    ActivityMimeAttachment _reuseAttachment = new ActivityMimeAttachment{
    ObjectId = new EntityReference(Email.EntityLogicalName, _emailId),
    ObjectTypeCode = Email.EntityLogicalName,
    Subject = "Sample Attachment”,
    AttachmentId = retrievedAttachment.AttachmentId};

    Debido a que está reutilizando un archivo de datos adjuntos existente, no tiene que especificar los valores de atributo de ActivityMimeAttachment.Body y ActivityMimeAttachment.FileName mientras está creando y asociando registros de datos adjuntos de correo electrónico a correos electrónicos o a plantillas de correo electrónico.

Ver también

Entidades de actividad
Código de ejemplo para las entidades de actividad
Mensajes y métodos de la entidad de correo electrónico
Métodos y mensajes de la entidad ActivityMimeAttachment (datos adjuntos de correo electrónico)

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright