Compartir a través de

Tablas de actividad de correo electrónico

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

Con los servicios web de Dataverse, puede realizar las siguientes acciones en 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 sobre las plantillas de correo electrónico, consulte Creación de plantillas de correo electrónico.

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

  • Enviar mensajes de correo electrónico en masa.

  • Configure los mensajes de correo electrónico entrantes para que se entreguen desde Microsoft Exchange Server a cualquier usuario o cola, o mensajes salientes que se enviarán desde cualquier usuario o cola a Microsoft Exchange Server.

    Si los atributos de la Organization.RequireApprovalForuserEmail organización y Organization.RequireApprovalForQueueEmail (procesar correos electrónicos solo para usuarios/colas aprobados) se establecen en true (1), ocurre lo siguiente: los mensajes de correo electrónico se entregan o envían desde un usuario o cola solo si la dirección de correo electrónico principal del usuario o la 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 de la cola, respectivamente, y el valor debe establecerse en 1. De lo contrario, se bloquearán los mensajes entrantes y salientes. Puede actualizar el registro de usuario o cola para cambiar el valor del atributo, si aún no está en el estado aprobado, siempre que la cuenta de usuario tenga asignado el privilegio prvApproveRejectEmailAddress .

Nota:

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

Correo electrónico masivo

Dataverse admite el envío de correo electrónico a una lista grande de destinatarios a través de una solicitud masiva de correo electrónico. Cuando se envía una solicitud de correo electrónico masiva 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 brinda un mejor rendimiento del sistema.

Los SendBulkMailRequest mensajes y BackgroundSendEmailRequest se utilizan para enviar mensajes de correo electrónico masivos. A continuación se enumera la secuencia utilizada para enviar correo electrónico masivo:

  1. Ejecute la SendBulkMail solicitud. 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 las 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 un estado de envío "pendiente".

  4. El enrutador de correo electrónico, Dynamics 365 para Outlook o un componente de envío de correo electrónico de terceros consulta a Dataverse para mensajes de correo electrónico pendientes y, si se encuentra un mensaje pendiente, lo descarga mediante una solicitud de tipo BackgroundSendEmail.

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

    Nota:

    El proveedor de servicios de correo electrónico puede tener límites que afectan al número 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.

Datos adjuntos de correo electrónico

Los archivos adjuntos de correo electrónico son archivos que se pueden adjuntar a mensajes de correo electrónico o plantillas de correo electrónico. Un archivo adjunto puede estar en cualquier formato de archivo de equipo estándar, como documentos de Office Outlook, hojas de cálculo de Office Excel, archivos CAD y archivos PDF. Puede adjuntar varios archivos como archivos 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.

En el siguiente ejemplo de código se muestra cómo adjuntar un archivo adjunto de correo electrónico a 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"};

Del mismo modo, para adjuntar el archivo adjunto del correo electrónico a una plantilla en lugar de a un correo electrónico, reemplazará los valores de los atributos ActivityMimeAttachment.ObjectId y ActivityMimeAttachment.ObjectTypeCode de la siguiente manera en el código anterior.

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

Para obtener un ejemplo de código completo sobre cómo crear datos adjuntos de correo electrónico, vea Ejemplo: Crear, recuperar, actualizar y eliminar datos adjuntos de correo electrónico.

Reutilización de archivos adjuntos de correo electrónico

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

Para reutilizar un archivo adjunto existente:

  1. Recupere la ActivityMimeAttachment fila que contiene el archivo adjunto que desea reutilizar, como se muestra en el ejemplo de código siguiente:

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

  2. Cree un nuevo archivo adjunto de correo electrónico, asócielo a la fila necesaria de correo electrónico o de plantilla de correo electrónico y oriente al archivo adjunto de la fila recuperada ActivityMimeAttachment, 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};

Dado que va a reutilizar un archivo adjunto existente, no es necesario especificar los valores de las columnas ActivityMimeAttachment.Body y ActivityMimeAttachment.FileName mientras crea y asocia las filas de datos adjuntos de correo electrónico a correos electrónicos o plantillas de correo electrónico.

Almacenamiento de correo electrónico

Las descripciones de correo electrónico (cuerpo del correo electrónico) se han almacenado hasta este punto en el almacén relacional de Dataverse. Esto cambia a medida que la columna Email.Description de la tabla de actividad de correo electrónico se reubica 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 del almacén de relaciones de Dataverse a Azure Blob Storage para todos los clientes se inicie en mayo de 2023. Esta migración de datos tendrá lugar como un proceso en segundo plano (trabajo). Se espera que el movimiento de datos inicial para los clientes existentes dure aproximadamente de 6 a 12 semanas y, posiblemente, incluso más, dependiendo del 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 anteriores a doce meses se moverán automáticamente a Azure Blob Storage y no se puede cambiar este período de transición de doce meses. Los correos electrónicos más recientes no se moverán hasta que tengan 12 meses de antigüedad. El trabajo de migración de las descripciones de correo electrónico se ejecuta periódicamente, aproximadamente una vez cada 30 a 60 días por cliente.

Esta migración de datos será transparente con la excepción de que verá una reducción del tamaño de la tabla ActivityPointer una vez completado el proceso de migración. En el Centro de administración de Power Platform, dentro del informe de capacidad, un nuevo elemento de línea de correo electrónico estará disponible en Uso del archivo. El resultado final es un aumento del consumo general del almacenamiento de archivos y la reducción del almacenamiento de base de datos consumido.

Nota:

El aumento del almacenamiento de archivos podría ser menor que la cantidad eliminada de la tabla ActivityPointer debido a la compresión de los datos de archivo.

Las limitaciones mencionadas en la sección siguiente comenzarán a aplicar a los datos que ya se han movido al almacenamiento de blobs de Azure administrado por Dataverse, incluso si no se ha completado todo el movimiento de datos.

Limitaciones de búsqueda y filtrado

En el caso de las descripciones de correo electrónico (cuerpos) almacenadas en Azure Blob Storage, se aplican ciertas limitaciones al filtrar, encontrar y buscar descripciones de correo electrónico, según lo descrito a continuación.

Filtros

No se admite el filtrado en descripciones de correo electrónico. Algunos puntos específicos que se deben tener en cuenta son los siguientes.

  • FetchXML: no podrá buscar en cuerpos de correo electrónico mediante FetchXML.
  • Búsqueda rápida y búsqueda avanzada: no se admite el filtrado de descripciones de correo electrónico mediante 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 la búsqueda de Dataverse en descripciones de correo electrónico para buscar descripciones de correo electrónico.

Consulte también

Tablas de actividad
Ejemplo: Enviar un correo electrónico
Tabla de correo electrónico
Tabla ActivityMimeAttachment

  • Last updated on