Tabelle delle attività di posta elettronica

La tabella delle attività di posta elettronica consente di tenere traccia e gestire le comunicazioni tramite posta elettronica con i clienti.

Azioni su un'attività di posta elettronica

Usando i servizi Web Dataverse, è possibile eseguire le azioni seguenti su un'attività di posta elettronica:

• Creare, recuperare, aggiornare ed eliminare l'attività di posta elettronica.

• Inviare messaggi di posta elettronica o inviare messaggi di posta elettronica utilizzando i modelli di posta elettronica (Template). Per altre informazioni sui modelli di posta elettronica, vedere Creare modelli di posta elettronica.

• Allega i file come allegati utilizzando l'attributo (ActivityMimeAttachment) nel messaggio di posta elettronica.

• Inviare messaggi di posta elettronica di massa o in blocco.

• Configurare i messaggi di posta elettronica in ingresso da recapitare da Microsoft Exchange Server a qualsiasi utente o coda o messaggi in uscita da inviare da qualsiasi utente o coda a Microsoft Exchange Server.

  Se gli attributi dell'organizzazione Organization.RequireApprovalForuserEmail and Organization.RequireApprovalForQueueEmail (elabora e-mail solo per utenti/code approvati) sono impostati su true (1), si verifica quanto segue: i messaggi e-mail vengono recapitati o inviati da un utente o dalla coda solo se l'indirizzo e-mail principale dell'utente o della coda è approvato. Gli attributi SystemUser.EmailRouterAccessApproval e Queue.EmailRouterAccessApproval indicano lo stato rispettivamente dell'indirizzo email principale dell'utente e della coda e il valore deve essere impostato su 1. In caso contrario, i messaggi in ingresso e in uscita vengono bloccati. Puoi aggiornare il record dell'utente o della coda per modificare il valore dell'attributo, se non è già nello stato di approvazione, purché all'account utente sia assegnato il privilegio prvApproveRejectEmailAddress.

Posta elettronica in blocco

Dataverse supporta l'invio di messaggi di posta elettronica a un elenco di destinatari di grandi dimensioni tramite una richiesta di posta elettronica in blocco. Quando si invia una richiesta di posta elettronica in blocco a Dataverse, viene creata un'operazione asincrona nella coda del servizio asincrona che invia i messaggi di posta elettronica usando un processo in background. Questo processo migliora le prestazioni del sistema.

Usa i messaggi SendBulkMailRequest e BackgroundSendEmailRequest per inviare email di massa. L'elenco seguente descrive la sequenza usata per inviare messaggi di posta elettronica in blocco:

1. Esegui la richiesta SendBulkMail. Questa richiesta contiene una query che seleziona i destinatari dell'e-mail di destinazione e un modello di e-mail per la composizione di ogni e-mail.

2. Il servizio asincrono crea le attività di posta elettronica per ogni destinatario.

3. Il servizio asincrono invia ogni messaggio di posta elettronica. I messaggi di posta elettronica hanno uno stato di invio "in sospeso".

4. Il router di posta elettronica, Dynamics 365 per Outlook o un componente di invio di posta elettronica di terze parti interroga Dataverse alla ricerca di messaggi di posta elettronica in sospeso. Se ne trova uno, scarica il messaggio usando la BackgroundSendEmail richiesta.

5. La BackgroundSendEmail richiesta esegue le seguenti operazioni: controlla se sono presenti messaggi di posta elettronica in sospeso, scarica l'e-mail al chiamante del BackgroundSendEmailRequest messaggio e sincronizza i download se sono presenti più chiamanti.

   Annotazioni

   Il provider di servizi di posta elettronica potrebbe avere limiti che influiscono sul numero di messaggi di posta elettronica che è possibile inviare entro un periodo di tempo. Per altre informazioni, vedere Exchange Online limiti > di invio.

6. Il chiamante del BackgroundSendEmailRequest messaggio riceve il messaggio di posta elettronica scaricato e lo invia.

Allegati di posta elettronica

Gli allegati di posta elettronica sono file che è possibile allegare ai messaggi di posta elettronica o ai modelli di posta elettronica. Un file allegato può essere in qualsiasi formato di file di computer standard, ad esempio documenti di Office Outlook, fogli di calcolo di Office Excel, file CAD e file PDF. È possibile allegare più file come allegati e-mail a un'e-mail o a un modello di e-mail. La proprietà Organization.MaxUploadFileSize determina le dimensioni massime dei file che è possibile caricare. Impostare questa proprietà nella scheda Posta elettronica delle impostazioni di sistema nell'applicazione Dynamics 365. Questa impostazione limita le dimensioni dei file che è possibile allegare a messaggi di posta elettronica, note e risorse Web. L'impostazione predefinita è 5 MB.

Per allegare un allegato email a un messaggio email o a un modello, usa le colonne ActivityMimeAttachment.ObjectTypeCode e ActivityMimeAttachment.ObjectId durante la creazione o l'aggiornamento di una riga dell'allegato MIME dell'attività.

