Таблицы активности электронной почты

Таблица действий электронной почты помогает отслеживать сообщения электронной почты и управлять ими с клиентами.

Действия на активности электронной почты

С помощью веб-служб Dataverse можно выполнить следующие действия по электронной почте:

Создание, получение, обновление и удаление действий электронной почты.
Отправляйте сообщения электронной почты или отправляйте сообщения электронной почты с помощью шаблонов электронной почты (Template). Дополнительные сведения о шаблонах электронной почты см. в статье "Создание шаблонов электронной почты".
Прикрепляйте файлы в виде вложений с помощью атрибута (ActivityMimeAttachment) в сообщении электронной почты.
Групповая и массовая рассылка сообщений электронной почты.
Настройте входящие сообщения электронной почты для доставки из Microsoft Exchange Server любому пользователю или очереди, а также исходящие сообщения для отправки от любого пользователя или очереди в Microsoft Exchange Server.

Если для атрибутов Organization.RequireApprovalForuserEmail организации and Organization.RequireApprovalForQueueEmail (обрабатывать сообщения электронной почты только для утвержденных пользователей/очередей) задано значение true (1), происходит следующее: сообщения электронной почты доставляются или отправляются от пользователя или очереди только в том случае, если основной адрес электронной почты пользователя или очереди утвержден. Атрибуты SystemUser.EmailRouterAccessApprovalQueue.EmailRouterAccessApproval and указывают на статус основного адреса электронной почты пользователя и очереди соответственно, и значение должно быть равно 1. В противном случае входящие и исходящие сообщения блокируются. Вы можете обновить запись пользователя или очереди, чтобы изменить значение атрибута, если оно еще не имеет состояния "Утверждено", при условии, что вашей учетной записи пользователя назначена привилегия prvApproveRejectEmailAddress.

Замечание

В Dataverse Email.StatusCode атрибут не может иметь значение NULL.

Массовая электронная почта

Dataverse поддерживает отправку электронной почты в большой список получателей с помощью массового запроса на электронную почту. При отправке запроса на массовую рассылку электронной почты в Dataverse создается асинхронная операция в очереди асинхронной службы, которая отправляет сообщения электронной почты с помощью фонового процесса. Этот процесс повышает производительность системы.

Используйте сообщения SendBulkMailRequest и BackgroundSendEmailRequest для отправки массовых электронных писем. В следующем списке описывается последовательность, используемая для отправки массового сообщения электронной почты:

Выполните SendBulkMail запрос. Этот запрос содержит запрос, который выбирает целевых получателей письма, и шаблон письма для составления каждого письма.
Асинхронная служба создает операции с электронной почтой для каждого получателя.
Асинхронная служба отправляет каждое сообщение электронной почты. Сообщения электронной почты имеют статус «Ожидание» отправки.
Маршрутизатор электронной почты, Dynamics 365 for Outlook или сторонний компонент отправки электронной почты периодически проверяет Dataverse на наличие ожидающих отправки сообщений электронной почты. Если он находит его, он скачивает сообщение с помощью BackgroundSendEmail запроса.
Запрос BackgroundSendEmail выполняет следующие операции: проверяет наличие ожидающих сообщений электронной почты, загружает электронное письмо вызывающему BackgroundSendEmailRequest сообщение и синхронизирует загрузку, если звонящих несколько.

Замечание

У поставщика услуг электронной почты могут быть ограничения, влияющие на количество сообщений электронной почты, которые можно отправлять в течение определенного периода времени. Дополнительные сведения см. в разделе «Ограничения отправки в Exchange Online»>.
Вызывающий объект сообщения BackgroundSendEmailRequest получает загруженное сообщение электронной почты и отправляет его.

Вложения электронной почты

Вложения электронной почты — это файлы, которые можно вложить в сообщения электронной почты или шаблоны электронной почты. Вложенный файл может находиться в любом стандартном формате файлов компьютера, таких как документы Office Outlook, электронные таблицы Office Excel, ФАЙЛЫ CAD и PDF-файлы. Вы можете прикрепить несколько файлов в качестве вложений электронной почты к электронному письму или шаблону электронной почты. Свойство Organization.MaxUploadFileSize определяет максимальный размер файлов, которые можно отправить. Задайте это свойство на вкладке "Электронная почта"системных параметров в приложении Dynamics 365. Этот параметр ограничивает размер файлов, которые можно вложить в сообщения электронной почты, заметки и веб-ресурсы. Значение по умолчанию — 5 МБ.

Чтобы добавить вложение электронной почты к сообщению или шаблону электронной почты, при создании или обновлении строки вложения MIME действия используйте столбцы ActivityMimeAttachment.ObjectId и ActivityMimeAttachment.ObjectTypeCode.

В следующем примере кода показано, как прикрепить вложение электронной почты к электронному письму:

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"};

Аналогичным образом, чтобы прикрепить вложение письма к шаблону, а не к письму, замените значения атрибутов ActivityMimeAttachment.ObjectId и ActivityMimeAttachment.ObjectTypeCode в предыдущем фрагменте кода следующим образом:

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

