Tabeller för e-postaktivitet

Tabellen med e-postaktivitet hjälper dig att spåra och hantera e-postkommunikation med kunder.

Åtgärder för en e-postaktivitet

Genom att använda Dataverse-webbtjänster kan du utföra följande åtgärder för en e-postaktivitet:

• Skapa, hämta, uppdatera och ta bort e-postaktiviteten.

• Skicka e-postmeddelanden eller skicka e-postmeddelanden med hjälp av e-postmallar (Template). Mer information om e-postmallar finns i Skapa e-postmallar.

• Bifoga filer som bifogade filer med hjälp av attributet (ActivityMimeAttachment) i e-postmeddelandet.

• Skicka massutskick via e-post.

• Konfigurera inkommande e-postmeddelanden som ska levereras från Microsoft Exchange Server till alla användare eller köer, eller utgående meddelanden som ska skickas från en användare eller kö till Microsoft Exchange Server.

  Organization.RequireApprovalForuserEmail Om organisationsattributen och Organization.RequireApprovalForQueueEmail (bearbeta e-postmeddelanden endast för godkända användare/köer) är inställda på true (1) inträffar följande: e-postmeddelanden levereras eller skickas från en användare eller kö endast om användarens eller köns primära e-postadress godkänns. Attributen SystemUser.EmailRouterAccessApproval och Queue.EmailRouterAccessApproval anger status för den primära e-postadressen för användaren respektive kön, och värdet måste vara satt till 1. Annars blockeras inkommande och utgående meddelanden. Du kan uppdatera användaren eller köposten för att ändra attributvärdet, om det inte redan är i godkänt tillstånd, förutsatt att ditt användarkonto har tilldelats behörigheten prvApproveRejectEmailAddress.

Massutskick

Dataverse har stöd för att skicka e-post till en stor lista med mottagare via en massbegäran via e-post. När du skickar en massbegäran via e-post till Dataverse skapas en asynkron åtgärd i den asynkrona tjänstkön som skickar e-postmeddelandena med hjälp av en bakgrundsprocess. Den här processen förbättrar systemets prestanda.

Använd meddelandena SendBulkMailRequest och BackgroundSendEmailRequest för att skicka massutskick av e-postmeddelanden. I följande lista beskrivs den sekvens som används för att skicka massutskick:

1. Kör SendBulkMail begäran. Den här begäran innehåller en fråga som väljer mottagare av e-post och en e-postmall för att skriva varje e-postmeddelande.

2. Den asynkrona tjänsten skapar e-postaktiviteterna för varje mottagare.

3. Den asynkrona tjänsten skickar varje e-postmeddelande. E-postmeddelandena har skickstatusen "väntande".

4. E-postroutern, Dynamics 365 för Outlook eller en komponent från tredje part för att skicka e-post söker regelbundet i Dataverse efter väntande e-postmeddelanden. Om den hittar en hämtar den meddelandet med hjälp av begäran BackgroundSendEmail.

5. Begäran BackgroundSendEmail utför följande åtgärder: kontrollerar om det finns väntande e-postmeddelanden, laddar ned e-postmeddelandet till den som ringer meddelandet BackgroundSendEmailRequest och synkroniserar nedladdningarna om det finns flera anropare.

   Anmärkning

   Din e-posttjänstleverantör kan ha gränser som påverkar hur många e-postmeddelanden du kan skicka inom en tidsperiod. Mer information finns i Begränsningar i Exchange Online > Begränsningar för att skicka.

6. Anroparen av meddelandet BackgroundSendEmailRequest tar emot det nedladdade e-postmeddelandet och skickar det vidare.

E-postbilagor

E-postbilagor är filer som du kan bifoga till e-postmeddelanden eller e-postmallar. En bifogad fil kan vara i valfritt standardformat för datorfiler, till exempel Office Outlook-dokument, Office Excel-kalkylblad, CAD-filer och PDF-filer. Du kan bifoga flera filer som e-postbilagor till ett e-postmeddelande eller en e-postmall. Egenskapen Organization.MaxUploadFileSize avgör den maximala storleken på filer som du kan ladda upp. Ange den här egenskapen på fliken E-post i systeminställningarna i Dynamics 365-programmet. Den här inställningen begränsar storleken på filer som du kan koppla till e-postmeddelanden, anteckningar och webbresurser. Standardinställningen är 5 MB.

