Del via


E-postaktivitetstabeller

E-postaktiviteten lar deg spore og administrere e-postkommunikasjon med kunder.

Handlinger på en e-postaktivitet

Ved hjelp av dataverse nettjenester kan du utføre følgende handlinger på en e-postaktivitet:

  • Opprett, hent, oppdater og slett e-postaktiviteten.

  • Send e-postmeldinger eller send e-postmeldinger ved hjelp av e-postmaler (Template). Hvis du vil ha mer informasjon om e-postmaler, kan du se Opprette e-postmaler.

  • Legg ved filer som vedlegg ved hjelp av attributtet (ActivityMimeAttachment) i e-postmeldingen.

  • Foreta masseutsendelse av e-post.

  • Konfigurer innkommende e-postmeldinger som skal leveres fra Microsoft Exchange Server til en bruker eller kø, eller utgående meldinger som skal sendes fra en bruker eller kø til Microsoft Exchange Server.

    Hvis organisasjonsattributtene Organization.RequireApprovalForuserEmail og Organization.RequireApprovalForQueueEmail (behandle e-postmeldinger bare for godkjente brukere/køer) er satt til sann (1), skjer følgende: E-postmeldinger leveres eller sendes fra en bruker eller kø bare hvis den primære e-postadressen til brukeren eller køen er godkjent. Attributtene SystemUser.EmailRouterAccessApprovalQueue.EmailRouterAccessApproval og angir statusen for den primære e-postadressen til henholdsvis brukeren og køen, og verdien må settes til 1. Ellers vil innkommende og utgående meldinger bli blokkert. Du kan oppdatere bruker- eller køposten for å endre attributtverdien hvis den ikke allerede er i godkjent tilstand, forutsatt at brukerkontoen har tilordnet prvApproveRejectEmailAddress-rettigheten .

Note

Attributtet Email.StatusCode kan ikke være null i Datavers.

Masseutsendelse av e-post

Datavers støtter sending av e-post til en stor liste over mottakere via en masse-e-postforespørsel. Når en forespørsel om masseutsendelse av e-post sendes til Dataverse, opprettes en asynkron operasjon i den asynkrone tjenestekøen som sender e-postmeldingene ved hjelp av en bakgrunnsprosess. Dette gir deg forbedret systemytelse.

Meldingene SendBulkMailRequest og BackgroundSendEmailRequest brukes til å sende masseutsendelse av e-postmeldinger. Følgende viser sekvensen som brukes til å sende masseutsendelse av e-post:

  1. Utfør forespørselen SendBulkMail . Denne forespørselen inneholder en spørring som velger mål-e-postmottakerne og en e-postmal for å skrive hver e-postmelding.

  2. Den asynkrone tjenesten oppretter e-postaktivitetene for hver mottaker.

  3. Den asynkrone tjenesten sender hver e-postmelding. E-postmeldingene har statusen «venter» på sending.

  4. E-postruteren, Dynamics 365 for Outlook, eller en tredjeparts e-postsende komponent avspør Dataverse for ventende e-postmeldinger, og hvis en blir funnet, laster den BackgroundSendEmail ned ved hjelp av forespørselen.

  5. Forespørselen BackgroundSendEmail utfører følgende operasjoner: sjekker om ventende e-postmeldinger finnes, laster ned e-posten til den som ringer meldingen BackgroundSendEmailRequest , og synkroniserer nedlastingene hvis det er flere innringere.

    Note

    E-posttjenesteleverandøren kan ha begrensninger som påvirker hvor mange e-postmeldinger du kan sende i løpet av en tidsperiode. Mer informasjon: Exchange Online begrenser > sending av grenser.

  6. Den som ringer meldingen BackgroundSendEmailRequest , mottar den nedlastede e-postmeldingen og sender den ut.

E-postvedlegg

E-postvedlegg er filer som kan legges ved e-postmeldinger eller e-postmaler. En vedlagt fil kan være i et hvilket som helst standard datamaskinfilformat, for eksempel Office Outlook-dokumenter, Office Excel-regneark, CAD-filer og PDF-filer. Du kan legge ved flere filer som e-postvedlegg i en e-post- eller e-postmal. Den maksimale størrelsen på filer som kan lastes opp, bestemmes av egenskapen Organization.MaxUploadFileSize . Denne egenskapen angis i kategorien E-post i Systeminnstillinger i Dynamics 365-programmet. Denne innstillingen begrenser størrelsen på filer som kan legges ved e-postmeldinger, notater og webressurser. Standardinnstillingen er 5 MB.

Hvis du vil legge ved et e-postvedlegg med en e-postmelding eller mal, bruker du kolonnene ActivityMimeAttachment.ObjectId og ActivityMimeAttachment.ObjectTypeCode mens du oppretter eller oppdaterer en aktivitet MIME-vedleggsrad.