Полный пример кода о создании вложений электронной почты см. в разделе "Пример: создание, извлечение, обновление и удаление вложения электронной почты".

Повторное использование вложений электронной почты

При создании записи вложения электронной почты Dataverse сохраняет прикрепленный файл как BLOB-объект файла. Атрибут ActivityMimeAttachment.AttachmentId записи вложения электронной почты однозначно идентифицирует файловый BLOB. Этот процесс упрощает повторное использование вложений файлов с другими записями электронной почты и шаблона электронной почты, не создавая и сохраняя несколько копий одного и того же файла в базе данных.

Чтобы повторно использовать существующий вложенный файл:

ActivityMimeAttachment Получите строку, содержащую файл вложения, который требуется повторно использовать, как показано в следующем примере кода:
```
ActivityMimeAttachment retrievedAttachment = 
    (ActivityMimeAttachment)_serviceProxy
    .Retrieve(ActivityMimeAttachment.EntityLogicalName, _emailAttachmentId, new ColumnSet(true));  
```
Создайте новое вложение электронной почты, свяжите его с требуемой строкой электронной почты или шаблоном электронной почты и наведите на него вложенный файл полученной ActivityMimeAttachment строки, как показано в следующем примере кода:
```
ActivityMimeAttachment _reuseAttachment = new ActivityMimeAttachment{  
  ObjectId = new EntityReference(Email.EntityLogicalName, _emailId),  
  ObjectTypeCode = Email.EntityLogicalName,  
  Subject = "Sample Attachment",  
  AttachmentId = retrievedAttachment.AttachmentId};  
```

Так как вы повторно используете существующий файл вложения, вам не нужно указывать значения столбцов ActivityMimeAttachment.Body и ActivityMimeAttachment.FileName при создании и связывании строк вложения электронной почты с электронными письмами или шаблонами электронной почты.

Хранилище электронной почты

Описания электронной почты (текст сообщения электронной почты) хранятся до этого момента в реляционном хранилище Dataverse. Это изменяется, так как столбец Email.Description в таблице действий электронной почты перемещается в неструктурированное хранилище BLOB-объектов Azure. Хранилище BLOB-объектов Azure также используется для хранения вложений, заметок, файлов и изображений.

Переходный период

Ожидается, что миграция данных из хранилища реляционных объектов Dataverse в хранилище BLOB-объектов Azure для всех клиентов начнется в мае 2023 года. Миграция данных будет проходить в качестве фонового процесса (задания). Ожидается, что первоначальное перемещение данных для существующих клиентов должно длиться около 6–12 недель и, возможно, даже дольше в зависимости от размера данных. После первоначального перемещения данных любая оставшаяся миграция является непрерывным процессом. Все описания электронной почты старше двенадцати месяцев будут перемещены в хранилище Blob Azure автоматически, и этот двенадцатимесячный переходный период не может быть изменён. Новые сообщения электронной почты не будут перемещаться, пока их возраст не достигнет 12 месяцев. Задание миграции описания электронной почты периодически выполняется примерно каждые 30–60 дней на клиента.

Эта миграция данных будет прозрачной для вас, за исключением того, что вы увидите сокращение размера таблицы ActivityPointer после завершения процесса миграции. В Центре администрирования Power Platform в отчете о емкости новый элемент строки электронной почты будет доступен в разделе "Использование файлов". Конечным результатом является увеличение общего потребления файлового хранилища и сокращение потребляемого хранилища базы данных.

Замечание

Увеличение хранилища файлов может быть меньше, чем то, что удалено из таблицы ActivityPointer из-за сжатия данных файла.

Ограничения, упомянутые в следующем разделе, начнут применяться к любым данным, которые уже перемещены в управляемое хранилище BLOB-объектов Azure Dataverse, даже если все перемещение данных не завершено.

Ограничения поиска и фильтрации

К описаниям электронных писем (текстам писем), хранящимся в хранилище BLOB-объектов Azure, применяются некоторые ограничения на фильтрацию, нахождение и поиск, как описано в следующих разделах.

Filtering

Фильтрация по описаниям электронной почты не поддерживается. Ниже приведены некоторые конкретные моменты, которые следует учитывать:

FetchXML — нельзя выполнять поиск в тексте электронных писем с помощью FetchXML.
Быстрый поиск и расширенный поиск — с помощью этих способов нельзя фильтровать описания сообщений электронной почты.

Подсказка

Для функции быстрого поиска фильтрация не поддерживается, однако можно добавить текст сообщения электронной почты в возвращаемые столбцы и включить данные текста сообщения в результат.

Поиск

Вы можете включить поиск Dataverse для описаний сообщений электронной почты, чтобы выполнять поиск по ним.

См. также

Таблицы действий
Пример. Отправка сообщения электронной почты
Таблица электронной почты
Таблица ActivityMimeAttachment table

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-08-20