Om du vill bifoga en e-postbilaga i ett e-postmeddelande eller en mall använder du kolumnerna ActivityMimeAttachment.ObjectId och ActivityMimeAttachment.ObjectTypeCode när du skapar eller uppdaterar en rad för MIME-bilaga för aktivitet.

Följande kodexempel visar hur du bifogar en e-postbilaga i ett e-postmeddelande:

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

Om du vill bifoga den bifogade e-postbilagan till en mall i stället för ett e-postmeddelande ersätter du värdena för attributen ActivityMimeAttachment.ObjectId och ActivityMimeAttachment.ObjectTypeCode enligt följande i föregående kod:

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

Ett fullständigt kodexempel om hur du skapar e-postbilagor finns i Exempel: Skapa, hämta, uppdatera och ta bort en e-postbilaga.

Återanvända e-postbilagor

När du skapar en post för e-postbilaga sparar Dataverse den bifogade filen som en BLOB-fil. Attributet ActivityMimeAttachment.AttachmentId för posten för e-postbilagor identifierar unikt filen BLOB. Den här processen underlättar återanvändning av filbilagor med andra e-post- och e-postmallposter, utan att skapa och lagra flera kopior av samma fil i databasen.

Så här återanvänder du en befintlig bifogad fil:

1. Hämta raden ActivityMimeAttachment som innehåller den bifogade fil som du vill återanvända, som du ser i följande kodexempel:

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

2. Skapa en ny e-postbilaga, associera den med den obligatoriska e-post- eller e-postmallsraden och peka den på den bifogade filen på den hämtade ActivityMimeAttachment raden, enligt följande kodexempel:

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

Eftersom du återanvänder en befintlig bifogad fil behöver du inte ange ActivityMimeAttachment.Body kolumnvärdena och ActivityMimeAttachment.FileName när du skapar och kopplar rader för e-postbilagor till e-postmeddelanden eller e-postmallar.

E-postlagring

E-postbeskrivningar (brödtexten i e-postmeddelandet) har fram till nu lagrats i relationsarkivet Dataverse. Det ändras när kolumnen Email.Description i tabellen för e-postaktivitet flyttas till ostrukturerad Azure Blob Storage. Azure Blob Storage används också för lagring av bifogade filer, anteckningar, filer och bilder.

Övergångsperiod

Datamigreringen från Dataverse-relationsarkivet till Azure Blob Storage för alla kunder förväntas starta i maj 2023. Den här datamigreringen sker som en bakgrundsprocess (jobb). Den första dataflytten för befintliga kunder förväntas pågå i cirka 6 till 12 veckor, och eventuellt ännu längre beroende på datastorleken. Efter den första dataflytten är all återstående migrering en kontinuerlig process. Alla e-postbeskrivningar som är äldre än tolv månader flyttas automatiskt till Azure Blob Storage och den här övergångsperioden på tolv månader kan inte ändras. Nyare e-postmeddelanden kommer inte att flyttas förrän de blir 12 månader gamla. E-postbeskrivningens migreringsjobb körs regelbundet – ungefär en gång var 30–60:e dag per hyresgäst.

Den här datamigreringen är transparent för dig med undantaget att du ser en minskning av storleken på ActivityPointer-tabellen när migreringsprocessen är helt slutförd. I Power Platform-administratörscenter i rapporten Capacity kommer en ny e-postredovisningsrad att vara tillgänglig i Filanvändning. Slutresultatet är en ökning av den totala konsumtionen av fillagring och en minskning av den konsumerade databaslagringen.

De begränsningar som nämns i nästa avsnitt börjar tillämpas på alla data som redan har flyttats till Den Dataverse-hanterade Azure Blob Storage även om all dataflytt inte är klar.

Sök- och filtreringsbegränsningar

För e-postbeskrivningar (organ) som lagras i Azure Blob Storage gäller vissa begränsningar för filtrering, sökning och sökning av e-postbeskrivningar enligt beskrivningen i följande avsnitt.

Filtering

Filtrering av e-postbeskrivningar stöds inte. Några specifika saker att tänka på är:

• FetchXML – Du kan inte söka i e-postkroppar med hjälp av FetchXML.
• Snabbsökning och avancerad sökning – Du kan inte filtrera e-postbeskrivningar med hjälp av dessa metoder.

Sökning

Du kan aktivera Dataverse-sökning i e-postbeskrivningar för att söka efter e-postbeskrivningar.

Se även

Aktivitetstabeller
Exempel: Skicka ett e-postmeddelande
E-posttabell
ActivityMimeAttachment-tabellen