Activiteitsentiteiten voor e-mail
Gepubliceerd: januari 2017
Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Met de e-mailactiviteit kunt u e-mailcommunicaties met klanten bijhouden en beheren.Microsoft Dynamics 365 bevat de E-mail Router-software waarmee de routering van e-mail naar en van Microsoft Dynamics 365 wordt beheerd. De e-mailactiviteit wordt geleverd met e-mailprotocollen.E-mail Router ondersteunt de volgende e-mailprotocollen: Exchange Web services, POP3 en SMTP. Behalve via de E-mail Router-software, kan de e-mailactiviteit ook worden geleverd door gebruik te maken van Microsoft Dynamics 365 voor Outlook.
In dit onderwerp
Acties bij een e-mailactiviteit
Bulk-e-mail
E-mailbijlagen
Acties bij een e-mailactiviteit
Met Microsoft Dynamics 365 SDK kunt u de volgende activiteiten uitvoeren op een e-mailactiviteit:
De e-mailactiviteit maken, ophalen, bijwerken en verwijderen.
E-mailberichten verzenden of e-mailberichten verzenden via e-mailsjablonen (Template). Raadpleeg Berichten en methoden van de entiteit Sjabloon (e-mailsjabloon) voor meer informatie over e-mailsjablonen.
Bestanden toevoegen als bijlagen door gebruik te maken van het kenmerk (ActivityMimeAttachment) in het e-mailbericht.
Massa- of bulkberichten verzenden per e-mail.
Binnenkomende e-mailberichten configureren voor levering vanuit Microsoft Exchange Server aan een gebruiker of wachtrij of uitgaande e-mailberichten configureren voor verzending van een gebruiker of wachtrij naar Microsoft Exchange Server. Voor meer informatie over de configuratie van binnenkomende e-mailberichten voor wachtrijen, raadpleegt u E-mail configureren voor inkomende berichten.
Als de organisatiekenmerken Organization.RequireApprovalForuserEmail en Organization.RequireApprovalForQueueEmail (alleen e-mails verwerken voor goedgekeurde gebruikers/wachtrijen) zijn ingesteld op true (1), gebeurt het volgende: e-mailberichten worden alleen bezorgd bij of verzonden van een gebruiker of wachtrij als het primaire e-mailadres van de gebruiker of de wachtrij is goedgekeurd. De kenmerken SystemUser.EmailRouterAccessApproval en Queue.EmailRouterAccessApproval geven de status aan van het primaire e-mailadres van respectievelijk de gebruiker en de wachtrij, 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, op voorwaarde dat aan uw gebruikersaccount de bevoegdheid prvApproveRejectEmailAddress is toegewezen. Zie UI Beveiligingsrol om bevoegdheden voor koppelen toe te wijzen voor meer informatie.
Notitie
In Microsoft Dynamics 365 (online en on-premises) kan het kenmerk Email.StatusCode niet null zijn.
Bulk-e-mail
Microsoft Dynamics 365 ondersteunt het verzenden van u e-mail naar een grote lijst met ontvangers via een aanvraag voor bulk-e-mail. Wanneer een bulk-e-mailaanvraag naar Microsoft Dynamics 365 worden verzonden, wordt een asynchrone bewerking gemaakt in de wachtrij voor de asynchrone service die de e-mailberichten verzendt via een achtergrondproces. Dit zorgt voor verbeterde systeemprestaties.
De berichten SendBulkMailRequest en BackgroundSendEmailRequest worden gebruikt voor het verzenden van bulk-e-mailberichten. Hieronder wordt de volgorde aangegeven die wordt gebruikt voor het verzenden van bulk-e-mail:
Voer de aanvraag SendBulkMail uit. Deze aanvraag bevat een query die de beoogde ontvangers van de e-mail en een e-mailsjabloon voor het opstellen van elke e-mail selecteert.
De asynchrone service maakt de e-mailactiviteiten voor elke geadresseerde.
De asynchrone service verzendt elk e-mailbericht. De e-mailberichten hebben een status "wacht op verzenden".
De e-mailrouter, Microsoft Dynamics 365 voor Outlook, of een externe component voor het verzenden van e-mail controleert op Microsoft Dynamics 365 of er wachtende e-mail-berichten zijn en downloadt vervolgens eventueel gevonden e-mailberichten via de aanvraag BackgroundSendEmail.
De aanvraag BackgroundSendEmail voert de volgende bewerkingen uit: controleert of er e-mailberichten in behandeling zijn, downloadt de e-mail naar de aanroeper van het bericht BackgroundSendEmailRequest en synchroniseert de downloads als er meerdere aanroepers zijn.
De aanroeper van het bericht BackgroundSendEmailRequest ontvangt het gedownloade e-mailbericht en verstuurt dit.
E-mailbijlagen
E-mailbijlagen zijn bestanden die kunnen worden toegevoegd aan e-mailberichten of e-mailsjablonen. Een toegevoegd bestand kan elke standaardcomputerbestandsindeling hebben, zoals Microsoft Office Word-documenten, Microsoft Office Excel-werkbladen, CAD-bestanden en PDF-bestanden. U kunt meerdere bestanden als bijlage toevoegen aan een e-mailbericht of een e-mailsjabloon.De maximale bestandsgrootte voor uploaden wordt bepaald door de eigenschap Organization.MaxUploadFileSize. Deze eigenschap wordt ingesteld op het tabblad E-mail van de Systeeminstellingen in de Dynamics 365-toepassing. Met deze instelling kunt u de bestandsgrootte beperken van bestanden die aan e-mailberichten, notities en webresources kunnen worden toegevoegd. De standaardinstelling is 5 MB.
Als u een e-mailbijlage wilt toevoegen aan een e-mailbericht of sjabloon, gebruikt u de kenmerken ActivityMimeAttachment.ObjectId en ActivityMimeAttachment.ObjectTypeCode terwijl u een record met een MIME-bijlage van een activiteit maakt of bijwerkt.
In de volgende voorbeeldcode 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"};
Op dezelfde manier kunt u de e-mailbijlage aan een sjabloon toevoegen in plaats van aan een e-mail door de waarden van de kenmerken ActivityMimeAttachment.ObjectId en ActivityMimeAttachment.ObjectTypeCode als volgt in de bovenstaande code te vervangen:
ObjectId = new EntityReference(Template.EntityLogicalName, _templateId), ObjectTypeCode = Template.EntityLogicalName,
Voor een volledig voorbeeldcode over het maken van e-mailbijlagen, raadpleegt u Voorbeeld: Een e-mailbijlage maken, ophalen, bijwerken, en verwijderen.
E-mailbijlagen opnieuw gebruiken
Wanneer u een record van een e-mailbijlage maakt, wordt het bijgevoegde bestand opgeslagen als bestands-BLOB. De bestands-BLOB wordt eenduidig geïdentificeerd via het kenmerk ActivityMimeAttachment.AttachmentId van de record van de e-mailbijlage. Dit wordt gedaan om het hergebruik van de bestandsbijlagen in andere e-mail- en e-mailsjabloonrecords te vergemakkelijken, zonder dat meerdere exemplaren van hetzelfde bestand hoeven te worden gemaakt en in de database opgeslagen.
U kunt als volgt een bestaande bestandsbijlage hergebruiken:
Haal de record ActivityMimeAttachment op die het bijgevoegde bestand bevat dat u opnieuw wilt gebruiken, zoals in het volgende codevoorbeeld wordt weergegeven:
ActivityMimeAttachment retrievedAttachment = (ActivityMimeAttachment)_serviceProxy.Retrieve(ActivityMimeAttachment.EntityLogicalName, _emailAttachmentId, new ColumnSet(true));Maak een nieuwe record voor een e-mailbijdrage, koppel deze aan de vereiste e-mail- of e-mailsjabloonrecord en verwijs deze naar het bijgevoegde bestand van de opgehaalde record ActivityMimeAttachment, zoals 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 de kenmerkwaarden ActivityMimeAttachment.Body en ActivityMimeAttachment.FileName niet op te geven bij het maken en koppelen van records voor e-mailbijlagen bij e-mailberichten en e-mailsjablonen.
Zie ook
Activiteitsentiteiten
Voorbeeldcode voor activity entities
Berichten en methoden van de entiteit Email
Berichten en methoden van entiteit ActivityMimeAttachment (e-mailbijlage)
Microsoft Dynamics 365
© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht