E-mailactiviteitstabellen

De tabel met e-mailactiviteiten helpt u bij het bijhouden en beheren van e-mailcommunicatie met klanten.

Acties voor een e-mailactiviteit

Met behulp van Dataverse-webservices kunt u de volgende acties uitvoeren voor een e-mailactiviteit:

U kunt de e-mailactiviteit maken, ophalen, bijwerken en verwijderen.
Verzend e-mailberichten of verzend e-mailberichten met behulp van e-mailsjablonen (Template). Zie E-mailsjablonen maken voor meer informatie over e-mailsjablonen.
Voeg bestanden toe als bijlagen met behulp van het kenmerk (ActivityMimeAttachment) in het e-mailbericht.
U kunt e-mailberichten massaal of bulksgewijs verzenden.
Configureer inkomende e-mailberichten die vanuit Microsoft Exchange Server worden bezorgd bij een gebruiker of wachtrij, of uitgaande berichten die moeten worden verzonden van een gebruiker of wachtrij naar Microsoft Exchange Server.

Als de Organization.RequireApprovalForuserEmail organisatiekenmerken en Organization.RequireApprovalForQueueEmail (alleen e-mails verwerken voor goedgekeurde gebruikers/wachtrijen) zijn ingesteld op true (1), gebeurt het volgende: e-mailberichten worden alleen bezorgd of verzonden vanaf een gebruiker of wachtrij als het primaire e-mailadres van de gebruiker of wachtrij is goedgekeurd. De SystemUser.EmailRouterAccessApproval en de attributen geven de status van respectievelijk het primaire e-mailadres van de gebruiker en de Queue.EmailRouterAccessApproval wachtrij aan, en de waarde moet worden ingesteld op 1. Anders worden de binnenkomende en uitgaande berichten geblokkeerd. U kunt de gebruikers- of wachtrijrecord bijwerken om de kenmerkwaarde te wijzigen, als deze nog niet de goedgekeurde status heeft, mits aan uw gebruikersaccount de bevoegdheid prvApproveRejectEmailAddress is toegewezen.

Opmerking

In Dataverse kan het Email.StatusCode kenmerk niet null zijn.

Bulk-e-mail

Dataverse ondersteunt het verzenden van e-mail naar een grote lijst met geadresseerden via een bulk-e-mailaanvraag. Wanneer u een bulk-e-mailaanvraag naar Dataverse verzendt, wordt er een asynchrone bewerking gemaakt in de asynchrone servicewachtrij waarmee de e-mailberichten worden verzonden met behulp van een achtergrondproces. Dit proces verbetert de systeemprestaties.

Gebruik de SendBulkMailRequest berichten en BackgroundSendEmailRequest berichten om bulksgewijs e-mailberichten te verzenden. In de volgende lijst wordt de volgorde beschreven die wordt gebruikt voor het verzenden van bulk-e-mail:

Voer de SendBulkMail aanvraag uit. Deze aanvraag bevat een query waarmee de doel-e-mailontvangers worden geselecteerd en een e-mailsjabloon voor het opstellen van elke e-mail.
Een asynchrone service maakt de e-mailactiviteiten voor elke ontvanger.
De asynchrone service verzendt elk e-mailbericht. De e-mailberichten hebben de status 'in afwachting'.
De e-mailrouter, Dynamics 365 for Outlook of een e-mailverzendonderdeel van derden controleert Dataverse regelmatig op e-mailberichten die nog moeten worden verwerkt. Als er een wordt gevonden, wordt het bericht gedownload met behulp van de BackgroundSendEmail aanvraag.
De BackgroundSendEmail aanvraag voert de volgende bewerkingen uit: controleert of er e-mailberichten in behandeling zijn, downloadt de e-mail naar de beller van het BackgroundSendEmailRequest bericht en synchroniseert de downloads als er meerdere bellers zijn.

Opmerking

Uw e-mailserviceprovider heeft mogelijk limieten die van invloed zijn op het aantal e-mailberichten dat u binnen een bepaalde periode kunt verzenden. Zie Exchange Online-limieten > Verzendlimieten voor meer informatie.
De beller van het BackgroundSendEmailRequest bericht ontvangt het gedownloade e-mailbericht en verzendt het.

E-mailbijlagen

E-mailbijlagen zijn bestanden die u kunt toevoegen aan e-mailberichten of e-mailsjablonen. Een bijgevoegd bestand kan elke standaardcomputerbestandsindeling hebben, zoals Office Outlook documenten, Office Excel spreadsheets, CAD-bestanden en PDF-bestanden. U kunt meerdere bestanden als e-mailbijlagen aan een e-mail of e-mailsjabloon toevoegen. De eigenschap Organization.MaxUploadFileSize bepaalt de maximale grootte van bestanden die u kunt uploaden. Stel deze eigenschap in op het tabblad E-mail van de systeeminstellingen in de Dynamics 365 toepassing. Deze instelling beperkt de grootte van bestanden die u kunt toevoegen aan e-mailberichten, notities en webresources. De standaardinstelling is 5 MB.

Als u een e-mailbijlage aan een e-mailbericht of sjabloon wilt toevoegen, gebruikt u de kolommen ActivityMimeAttachment.ObjectId en ActivityMimeAttachment.ObjectTypeCode wanneer u een rij voor een MIME-bijlage van een activiteit maakt of bijwerkt.

In het volgende codevoorbeeld ziet u hoe u een e-mailbijlage aan een e-mailbericht toevoegt:

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