Nell'esempio di codice seguente viene illustrato come allegare un allegato di posta elettronica a un messaggio di posta elettronica:

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

Analogamente, per allegare l'allegato di posta elettronica a un modello anziché a un messaggio di posta elettronica, sostituire i valori degli ActivityMimeAttachment.ObjectId attributi e ActivityMimeAttachment.ObjectTypeCode come indicato di seguito nel codice precedente:

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

Per un esempio di codice completo su come creare allegati di posta elettronica, vedere Esempio: Creare, recuperare, aggiornare ed eliminare un allegato di posta elettronica.

Riutilizzo degli allegati di posta elettronica

Quando si crea un record di allegato e-mail, Dataverse salva il file allegato come file BLOB. L'attributo ActivityMimeAttachment.AttachmentId del record dell'allegato di posta elettronica identifica in modo univoco il file BLOB. Questo processo facilita il riutilizzo degli allegati di file con altri record modello di posta elettronica e di posta elettronica, senza creare e archiviare più copie dello stesso file nel database.

Per riutilizzare un file allegato esistente:

1. Recuperare la ActivityMimeAttachment riga contenente il file allegato da riutilizzare, come illustrato nell'esempio di codice seguente:

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

2. Crea un nuovo allegato di posta elettronica, associalo alla riga del modello e-mail o di posta elettronica richiesta e puntalo al file allegato della riga ActivityMimeAttachment recuperata, come illustrato nell'esempio di codice seguente:

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

Poiché si riutilizza un file di allegato esistente, non è necessario specificare i valori di ActivityMimeAttachment.Body colonna e ActivityMimeAttachment.FileName durante la creazione e l'associazione delle righe degli allegati di posta elettronica ai messaggi di posta elettronica o ai modelli di posta elettronica.

Archiviazione della posta elettronica

Le descrizioni dei messaggi di posta elettronica (corpo del messaggio di posta elettronica) sono state archiviate fino a questo punto nell'archivio relazionale Dataverse. Questo sta cambiando poiché la colonna Email.Description nella tabella di attività email viene spostata nel storage BLOB non strutturato di Azure. L'archiviazione BLOB di Azure viene usata anche per l'archiviazione di allegati, annotazioni, file e immagini.

Periodo di transizione

La migrazione dei dati dall'archivio delle relazioni dataverse all'archivio BLOB di Azure per tutti i clienti dovrebbe iniziare a maggio 2023. Questa migrazione dei dati verrà eseguita come processo in background (job). Lo spostamento iniziale dei dati per i clienti esistenti dovrebbe durare da circa 6 a 12 settimane e probabilmente anche più a seconda delle dimensioni dei dati. Dopo lo spostamento iniziale dei dati, qualsiasi migrazione rimanente è un processo continuo. Tutte le descrizioni dei messaggi di posta elettronica precedenti a dodici mesi verranno spostate automaticamente nell'archivio BLOB di Azure e questo periodo di transizione di dodici mesi non può essere modificato. I messaggi di posta elettronica più recenti non verranno spostati fino a quando non diventano 12 mesi. Il processo di migrazione della descrizione della posta elettronica viene eseguito periodicamente, circa una volta ogni 30-60 giorni per ogni tenant.

Questa migrazione dei dati sarà trasparente per l'utente, con l'eccezione che si noterà una riduzione delle dimensioni della tabella ActivityPointer dopo il completamento completo del processo di migrazione. Nell'interfaccia di amministrazione di Power Platform all'interno del report Capacità sarà disponibile un nuovo elemento della riga di posta elettronica in Utilizzo file. Il risultato finale è un aumento dell'utilizzo complessivo dell'archiviazione file e della riduzione dell'archiviazione del database utilizzata.

Le limitazioni indicate nella sezione successiva inizieranno a essere applicate a tutti i dati già spostati nell'archivio BLOB di Azure gestito da Dataverse anche se tutto lo spostamento dei dati non è completo.

Limitazioni di ricerca e filtro

Per le descrizioni delle email (corpi) archiviate nell'Archiviazione BLOB di Azure, si applicano alcune limitazioni al filtraggio, all'individuazione e alla ricerca delle descrizioni delle email, come descritto nelle sezioni seguenti.

Filtraggio

L'applicazione di filtri alle descrizioni dei messaggi di posta elettronica non è supportata. Alcuni punti specifici da considerare sono:

• FetchXML: non è possibile eseguire ricerche nei corpi di posta elettronica usando FetchXML.
• Ricerca rapida e Ricerca avanzata: non è possibile filtrare le descrizioni dei messaggi di posta elettronica usando questi metodi.

Ricerca

È possibile abilitare la ricerca di Dataverse nelle descrizioni dei messaggi di posta elettronica per cercare le descrizioni dei messaggi di posta elettronica.

Vedere anche

Tabelle attività
Esempio: Inviare un messaggio di posta elettronica
Tabella di posta elettronica
Tabella ActivityMimeAttachment