Følgende kodeeksempel viser hvordan du legger ved et e-postvedlegg i en e-postmelding:

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 vil legge ved e-postvedlegget til en mal i stedet for en e-postmelding, erstatter du verdiene ActivityMimeAttachment.ObjectId for og ActivityMimeAttachment.ObjectTypeCode attributtene som følger i koden ovenfor:

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

Hvis du vil ha fullstendig kodeeksempel om hvordan du oppretter e-postvedlegg, kan du se Eksempel: Opprette, hente, oppdatere og slette et e-postvedlegg.

Bruke e-postvedlegg på nytt

Når du oppretter en oppføring for e-postvedlegg, lagres den vedlagte filen som en fil-BLOB. Attributtet ActivityMimeAttachment.AttachmentId til oppføringen for e-postvedlegg identifiserer filen BLOB unikt. Dette gjøres for å lette gjenbruk av filvedleggene med andre e-post- og e-postmalposter, uten å opprette og lagre flere kopier av samme fil i databasen.

Slik bruker du et eksisterende filvedlegg på nytt:

  1. ActivityMimeAttachment Hent raden som inneholder vedleggsfilen du vil bruke på nytt, som vist i følgende kodeeksempel:

    ActivityMimeAttachment retrievedAttachment = 
        (ActivityMimeAttachment)_serviceProxy
        .Retrieve(ActivityMimeAttachment.EntityLogicalName, _emailAttachmentId, new ColumnSet(true));  
    
  2. Opprett et nytt e-postvedlegg, knytt det til den nødvendige e-post- eller e-postmalraden, og pek den til den vedlagte filen i den hentede ActivityMimeAttachment raden, 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};  
    

Fordi du bruker en eksisterende vedleggsfil på nytt, trenger du ikke å angi ActivityMimeAttachment.Body verdiene og ActivityMimeAttachment.FileName kolonnen mens du oppretter og knytter e-postvedleggsrader til e-postmeldinger eller e-postmaler.

Lagringsplass for e-post

E-postbeskrivelser (brødteksten i e-postmeldingen) har frem til dette punktet blitt lagret i det dataverse relasjonelle lageret. Dette endrer seg etter hvert som kolonnen Email.Description i aktivitetstabellen for e-post flyttes til ustrukturert Azure Blob-lagring. Azure Blob Storage brukes også til lagring av vedlegg, merknader, filer og bilder.

Overgangsperioden

Dataoverføringen fra dataverst relasjonslager til Azure Blob-lagring for alle kunder forventes å starte i mai 2023. Denne dataoverføringen vil finne sted som en bakgrunnsprosess (jobb). Den første dataflyttingen for eksisterende kunder forventes å vare i omtrent 6 til 12 uker, og muligens enda lenger, avhengig av størrelsen på dataene. Etter den første dataflyttingen er eventuell gjenværende overføring en kontinuerlig prosess. Alle e-postbeskrivelser som er eldre enn tolv måneder, flyttes automatisk til Azure Blob-lagring, og denne tolvmåneders overgangsperioden kan ikke endres. Nyere e-postmeldinger flyttes ikke før de blir 12 måneder gamle. Overføringsjobben for e-postbeskrivelsen kjøres regelmessig – omtrent én gang hver 30.-60. dag per leier.

Denne dataoverføringen vil være gjennomsiktig for deg med unntak av at du vil se en reduksjon i størrelsen på ActivityPointer-tabellen etter at overføringsprosessen er fullført. I administrasjonssenteret for Power Platform i kapasitetsrapporten vil et nytt e-postlinjeelement være tilgjengelig i filbruk. Sluttresultatet er en økning i det totale fillagringsforbruket og reduksjonen i databaselagringen som forbrukes.

Note

Økningen i fillagring kan muligens være mindre enn det som fjernes fra ActivityPointer-tabellen, fordi fildataene komprimeres.

Begrensningene som er nevnt i neste del, vil begynne å gjelde for alle data som allerede er flyttet til den dataverseadministrerte Azure blob-lagringen, selv om all databevegelsen ikke er fullført.

Begrensninger for søk og filtrering

For e-postbeskrivelser (organer) som er lagret i Azure Blob-lagring, gjelder visse begrensninger for filtrering, søk og søk i e-postbeskrivelser som beskrevet nedenfor.

Filtrering

Filtrering av e-postbeskrivelser støttes ikke. Noen spesifikke punkter å vurdere er som følger.

  • FetchXML – Du kan ikke søke i e-postorganer ved hjelp av FetchXML.
  • Hurtigsøk og avansert søk – Filtrering av e-postbeskrivelser ved hjelp av disse metodene støttes ikke.

Tips

Når det gjelder hurtigsøk, mens filtrering ikke støttes, kan e-postteksten legges til som en returnert kolonne, og brødtekstdataene returneres i resultatet.

Søker

Du kan aktivere datavers søk på e-postbeskrivelser for å søke i e-postbeskrivelser.

Se også

Aktivitetstabeller
Eksempel: Sende en e-postmelding
E-posttabell
Tabellen ActivityMimeAttachment