Tabele de activitate prin e-mail

Tabelul de activități de e-mail vă ajută să urmăriți și să gestionați comunicațiile prin e-mail cu clienții.

Acțiuni într-o activitate de e-mail

Utilizând serviciile web Dataverse, puteți efectua următoarele acțiuni pentru o activitate de e-mail:

  • Creați, regăsiți, actualizați și ștergeți activitatea de e-mail.

  • Trimiteți mesaje de e-mail sau trimiteți mesaje de e-mail utilizând șabloane de e-mail (Template). Pentru mai multe informații despre șabloanele de e-mail, consultați Crearea șabloanelor de e-mail.

  • Atașați fișiere ca atașamente utilizând atributul (ActivityMimeAttachment) din mesajul de e-mail.

  • Trimiteți mesaje de e-mail în masă sau în masă.

  • Configurați mesajele de e-mail primite pentru a fi livrate de la Microsoft Exchange Server către orice utilizator sau coadă de așteptare sau mesajele de ieșire de trimis de la orice utilizator sau coadă pentru a Microsoft Exchange Server.

    Dacă atributele organizației Organization.RequireApprovalForuserEmail și Organization.RequireApprovalForQueueEmail (procesați e-mailurile numai pentru utilizatori/cozi aprobate) sunt setate la true (1), se întâmplă următoarele: mesajele de e-mail sunt livrate sau trimise de la un utilizator sau coadă numai dacă adresa de e-mail principală a utilizatorului sau a cozii este aprobată. Atributele SystemUser.EmailRouterAccessApproval și indică Queue.EmailRouterAccessApproval starea adresei de e-mail principale a utilizatorului și, respectiv, a cozii, iar valoarea trebuie setată la 1. În caz contrar, mesajele de intrare și de ieșire sunt blocate. Puteți actualiza înregistrarea utilizatorului sau a cozii pentru a modifica valoarea atributului, dacă nu este deja în starea aprobată, cu condiția ca contul de utilizator să aibă atribuit privilegiul prvApproveRejectEmailAddress .

Notă

În Dataverse, atributul Email.StatusCode nu poate fi nul.

E-mail în bloc

Dataverse acceptă trimiterea de e-mailuri către o listă mare de destinatari printr-o solicitare de e-mail în bloc. Atunci când trimiteți o solicitare de e-mail în masă către Dataverse, aceasta creează o operațiune asincronă în coada de servicii asincronă care trimite mesajele de e-mail utilizând un proces de fundal. Acest proces îmbunătățește performanța sistemului.

Utilizați și BackgroundSendEmailRequest mesajele SendBulkMailRequest pentru a trimite mesaje de e-mail în masă. Următoarea listă descrie secvența utilizată pentru a trimite mesaje de e-mail în masă:

  1. Executați solicitarea SendBulkMail . Această solicitare conține o interogare care selectează destinatarii de e-mail țintă și un șablon de e-mail pentru compunerea fiecărui e-mail.

  2. Serviciul asincron creează activitățile de e-mail pentru fiecare destinatar.

  3. Serviciul asincron trimite fiecare mesaj de e-mail. Mesajele de e-mail au o stare de trimitere "în așteptare".

  4. Ruterul de e-mail, Dynamics 365 pentru Outlook sau un e-mail terț trimite sondaje Dataverse pentru mesajele de e-mail în așteptare. Dacă găsește unul, acesta descarcă mesajul utilizând BackgroundSendEmail solicitarea.

  5. Solicitarea BackgroundSendEmail efectuează următoarele operații: verifică dacă sunt prezente mesaje de e-mail în așteptare, descarcă e-mailul către apelantul mesajului BackgroundSendEmailRequest și sincronizează descărcările dacă există mai mulți apelanți.

    Notă

    Este posibil ca furnizorul de servicii de e-mail să aibă limite care afectează numărul de e-mailuri pe care le puteți trimite într-o perioadă de timp. Pentru mai multe informații, consultați limitele de Exchange Online > limitele de trimitere.

  6. Apelantul mesajului BackgroundSendEmailRequest primește mesajul de e-mail descărcat și îl trimite.

Atașamente de e-mail

Atașările de e-mail sunt fișiere pe care le puteți atașa la mesajele de e-mail sau la șabloanele de e-mail. Un fișier atașat poate fi în orice format de fișier standard de computer, cum ar fi documente Office Outlook, foi de calcul Office Excel, fișiere CAD și fișiere PDF. Puteți atașa mai multe fișiere ca atașamente de e-mail la un e-mail sau la un șablon de e-mail. Proprietatea Organization.MaxUploadFileSize determină dimensiunea maximă a fișierelor pe care le puteți încărca. Setați această proprietate în fila E-mail a setărilor de sistem din aplicația Dynamics 365. Această setare limitează dimensiunea fișierelor pe care le puteți atașa la mesajele de e-mail, notele și resursele web. Setarea implicită este 5 MB.

Pentru a atașa o atașare de e-mail cu un mesaj de e-mail sau un șablon, utilizați coloanele ActivityMimeAttachment.ObjectId și ActivityMimeAttachment.ObjectTypeCode în timp ce creați sau actualizați un rând de atașare mime activitate.

