E-pasta darbību tabulas

E-pasta darbība ļauj izsekot un pārvaldīt e-pasta saziņu ar klientiem.

Darbības ar e-pasta darbību

Izmantojot Dataverse tīmekļa pakalpojumus, varat veikt šādas darbības ar e-pasta darbību:

  • Izveidojiet, izgūstiet, atjauniniet un dzēsiet e-pasta darbību.

  • Sūtiet e-pasta ziņojumus vai sūtiet e-pasta ziņojumus, izmantojot e-pasta veidnes (Template). Papildinformāciju par e-pasta veidnēm skatiet sadaļā E-pasta veidņu izveide.

  • Pievienojiet failus kā pielikumus, izmantojot e-pasta ziņojumā esošo atribūtu (ActivityMimeAttachment).

  • Sūtīt lielapjoma vai lielapjoma e-pasta ziņojumus.

  • Konfigurēt ienākošos e-pasta ziņojumus, ko piegādāt no Microsoft Exchange Server jebkuram lietotājam vai rindai, vai izejošajiem ziņojumiem, kas no jebkura lietotāja vai rindas jānosūta Microsoft Exchange Server.

    Ja organizācijas Organization.RequireApprovalForuserEmail atribūti un Organization.RequireApprovalForQueueEmail (apstrādāt e-pasta ziņojumus tikai apstiprinātiem lietotājiem/rindām) ir iestatīti uz true (1), notiek šādi: e-pasta ziņojumi tiek piegādāti vai nosūtīti no lietotāja vai rindas tikai tad, ja ir apstiprināta lietotāja vai rindas primārā e-pasta adrese. Atribūti SystemUser.EmailRouterAccessApproval un Queue.EmailRouterAccessApproval norāda attiecīgi lietotāja un rindas primārās e-pasta adreses statusu, un vērtībai jābūt iestatītai uz 1. Pretējā gadījumā ienākošie un izejošie ziņojumi tiks bloķēti. Varat atjaunināt lietotāja vai rindas ierakstu, lai mainītu atribūta vērtību, ja tas vēl nav apstiprinātā stāvoklī, ja jūsu lietotāja kontam ir piešķirta privilēģija prvApproveRejectEmailAddress .

Piezīmes

Dataverse atribūts Email.StatusCode nevar būt nulle.

Lielapjoma e-pasts

Dataverse atbalsta e-pasta ziņojumu nosūtīšanu lielam adresātu sarakstam, izmantojot lielapjoma e-pasta pieprasījumu. Kad lielapjoma e-pasta pieprasījums tiek nosūtīts uz Dataverse, asinhronajā pakalpojumu rindā tiek izveidota asinhrona operācija, kas nosūta e-pasta ziņojumus, izmantojot fona procesu. Tas nodrošina uzlabotu sistēmas veiktspēju.

Ziņojumi SendBulkMailRequest un BackgroundSendEmailRequest tiek izmantoti lielapjoma e-pasta ziņojumu sūtīšanai. Tālāk ir norādīta secība, kas tiek izmantota lielapjoma e-pasta sūtīšanai:

  1. Izpildiet pieprasījumu SendBulkMail . Šajā pieprasījumā ir iekļauts vaicājums, kurā tiek atlasīti mērķa e-pasta adresāti, un e-pasta veidne katra e-pasta ziņojuma sastādīšanai.

  2. Asinhronais pakalpojums izveido e-pasta darbības katram adresātam.

  3. Asinhronais pakalpojums nosūta katru e-pasta ziņojumu. E-pasta ziņojumiem ir nosūtīšanas statuss "gaida".

  4. E-pasta maršrutētājs, Dynamics 365 programmai Outlook vai trešās puses e-pasta nosūtīšanas komponents aptaujā Dataverse par gaidāmajiem e-pasta ziņojumiem un, ja tāds tiek atrasts, lejupielādē to, izmantojot BackgroundSendEmail pieprasījumu.

  5. Pieprasījums BackgroundSendEmail veic šādas darbības: pārbauda, vai nav gaidāmu e-pasta ziņojumu, lejupielādē e-pasta ziņojumu ziņojuma zvanītājam BackgroundSendEmailRequest un sinhronizē lejupielādes, ja ir vairāki zvanītāji.

    Piezīmes

    Jūsu e-pasta pakalpojumu sniedzējam var būt ierobežojumi, kas ietekmē e-pasta ziņojumu skaitu, ko varat nosūtīt noteiktā laika periodā. Papildinformācija: Exchange Online ierobežojumi > Sūtīšanas ierobežojumi.

  6. Ziņojuma BackgroundSendEmailRequest zvanītājs saņem lejupielādēto e-pasta ziņojumu un nosūta to.

