Del via

Objekter for mailaktivitet

  • Artikel

 

Udgivet: januar 2017

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Med e-mailaktiviteten kan du spore og administrere e-mailkommunikation med kunder.Microsoft Dynamics 365 omfatter E-mail-router-softwaren, der håndterer routing af e-mail til eller fra Microsoft Dynamics 365. E-mailaktiviteten leveres ved hjælp af mailprotokoller.E-mail-router understøtter følgende e-mailprotokoller: Exchange-webtjenester, POP3 og SMTP. Ud over E-mail-router-softwaren kan mailaktivitet også sendes vha. Microsoft Dynamics 365 til Outlook.

Dette emne indeholder

Handlinger på en mailaktivitet

Masseforsendelse af mails

Vedhæftede filer i mail

Handlinger på en mailaktivitet

Ved at bruge Microsoft Dynamics 365-SDK kan du udføre følgende handlinger på en mailaktivitet:

  • Oprette, hente, opdatere og slette mailaktiviteten.

  • Sende mails eller sende mails vha. af mailskabeloner (Template). Du kan finde flere oplysninger om mailskabeloner under Objektmeddelelser og -metoder til skabelon (mailskabelon).

  • Vedhæfte filer som vedhæftede filer vha. attributten (ActivityMimeAttachment) i mailen.

  • Sende masseforsendelse af mails.

  • Konfigurere, at indgående mails skal leveres fra Microsoft Exchange Server til en bruger eller kø, eller at udgående meddelelser skal sendes fra en bruger eller kø til Microsoft Exchange Server. Du kan finde flere oplysninger om, hvordan du konfigurerer indgående mails til køer, i Konfigurer mail til indgående meddelelser.

    Hvis du angiver organisationsattributterne Organization.RequireApprovalForuserEmail og Organization.RequireApprovalForQueueEmail (kun procesmails til godkendte brugere/køer) til sand (1), sker følgende: mails leveres eller sendes kun fra en bruger eller kø, hvis brugerens eller køens primære mailadresse er godkendt. Attributterne SystemUser.EmailRouterAccessApproval og Queue.EmailRouterAccessApproval angiver status for hhv. brugerens og køens primære mailadresse, og værdien skal være angivet til 1. Ellers blokeres indgående og udgående meddelelser. Du kan opdatere bruger- eller køposten for at ændre attributværdien, hvis den ikke allerede er godkendt, forudsat at din brugerkonto har fået tildelt rettigheden prvApproveRejectEmailAddress. Du kan finde flere oplysninger under Sikkerhedsrollens brugergrænseflade for tilknytning af rettigheder.

Bemærk

I Microsoft Dynamics 365 (online og i det lokale miljø) kan attributten Email.StatusCode ikke være nul.

Masseforsendelse af mails

Microsoft Dynamics 365 understøtter afsendelse af mails til en stor liste over modtagere via en anmodning om masseforsendelse af mails. Når en anmodning om masseforsendelse af mails sendes til Microsoft Dynamics 365, oprettes der en asynkron handling i den asynkrone tjenestekø, som sender mails vha. en baggrundsproces. Derved får du forbedret systemets ydeevne.

Meddelelserne SendBulkMailRequest og BackgroundSendEmailRequest bruges til at sende en masseforsendelse af mails. Følgende liste viser den rækkefølge, der bruges til at sende en masseforsendelse af mails:

  1. Udfør anmodningen SendBulkMail. Denne anmodning indeholder en forespørgsel, der vælger mailens modtagere, samt en mailskabelon til at oprette hver mail.

  2. Den asynkrone tjeneste opretter mailaktiviteter for hver modtager.

  3. Den asynkrone tjeneste sender hver mail. Mailen har sendestatus "afventer".

  4. Mail-routeren, Microsoft Dynamics 365 til Outlook eller en tredjeparts mailafsendelseskomponent kontrollerer Microsoft Dynamics 365 for ventende mails, og hvis der findes en, downloader du den vha. anmodningen BackgroundSendEmail.

  5. Anmodningen BackgroundSendEmail udfører følgende handlinger: kontrollerer, om der findes ventende mails, downloader mailen til opkalderen af meddelelsen BackgroundSendEmailRequest og synkroniserer downloads, hvis der er flere opkaldere.

  6. Opkalderen af meddelelsen BackgroundSendEmailRequest modtager den downloadede mail og sender den.

Vedhæftede filer i mail

Vedhæftede filer er filer, der kan knyttes til mails eller mailskabeloner. En vedhæftet fil kan være i ethvert standardfilformat som f.eks. Microsoft Office Word-dokumenter, Microsoft Office Excel-regneark, CAD-filer og PDF-filer. Du kan vedhæfte flere filer til mails eller mailskabeloner.Maksimumstørrelsen på de filer, du kan overføre, bestemmes af egenskaben Organization.MaxUploadFileSize. Denne egenskab angives under fanen Mail under Systemindstillinger i Dynamics 365-programmet. Denne indstilling begrænser størrelsen på filer, der kan vedhæftes mailmeddelelser, noter og webressourcer. Standardindstillingen er 5 MB.

Hvis du vil vedhæfte en fil til en mail eller en skabelon, skal du bruge attributterne ActivityMimeAttachment.ObjectId og ActivityMimeAttachment.ObjectTypeCode, mens du opretter eller opdaterer en vedhæftet MIME-aktivitetspost.

Følgende kodeeksempel viser, hvordan du vedhæfter en fil til en mail:

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

Hvis du tilsvarende vil vedhæfte en fil til en skabelon i stedet for en mail, skal du erstatte værdierne af attributterne ActivityMimeAttachment.ObjectId og ActivityMimeAttachment.ObjectTypeCode, som følger i ovenstående kode:

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

Du kan få vist et komplet kodeeksempel om, hvordan du opretter vedhæftede filer, i Eksempel: Oprette, hente, opdatere og slette en vedhæftet fil i en e-mail.

Genbrug af vedhæftede filer i mails

Når du opretter en mailvedhæftet post, gemmes den vedhæftede fil som en BLOB-fil. Attributten ActivityMimeAttachment.AttachmentId for den mailvedhæftede post identificerer BLOB-filen. Det gøres for at lette genbrug af vedhæftede filer med andre mails og mailskabelonposter uden at oprette og lagre flere kopier af den samme fil i databasen.

Sådan genbruger du en eksisterende vedhæftet fil:

  1. Hent den ActivityMimeAttachment-post, der indeholder den vedhæftede fil, du vil genbruge, som vist i følgende kodeeksempel:

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

  2. Opret en ny mailvedhæftet post, tilknyt den nødvendige mail eller mailskabelonpost, og lad den pege på den vedhæftede fil for den indlæste ActivityMimeAttachment-post, som vist i følgende kodeeksempel:

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

    Da du genbruger en eksisterende vedhæftet fil, behøver du ikke angive attributværdierne ActivityMimeAttachment.Body og ActivityMimeAttachment.FileName, mens du opretter og tilknytter mailvedhæftede poster til mails eller mailskabeloner.

Se også

Aktivitetsobjekter
Eksempelkode til aktivitetsobjekter
Objektmeddelelser og metoder for e-mail
Meddelelser og metoder for objektet ActivityMimeAttachment (vedhæftet fil i e-mail)

Microsoft Dynamics 365

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret