E-mail tevékenységtáblák

Az e-mail-tevékenység lehetővé teszi az ügyfelekkel folytatott e-mail-kommunikáció nyomon követését és kezelését.

E-mail-tevékenységekkel kapcsolatos műveletek

A Dataverse webszolgáltatások használatával az alábbi műveleteket hajthatja végre egy e-mail-tevékenységen:

• Az e-mail-tevékenység létrehozása, lekérése, frissítése és törlése.

• E-mail-üzenetek küldése vagy e-mail-üzenetek küldése e-mail sablonok használatával (Template). További információ az e-mail-sablonokról: E-mail-sablonok létrehozása.

• Csatoljon fájlokat mellékletként az e-mail-üzenet (ActivityMimeAttachment) attribútumával.

• Tömeges e-mail-üzenetek küldése.

• Konfigurálja, hogy a bejövő e-mailek az Microsoft Exchange Server szolgáltatásról bármely felhasználóhoz vagy üzenetsorhoz érkezhessenek, illetve a kimenő üzenetek bármely felhasználótól vagy feldolgozási sorból a Microsoft Exchange Server szolgáltatásba érkezzenek.

  Ha a(z) Organization.RequireApprovalForuserEmail és Organization.RequireApprovalForQueueEmail (csak jóváhagyott felhasználók/feldolgozási sorok e-mailjeinek feldolgozása) szervezeti attribútumok igaz (1) értékre vannak állítva, a következő történik: az e-mailek csak akkor lesznek kézbesítve vagy elküldve egy felhasználótól vagy feldolgozási sorból, ha a felhasználó vagy a feldolgozási sor elsődleges e-mail-címe jóvá van hagyva. A(z) SystemUser.EmailRouterAccessApproval és a(z) Queue.EmailRouterAccessApproval attribútumok a felhasználó és a feldolgozási sor elsődleges e-mail-címének állapotát jelzik, és az értéket 1-re kell állítani. Ellenkező esetben a bejövő és kimenő üzenetek blokkolva lesznek. Frissítheti a felhasználó- vagy üzenetsorrekordot az attribútumérték módosításához, ha még nincs jóváhagyott állapotban, feltéve, hogy a felhasználói fiókjához hozzá van rendelve a prvApproveRejectEmailAddress jogosultság.

Megjegyzés:

A Dataverse-ben az Email.StatusCode attribútum nem lehet null értékű.

Tömeges e-mail

A Dataverse támogatja, hogy tömeges e-mail-kéréssel küldjön e-mailt a címzettek nagy listájára. Amikor tömeges e-mail-kérést küld a Dataverse-nek, a rendszer aszinkron műveletet hoz létre az aszinkron szolgáltatás üzenetsorában, amely háttérfolyamat használatával küldi el az e-maileket. Ez jobb rendszerteljesítményt biztosít.

A(z) SendBulkMailRequest és a(z) BackgroundSendEmailRequest üzenetek a tömeges e-mailek küldésére szolgálnak. Az alábbiakban felsoroljuk a tömeges e-mailek küldéséhez használt sorrendet:

1. Hajtsa végre a(z) SendBulkMail kérést. Ez a kérés tartalmaz egy lekérdezést, amely kiválasztja a cél e-mail címzettjeit, és egy e-mail-sablont az egyes e-mailek elkészítéséhez.

2. Az aszinkron szolgáltatás létrehozza az e-mail-tevékenységeket az egyes címzettek számára.

3. Az aszinkron szolgáltatás minden e-mailt elküld. Az e-mail-üzenetek küldési állapota „függőben”.

4. Az e-mail-útválasztó, a Dynamics 365 for Outlook vagy egy külső e-mail-küldési összetevő lekérdezi a Dataverse-t a függőben lévő e-mailekről, és ha van ilyen, a kéréssel BackgroundSendEmail letölti azt.

5. A BackgroundSendEmail kérés a következő műveleteket hajtja végre: ellenőrzi, hogy vannak-e függőben lévő e-mail-üzenetek, letölti az e-mailt az üzenet hívójának BackgroundSendEmailRequest , és szinkronizálja a letöltéseket, ha több hívó van.

   Megjegyzés:

   Az e-mail-szolgáltatónak lehetnek korlátai, amelyek hatással lehetnek arra, hogy egy adott időszakon belül hány e-mailt küldhet. További információ: Az Exchange Online korlátozza a > küldési korlátokat.

6. Az üzenet hívója BackgroundSendEmailRequest megkapja a letöltött e-mailt, és elküldi azt.

E-mail mellékletek

Az e-mail-mellékletek olyan fájlok, amelyek e-mail-üzenetekhez vagy e-mail-sablonokhoz csatolhatók. A csatolt fájlok bármilyen szabványos számítógépes fájlformátumban lehetnek, például Office Outlook-dokumentumok, Office Excel-számolótáblák, CAD-fájlok és PDF-fájlok. Több fájlt is csatolhat e-mail-mellékletként egy e-mailhez vagy e-mail-sablonhoz. A feltölthető fájlok maximális méretét az Organization.MaxUploadFileSize tulajdonság határozza meg. Ez a tulajdonság a Dynamics 365 alkalmazás Rendszerbeállítások oldalának E-mail lapján állítható be. A beállítás korlátozza az e-mailekhez, jegyzetekhez és webes erőforrásokhoz csatolható fájlok méretét. Az alapértelmezett beállítás 5 MB.

Ha e-mail mellékletet szeretne csatolni egy e-mail-üzenethez vagy sablonhoz, a ActivityMimeAttachment.ObjectId és ActivityMimeAttachment.ObjectTypeCode oszlopokat használja, miközben egy aktivitási mime melléklet sort hoz létre vagy frissít.

Az alábbi kódminta bemutatja, hogyan csatolhat e-mail-mellékletet egy e-mailhez:

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

Hasonlóképpen, ha az e-mail mellékletét egy sablonhoz szeretné csatolni az e-mail helyett, a ActivityMimeAttachment.ObjectId és ActivityMimeAttachment.ObjectTypeCode attribútumok értékeit a fenti kódban az alábbi módon kell lecserélni:

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

Az e-mail mellékletek létrehozásával kapcsolatos teljes kódmintát a Minta: E-mail melléklet létrehozása, lekérése, frissítése és törlése című témakörben talál.

E-mail-mellékletek újrafelhasználása

E-mail-melléklet rekord létrehozásakor a csatolt fájl blobként lesz mentve. Az ActivityMimeAttachment.AttachmentId e-mail-melléklet rekord attribútuma egyedileg azonosítja a blob fájlt. Ez azért történik, hogy megkönnyítse a fájlmellékletek újrafelhasználását más e-mailekkel és e-mail sablonrekordokkal anélkül, hogy ugyanabból a fájlból több másolatot hozna létre és tárolna az adatbázisban.

Meglévő fájlmelléklet újbóli felhasználása:

1. Kérje le azt a ActivityMimeAttachment sort, amely tartalmazza a melléklet fájlt, amelyet újra szeretne felhasználni, ahogyan azt az alábbi példakód mutatja.

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

2. Hozzon létre egy új e-mail-mellékletet, társítsa a szükséges e-mail- vagy e-mail-sablonsorhoz, és mutasson a beolvasott ActivityMimeAttachment sor csatolt fájljára, ahogyan az a következő példakódban látható:

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

Mivel egy meglévő mellékletfájlt használ újra, nem kell megadnia a ActivityMimeAttachment.Body és ActivityMimeAttachment.FileName oszlopok értékeit, miközben e-mail mellékletsorokat hoz létre és társít e-mailekhez vagy e-mail-sablonokhoz.

E-mail-tároló

Az e-mail-leírások (az e-mail törzse) eddig a pontig a Dataverse relációs tárolóban lettek tárolva. Ez úgy változik, hogy az e-mail-tevékenység tábla Email.Description oszlopa át lesz helyezve strukturálatlan Azure Blob Storage-tárolóba. Az Azure Blob Storage mellékletek, széljegyzetek, fájlok és képek tárolására is használható.

Átmeneti időszak

A Dataverse-relációs tárolóból az Azure Blob Storage-ba történő adatmigrálás várhatóan 2023 májusában kezdődik. Ez az adatmigrálás háttérfolyamatként (feladatként) történik. A meglévő ügyfelek kezdeti adatáthelyezése várhatóan körülbelül 6–12 hétig tart, és az adatok méretétől függően még tovább tart. A kezdeti adatáthelyezés után a fennmaradó migrálás folyamatos folyamat. A tizenkét hónapnál régebbi e-mail-leírások automatikusan át lesznek helyezve az Azure Blob Storage-ba, és ez a tizenkét hónapos átmeneti időszak nem módosítható. Az újabb e-mailek nem lesznek áthelyezve, amíg el nem érik a 12 hónapos kort. Az e-mail-leírások áttelepítési folyamata rendszeresen fut, bérlőnként körülbelül 30–60 naponta.

Ez az adatmigrálás transzparens lesz Önnek, azzal a kivétellel, hogy a migrálási folyamat befejezése után csökkenni fog az ActivityPointer-tábla mérete. A Kapacitás jelentésben, a Power Platform adminisztrációs központban egy új e-mail sorelem lesz elérhető a Fájlhasználat alatt. A végeredmény a fájltárolás teljes felhasználásának növekedése és a felhasznált adatbázis-tárterület csökkentése.

Megjegyzés:

A fájltárolás növekedése kisebb lehet, mint ami a fájladatok tömörítése miatt el lesz távolítva az ActivityPointer táblából.

A következő szakaszban említett korlátozások minden olyan adatra érvényesek lesznek, amelyek már átkerültek a Dataverse által felügyelt Azure Blob Storage-ba, még akkor is, ha az összes adatáthelyezés nem fejeződött be.

Keresési és szűrési korlátozások

Az Azure Blob Storage-ban tárolt e-mail-leírások (törzsek) esetében bizonyos korlátozások vonatkoznak az e-mail-leírások szűrésére, keresésére és keresésére az alábbiak szerint.

Filtering

Az e-mail-leírások szűrése nem támogatott. Néhány megfontolandó szempont a következő.

• FetchXML – A FetchXML használatával nem fog tudni e-mail-szervekben keresni.
• Gyorskeresés és speciális keresés – Az e-mail-leírások szűrése ezekkel a módszerekkel nem támogatott.

Jótanács

Gyorskeresés esetén, bár a szűrés nem támogatott, az e-mail törzse hozzáadható visszaadott oszlopként, és a rendszer visszaadja a törzsadatokat az eredményben.

Keresés

Engedélyezheti a Dataverse-keresést az e-mail-leírásokban az e-mail-leírások kereséséhez.

Lásd még

Tevékenységtáblák
Minta: E-mail küldése
E-mail táblázat
ActivityMimeAttachment tábla