E-pasta pielikumi

E-pasta pielikumi ir faili, kurus var pievienot e-pasta ziņojumiem vai e-pasta veidnēm. Pievienotais fails var būt jebkurā standarta datora faila formātā, piemēram, Office Outlook dokumenti, Office Excel izklājlapas, CAD faili un PDF faili. Varat pievienot vairākus failus kā e-pasta pielikumus e-pasta vai e-pasta veidnei. Augšupielādējamo failu maksimālo lielumu nosaka rekvizīts Organization.MaxUploadFileSize . Šis rekvizīts ir iestatīts Dynamics 365 lietojumprogrammas Sistēmas iestatījumu cilnē E-pasts. Šis iestatījums ierobežo to failu lielumu, kurus var pievienot e-pasta ziņojumiem, piezīmēm un tīmekļa resursiem. Noklusējuma iestatījums ir 5 MB.

Lai pievienotu e-pasta pielikumu ar e-pasta ziņojumu vai veidni, izmantojiet kolonnas un ActivityMimeAttachment.ObjectIdActivityMimeAttachment.ObjectTypeCode , veidojot vai atjauninot darbības mime pielikuma rindu.

Tālāk sniegtajā koda piemērā ir parādīts, kā e-pasta ziņojumam pievienot e-pasta pielikumu.

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

Līdzīgi, lai pievienotu e-pasta pielikumu veidnei, nevis e-pasta ziņojumam, iepriekš minētajā kodā atribūtu ActivityMimeAttachment.ObjectTypeCode un vērtības ActivityMimeAttachment.ObjectId tiks aizstātas šādi:

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

Pilnu koda piemēru par e-pasta pielikumu izveidi skatiet sadaļā Paraugs: e-pasta pielikuma izveide, izgūšana, atjaunināšana un dzēšana.

E-pasta pielikumu atkārtota izmantošana

Izveidojot e-pasta pielikuma ierakstu, pievienotais fails tiek saglabāts kā faila BLOB. E-pasta ActivityMimeAttachment.AttachmentId pielikuma ieraksta atribūts unikāli identificē faila BLOB. Tas tiek darīts, lai atvieglotu failu pielikumu atkārtotu izmantošanu ar citiem e-pasta un e-pasta veidņu ierakstiem, neizveidojot un nesaglabājot vairākas viena un tā paša faila kopijas datu bāzē.

Lai atkārtoti izmantotu esošu faila pielikumu, veiciet tālāk norādītās darbības.

  1. Izgūstiet ActivityMimeAttachment rindu, kurā ir atkārtoti izmantojamais pielikuma fails, kā parādīts šajā koda piemērā:

    ActivityMimeAttachment retrievedAttachment = 
        (ActivityMimeAttachment)_serviceProxy
        .Retrieve(ActivityMimeAttachment.EntityLogicalName, _emailAttachmentId, new ColumnSet(true));  
    
  2. Izveidojiet jaunu e-pasta pielikumu, saistiet to ar nepieciešamo e-pasta vai e-pasta veidnes rindu un norādiet to uz izgūtās ActivityMimeAttachment rindas pievienoto failu, kā parādīts šajā koda piemērā:

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