Următorul exemplu de cod arată cum să atașați un atașament de e-mail la un e-mail:

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

În mod similar, pentru a atașa atașarea de e-mail la un șablon în locul unui mesaj de e-mail, înlocuiți valorile atributelor ActivityMimeAttachment.ObjectId și ActivityMimeAttachment.ObjectTypeCode după cum urmează în codul precedent:

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

Pentru un exemplu complet de cod despre cum să creați atașări de e-mail, consultați Eșantion: Crearea, regăsirea, actualizarea și ștergerea unei atașări de e-mail.

Reutilizarea atașărilor de e-mail

Atunci când creați o înregistrare atașare de e-mail, Dataverse salvează fișierul atașat ca fișier BLOB. Atributul ActivityMimeAttachment.AttachmentId înregistrării atașării de e-mail identifică în mod unic fișierul BLOB. Acest proces facilitează reutilizarea atașărilor de fișier cu alte înregistrări de șabloane de e-mail și de e-mail, fără a crea și stoca mai multe copii ale aceluiași fișier în baza de date.

Pentru a reutiliza un fișier atașat existent:

  1. Preluați rândul ActivityMimeAttachment care conține fișierul atașat pe care doriți să-l reutilizați, așa cum se arată în următorul exemplu de cod:

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

  2. Creați o nouă atașare de e-mail, asociați-o cu rândul necesar de e-mail sau șablon de e-mail și îndreptați-l către fișierul atașat al rândului preluat ActivityMimeAttachment , așa cum se arată în următorul exemplu de cod:

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

Deoarece reutilizați un fișier atașat existent, nu trebuie să specificați ActivityMimeAttachment.Body valorile coloanei și ActivityMimeAttachment.FileName în timp ce creați și asociați rânduri de atașamente de e-mail la e-mailuri sau șabloane de e-mail.

Stocare e-mail

Descrierile de e-mail (corpul e-mailului) au fost stocate până în acest moment în depozitul relațional Dataverse. Acest lucru se schimbă pe măsură ce coloana Email.Description din tabelul de activitate de e-mail este mutată în spațiul de stocare Azure Blob nestructurat. Stocarea Azure Blob este, de asemenea, utilizată pentru stocarea atașărilor, adnotărilor, fișierelor și imaginilor.

Perioada de tranziție

Migrarea datelor din depozitul de relații Dataverse la stocarea Azure Blob pentru toți clienții este de așteptat să înceapă în mai 2023. Această migrare a datelor va avea loc ca un proces de fundal (job). Mișcarea inițială a datelor pentru clienții existenți este de așteptat să dureze aproximativ 6 până la 12 săptămâni și, eventual, chiar mai mult, în funcție de dimensiunea datelor. După mișcarea inițială a datelor, orice migrare rămasă este un proces continuu. Toate descrierile de e-mail mai vechi de douăsprezece luni vor fi mutate automat în spațiul de stocare Azure Blob, iar această perioadă de tranziție de douăsprezece luni nu poate fi modificată. E-mailurile mai noi nu vor fi mutate până când nu împlinesc 12 luni. Activitatea de migrare a descrierii e-mailului rulează periodic - aproximativ o dată la 30-60 de zile per entitate găzduită.

Această migrare a datelor va fi transparentă pentru dvs., cu excepția faptului că veți vedea o reducere a dimensiunii tabelului ActivityPointer după finalizarea completă a procesului de migrare. În centrul de administrare Power Platform din raportul Capacitate , un nou element linie de e-mail va fi disponibil în Utilizare fișier. Rezultatul final este o creștere a consumului general de stocare a fișierelor și o reducere a spațiului de stocare al bazei de date consumate.

Notă

Creșterea spațiului de stocare a fișierelor poate fi mai mică decât cea eliminată din tabelul ActivityPointer din cauza compresiei datelor fișierului.

Limitările menționate în secțiunea următoare vor începe să se aplice oricăror date care s-au mutat deja în spațiul de stocare Azure gestionat de Dataverse, chiar dacă toată mișcarea datelor nu este finalizată.

Limitări de căutare și filtrare

Pentru descrierile de e-mail (organisme) stocate în spațiul de stocare blob Azure, anumite limitări se aplică pentru filtrarea, găsirea și căutarea descrierilor de e-mail, așa cum este descris în secțiunile următoare.

Filtrarea

Filtrarea după descrierile de e-mail nu este acceptată. Iată câteva aspecte specifice de luat în considerare:

  • FetchXML - Nu puteți căuta în corpurile de e-mail utilizând FetchXML.
  • Găsire rapidă și Găsire complexă - Nu puteți filtra descrierile e-mailului utilizând aceste metode.

Sfat

Pentru Găsire rapidă, în timp ce filtrarea nu este acceptată, puteți să adăugați corpul mesajului de e-mail ca coloană returnată și să returnați datele corpului în rezultat.

Căutarea

Puteți activa căutarea Dataverse pe descrierile de e-mail pentru a căuta descrieri de e-mail.

Consultați și

Tabele de activitate
Exemplu: Trimiteți un e-mail
Tabel de e-mail
Tabel ActivityMimeAttachment

  • Ultima actualizare pe