Als u de e-mailbijlage wilt toevoegen aan een sjabloon in plaats van een e-mailbericht, vervangt u de waarden van de ActivityMimeAttachment.ObjectId en ActivityMimeAttachment.ObjectTypeCode kenmerken als volgt in de voorgaande code:

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

Zie Voorbeeld: Een e-mailbijlage maken, ophalen, bijwerken en verwijderen voor een volledig codevoorbeeld over het maken van e-mailbijlagen.

E-mailbijlagen opnieuw gebruiken

Wanneer u een e-mailbijlagerecord maakt, slaat Dataverse het bijgevoegde bestand op als een bestands-BLOB. Het ActivityMimeAttachment.AttachmentId kenmerk van de e-mailbijlagerecord identificeert uniek de bestand-BLOB. Dit proces vereenvoudigt het hergebruik van bestandsbijlagen met andere e-mail- en e-mailsjabloonrecords, zonder meerdere kopieën van hetzelfde bestand in de database te maken en op te slaan.

Een bestaande bestandsbijlage opnieuw gebruiken:

Haal de ActivityMimeAttachment rij op die het bijlagebestand bevat dat u opnieuw wilt gebruiken, zoals wordt weergegeven in het volgende codevoorbeeld:

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

Maak een nieuwe e-mailbijlage, koppel deze aan de vereiste rij met e-mail- of e-mailsjablonen en wijs deze aan het bijgevoegde bestand van de opgehaalde ActivityMimeAttachment rij, zoals wordt weergegeven in het volgende codevoorbeeld:

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

Omdat u een bestaand bijlagebestand opnieuw gebruikt, hoeft u niet de ActivityMimeAttachment.Body waarden en ActivityMimeAttachment.FileName kolomwaarden op te geven terwijl u rijen voor e-mailbijlagen maakt en aan e-mailsjablonen wilt koppelen.

E-mailopslag

E-mailbeschrijvingen (hoofdtekst van het e-mailbericht) zijn tot nu toe opgeslagen in het relationele Dataverse-archief. Dit verandert omdat de kolom Email.Description in de tabel met e-mailactiviteiten wordt verplaatst naar ongestructureerde Azure Blob-opslag. Azure Blob Storage wordt ook gebruikt voor het opslaan van bijlagen, aantekeningen, bestanden en afbeeldingen.

Overgangsperiode

De gegevensmigratie van dataverse-relationele opslag naar Azure Blob Storage voor alle klanten wordt naar verwachting in mei 2023 gestart. Deze gegevensmigratie vindt plaats als achtergrondproces (taak). De initiële gegevensverplaatsing voor bestaande klanten duurt naar verwachting ongeveer 6 tot 12 weken en mogelijk nog langer, afhankelijk van de grootte van de gegevens. Na de eerste gegevensverplaatsing is elke resterende migratie een doorlopend proces. Alle e-mailbeschrijvingen ouder dan twaalf maanden worden automatisch verplaatst naar Azure Blob Storage en deze overgangsperiode van twaalf maanden kan niet worden gewijzigd. Nieuwere e-mailberichten worden pas verplaatst als ze 12 maanden oud zijn. De e-mailmigratietaak wordt periodiek uitgevoerd, ongeveer eens in de 30 tot 60 dagen per huurder.

Deze gegevensmigratie is transparant voor u, met uitzondering dat u een vermindering ziet van de grootte van de ActivityPointer-tabel nadat het migratieproces volledig is voltooid. In het Power Platform-beheercentrum in het capaciteitsrapport is een nieuw e-mailregelitem beschikbaar in bestandgebruik. Het eindresultaat is een toename van het totale verbruik van bestandsopslag en vermindering van de verbruikte databaseopslag.

Opmerking

De toename van bestandsopslag is mogelijk kleiner dan wat uit de ActivityPointer-tabel wordt verwijderd vanwege compressie van bestandsgegevens.

De beperkingen die in de volgende sectie worden genoemd, worden toegepast op alle gegevens die al zijn verplaatst naar de door Dataverse beheerde Azure-blobopslag, zelfs als alle gegevensverplaatsing niet is voltooid.

Beperkingen voor zoeken en filteren

Voor e-mailbeschrijvingen (lichamen) die zijn opgeslagen in Azure Blob Storage, gelden bepaalde beperkingen voor het filteren, zoeken en doorzoeken van e-mailbeschrijvingen, zoals beschreven in de volgende secties.

Filtering

Filteren op e-mailbeschrijvingen wordt niet ondersteund. Enkele specifieke aandachtspunten zijn:

FetchXML: u kunt niet zoeken in e-mailteksten met Behulp van FetchXML.
Snel zoeken en geavanceerd zoeken: u kunt e-mailbeschrijvingen niet filteren met behulp van deze methoden.

Aanbeveling

Voor Snel zoeken kunt u, terwijl filteren niet wordt ondersteund, de hoofdtekst van de e-mail toevoegen als een geretourneerde kolom en de hoofdtekstgegevens in het resultaat retourneren.

Zoeken

U kunt Dataverse-zoekopdrachten inschakelen voor e-mailbeschrijvingen om e-mailbeschrijvingen te doorzoeken.

Zie ook

Activiteitentabellen
Voorbeeld: Een e-mailbericht verzenden
E-mailtabel
Tabel voor ActivityMimeAttachment

Feedback

Is deze pagina nuttig?

Last updated on 2026-08-21