Tā kā atkārtoti izmantojat esošu pielikuma failu, nav jānorāda kolonnas ActivityMimeAttachment.Body vērtības un ActivityMimeAttachment.FileName , veidojot un saistot e-pasta pielikumu rindas ar e-pasta ziņojumiem vai e-pasta veidnēm.

E-pasta krātuve

E-pasta apraksti (e-pasta pamatteksts) līdz šim brīdim ir glabāti Dataverse relāciju krātuvē. Tas mainās, jo kolonna Email.Descriptione-pasta darbību tabulā tiek pārvietota uz nestrukturētu Azure BLOB krātuvi. Azure BLOB krātuve tiek izmantota arī pielikumu, anotāciju, failu un attēlu glabāšanai.

Pārejas periods

Paredzams, ka datu migrācija no Dataverse relāciju krātuves uz Azure Blob krātuvi visiem klientiem sāksies 2023. gada maijā. Šī datu migrācija notiks kā fona process (darbs). Paredzams, ka sākotnējā datu kustība esošajiem klientiem ilgs apmēram 6 līdz 12 nedēļas un, iespējams, pat ilgāk atkarībā no datu lieluma. Pēc sākotnējās datu pārvietošanas atlikusī migrācija ir nepārtraukts process. Visi e-pasta apraksti, kas vecāki par divpadsmit mēnešiem, tiks automātiski pārvietoti uz Azure BLOB krātuvi, un šo divpadsmit mēnešu pārejas periodu nevar mainīt. Jaunāki e-pasta ziņojumi netiks pārvietoti, kamēr tie nebūs sasnieguši 12 mēnešu vecumu. E-pasta apraksta migrācijas darbs tiek izpildīts periodiski - apmēram reizi 30-60 dienās katram nomniekam.

Šī datu migrācija jums būs pārredzama, izņemot to, ka pēc migrācijas procesa pilnīgas pabeigšanas redzēsit tabulas ActivityPointer lieluma samazināšanos. Power Platform administrēšanas centrā noslodzes pārskatā jauns e-pasta rindas vienums būs pieejams sadaļā Failu lietojums. Gala rezultāts ir kopējā failu krātuves patēriņa pieaugums un patērētās datu bāzes krātuves samazināšanās.

Piezīmes

Failu krātuves palielinājums var būt mazāks nekā tas, kas tiek noņemts no tabulas ActivityPointer failu datu saspiešanas dēļ.

Nākamajā sadaļā minētie ierobežojumi tiks piemēroti visiem datiem, kas jau ir pārvietoti uz Dataverse pārvaldīto Azure BLOB krātuvi, pat ja visa datu pārvietošana nav pabeigta.

Meklēšanas un filtrēšanas ierobežojumi

E-pasta aprakstiem (pamattekstiem), kas tiek glabāti Azure BLOB krātuvē, tiek piemēroti noteikti ierobežojumi e-pasta aprakstu filtrēšanai, atrašanai un meklēšanai, kā aprakstīts tālāk.

Filtrēšana

E-pasta ziņojumu aprakstu filtrēšana netiek atbalstīta. Daži konkrēti aspekti, kas jāņem vērā, ir šādi.

  • FetchXML — jūs nevarēsiet meklēt e-pasta tekstos, izmantojot FetchXML.
  • Ātrā atrašana un detalizētā atrašana — e-pasta aprakstu filtrēšana, izmantojot šīs metodes, netiek atbalstīta.

Padoms

Ātrās atrašanas gadījumā, lai gan filtrēšana netiek atbalstīta, e-pasta pamattekstu var pievienot kā atgriezto kolonnu, un pamatteksta dati tiks atgriezti rezultātā.

Meklēšanu

Varat iespējot Dataverse meklēšanu e-pasta aprakstos, lai meklētu e-pasta aprakstus.

Skatiet arī

Aktivitāšu tabulas
Paraugs: nosūtīt e-pastu
E-pasta tabula
ActivityMimeAttachment tabula