Compartir por

Tablas de actividad de correo electrónico

  • Artigo

La actividad de correo electrónico permite realizar el seguimiento y administrar comunicaciones de correo electrónico con los clientes.

Acciones en una actividad de correo electrónico

Mediante los servicios web de Dataverse, 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 Crear plantillas 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.

    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.

Nota

En Dataverse, el atributo Email.StatusCode no puede ser null.

Correo electrónico en masa

Dataverse 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 Dataverse, 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, Dynamics 365 for Outlook o un componente de envío de correo electrónico de terceros sondea Dataverse 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.

    Nota

    Su proveedor de servicios de correo electrónico puede tener límites que afectan la cantidad de correos electrónicos que puede enviar dentro de un período de tiempo. Más información: Límites de Exchange Online > Límites de envío.

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

Archivos 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 Office Outlook, hojas de cálculo de 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 las columnas ActivityMimeAttachment.ObjectId y ActivityMimeAttachment.ObjectTypeCode mientras está creando o actualizando una fila 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 ver un ejemplo de código completo sobre cómo crear adjuntos de correo electrónico, vea Ejemplo: Crear, recuperar, actualizar y eliminar un adjunto 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 la fila 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 archivo adjunto de correo electrónico, asócielo con el registro requerido de correo electrónico o la fila de plantilla de correo electrónico y diríjalo al archivo adjunto de la fila 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 columna de ActivityMimeAttachment.Body y ActivityMimeAttachment.FileName mientras está creando y asociando filas de datos adjuntos de correo electrónico a correos electrónicos o a plantillas de correo electrónico.

Almacenamiento de correo electrónico

Las descripciones de los correos electrónicos (cuerpo del correo electrónico) se han almacenado hasta este momento en el almacén relacional Dataverse. Eso está cambiando a medida que la columna Email.Description en la tabla actividad de correo electrónico se está reubicando en Azure Blob Storage no estructurado. Azure Blob Storage también se usa para el almacenamiento de datos adjuntos, anotaciones, archivos e imágenes.

Período de transición

Se espera que la migración de datos de el almacén de relación de Dataverse a Azure Blob Storage para todos los clientes comience en mayo de 2023. Esta migración de datos se llevará a cabo como un proceso en segundo plano (trabajo). Se espera que el movimiento de datos inicial para los clientes existentes dure entre 6 y 12 semanas, y posiblemente incluso más, según el tamaño de los datos. Después del movimiento de datos inicial, cualquier migración restante es un proceso continuo. Todas las descripciones de correo electrónico con más de doce meses se trasladarán automáticamente a Azure Blob Storage y este período de transición de doce meses no se podrá cambiar. Los correos electrónicos más nuevos no se moverán hasta que tengan 12 meses. El trabajo de migración de descripciones de correo electrónico se ejecuta periódicamente, aproximadamente una vez cada 30 a 60 días por inquilino.

Esta migración de datos será transparente para usted con la excepción de que verá una reducción en el tamaño de la tabla ActivityPointer después de que el proceso de migración se haya completado por completo. En el centro de administración de Power Platform dentro del informe Capacidad, una nueva línea de correo electrónico estará disponible en Uso de archivos. El resultado final es un aumento en el consumo total de almacenamiento de archivos y una reducción en el consumo de almacenamiento de la base de datos.

Nota

El aumento en el almacenamiento de archivos puede ser menor que lo que se elimina de la tabla de ActivityPointer debido a la compresión de los datos del archivo.

Las limitaciones mencionadas en la siguiente sección comenzarán a aplicarse a cualquier dato que ya se haya movido al Azure Blob Storage administrado de Dataverse, incluso si no se completa todo el movimiento de datos.

Buscar y filtrar limitaciones

Para las descripciones de correo electrónico (cuerpos) almacenadas en Azure Blob Storage, se aplican ciertas limitaciones para filtrar, encontrar y buscar descripciones de correo electrónico, como se describe a continuación.

Filtering

No se admite el filtrado de descripciones de correo electrónico. Algunos puntos específicos a considerar son los siguientes.

  • FetchXML - No podrás buscar en los cuerpos de los correos electrónicos usando FetchXML.
  • Búsqueda rápida y Búsqueda avanzada: no se admite el filtrado de descripciones de correo electrónico con estos métodos.

Sugerencia

Para Búsqueda rápida, aunque no se admite el filtrado, el cuerpo del correo electrónico se puede agregar como una columna devuelta y los datos del cuerpo se devolverán en el resultado.

Buscando

Puede habilitar Búsqueda de Dataverse en descripciones de correo electrónico para buscar descripciones de correo electrónico.

Consulte también

Tablas de actividades
Ejemplo: enviar un mensaje de correo electrónico
Tabla Correo electrónico
Tabla ActivityMimeAttachment

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).