Dynamics - Obligatoriska behörigheter

Alla Dataverse-behörigheter som eMarketeer-integrationen behöver, med den rekommenderade minst-privilegierade säkerhetsrollen och en fullständig genomgång per funktion.

Den här artikeln listar alla behörigheter som eMarketeer-integrationen behöver i din Microsoft Dynamics 365 / Dataverse-miljö: vilka tabeller den använder, vilken typ av åtkomst den behöver till varje tabell, och de exakta säkerhetsbehörigheterna bakom den åtkomsten. Den riktar sig till Dynamics-administratörer och säkerhetsgranskare som vill tilldela integrationen en minst-privilegierad säkerhetsroll i stället för rollen System Administrator.

Så ansluter integrationen

eMarketeer ansluter till din miljö via en applikationsanvändare och standard-API:et Dataverse Web API (api/data/v9.2). Autentisering sker via server-till-server OAuth (client credentials) mot Microsoft Entra ID, med scope till din Dataverse-miljös URL. Inga Microsoft Graph-behörigheter används eller begärs. Det enda scope integrationen begär är https://<yourenvironment>.crm.dynamics.com/.default.

Vid den första anslutningen gör integrationen ett anrop till Dynamics globala identifieringstjänst (globaldisco.crm.dynamics.com) med den anslutande administratörens inloggade token, för att hitta miljön som ska anslutas. Därefter används bara applikationsanvändaren.

Integrationen läser och skriver poster oavsett vem som äger dem, så behörigheterna måste tilldelas med Organization scope. Ett smalare scope (enbart egna poster eller en affärsenhet) döljer poster som ägs av andra användare och bryter synkar och exporter.

Vad integrationen inte gör

• Den tar aldrig bort dina kontakter, Leads, konton, aktiviteter eller marknadsföringslistor.
• Det enda fält den ändrar på dina kontakter utanför en explicit export är donotbulkemail (e-postsamtycke), som beskrivs i användningsfallet Samtyckessynk.
• Den skapar inga poster i din miljö utöver de som beskrivs i användningsfallen nedan.

Alla behörigheter i översikt

Tabellen nedan är den fullständiga uppsättningen: integrationens säkerhetsroll behöver dessa behörigheter och inga andra. Rader markerade med enbart anslut/koppla från används bara vid installation, uppgradering eller borttagning av integrationen, men de ligger ändå i samma roll så att ingen rollväxling behövs vid dessa händelser.

Tabell / komponent	Åtkomst som krävs	Behörigheter
Contact (contact)	Read, Create, Write, Append, Append To	prvReadContact, prvCreateContact, prvWriteContact, prvAppendContact, prvAppendToContact, prvAssignContact (för att sätta postägare)
Lead (lead)	Read, Create, Write, Append, Append To	prvReadLead, prvCreateLead, prvWriteLead, prvAppendLead, prvAppendToLead
Account (account)	Read, Create, Append To	prvReadAccount, prvCreateAccount, prvAppendToAccount
Marketing List (list)	Read, Write, Append To	prvReadList, prvWriteList, prvAppendToList
Aktiviteter (Task, Phone Call)	Create, Append	prvCreateActivity, prvAppendActivity
User (systemuser)	Read, Append To	prvReadUser, prvAppendToUser
Security Role (role)	Read	prvReadRole
Auditing (audit)	Läs granskningslogg	prvReadRecordAuditHistory, prvReadAuditSummary (motsvarar kryssrutorna "View Audit History" och "View Audit Summary" i gränssnittet)
eMarketeer Subscriptions (em_subscriptions, anpassad)	Read, Create, Write, Delete, Append, Append To	prvReadem_subscriptions, prvCreateem_subscriptions, prvWriteem_subscriptions, prvDeleteem_subscriptions, prvAppendem_subscriptions, prvAppendToem_subscriptions
eMarketeer Subscription Categories (em_subscriptioncategories, anpassad)	Read, Create, Write, Delete, Append To	prvReadem_subscriptioncategories, prvCreateem_subscriptioncategories, prvWriteem_subscriptioncategories, prvDeleteem_subscriptioncategories, prvAppendToem_subscriptioncategories
Act on Behalf of Another User	Execute	prvActOnBehalfOfAnotherUser (används bara för att stämpla aktiviteter med den valda Dynamics-användaren som skapare)
Publisher (publisher) — enbart anslut/koppla från	Read, Create	prvReadPublisher, prvCreatePublisher
Tabelldefinitioner (metadata) — enbart anslut/koppla från	Read, Create, Delete	prvReadEntity, prvCreateEntity, prvDeleteEntity, prvCreateAttribute
Alternativa nycklar (metadata) — enbart anslut/koppla från	Read, Create	prvReadEntityKey, prvCreateEntityKey
Tabellrelationer (metadata) — enbart anslut/koppla från	Read, Create	prvReadRelationship, prvCreateRelationship
Systemvyer (savedqueries) — enbart anslut/koppla från	Read, Create	prvReadCustomization, prvWriteCustomization (Dataverse har ingen dedikerad savedquery-behörighet)
Formulär (systemforms) — enbart anslut/koppla från	Read, Write	prvReadSystemForm, prvWriteSystemForm
Webbresurser (webresourceset) — enbart anslut/koppla från	Read, Create, Write, Delete	prvReadWebResource, prvCreateWebResource, prvWriteWebResource, prvDeleteWebResource
Webhook-endpoints (serviceendpoints) — enbart anslut/koppla från	Read, Create, Delete	prvReadServiceEndpoint, prvCreateServiceEndpoint, prvDeleteServiceEndpoint
Webhook-registreringssteg (sdkmessageprocessingsteps, sdkmessages) — enbart anslut/koppla från	Read, Create, Delete	prvReadSdkMessage, prvReadSdkMessageProcessingStep, prvCreateSdkMessageProcessingStep, prvDeleteSdkMessageProcessingStep
Publicera anpassningar — enbart anslut/koppla från	Execute	prvPublishCustomization

Ett krav utöver behörigheterna: granskning måste vara aktiverat på Contact-tabellen, annars kan samtyckessynken inte identifiera samtyckeändringar gjorda i Dynamics.

Rekommenderad säkerhetsroll

Ersätt tilldelningen av System Administrator med en anpassad roll — till exempel "eMarketeer Integration" — tilldelad till eMarketeers applikationsanvändare och innehållande exakt de behörigheter som listas ovan med Organization scope. Ingen inbyggd Dynamics-roll matchar denna behörighetsuppsättning utan att tilldela mycket mer än integrationen behöver, så att bygga rollen från tabellen är det renaste alternativet.

I säkerhetsrollseditorn hittar du behörigheterna här:

Plats i editorn	Behörigheter att ange
Fliken Core Records: Contact, Lead, Account, Marketing List, Activity	Read/Create/Write/Append/Append To/Assign-cellerna från tabellen ovan
Fliken Core Records, diverse behörigheter	View Audit History, View Audit Summary
Fliken Business Management: User, Security Role	Read på båda; Append To på User
Fliken Business Management, diverse behörigheter	Act on Behalf of Another User
Fliken Customization: Entity, Field, Entity Key, Relationship, System Form, Web Resource, Customizations	Metadata-, formulär-, vy- och webbresursposterna från tabellen ovan, plus Publish Customizations
Fliken Customization: Sdk Message, Sdk Message Processing Step, Service Endpoint; fliken Business Management: Publisher	Webhook- och publisher-posterna från tabellen ovan
Fliken Custom Entities: eMarketeer Subscriptions, eMarketeer Subscription Categories	De fullständiga uppsättningarna från tabellen ovan

Obs om ordning: de två eMarketeer-anpassade tabellerna (em_subscriptions, em_subscriptioncategories) existerar bara efter den första anslutningen, så deras behörigheter kan läggas till rollen först efter att användningsfall 1 har körts. Det praktiska tillvägagångssättet är: skapa rollen utan anpassade tabellrader, anslut, lägg sedan till de behörigheterna.

Vi avråder från att approximera detta med inbyggda roller som Salesperson, Marketing Professional eller System Customizer. De inkluderar breda rättigheter (radering av poster, delning, bulkoperationer, obegränsad anpassning) som integrationen aldrig använder, vilket motverkar syftet med att flytta bort från System Administrator.

När rollen har tilldelats, kör anslutningstestet i eMarketeer. Det verifierar att applikationsanvändaren kan nå de nödvändiga tabellerna. Dataverse anger den saknade behörigheten i felet när ett anrop nekas, så eventuella luckor som uppstår senare är enkla att spåra tillbaka till en specifik rollpost.

Behörigheter per funktion

Det här avsnittet beskriver vad integrationen gör med dessa behörigheter, funktion för funktion. Om du inte använder en funktion kan dess behörigheter utelämnas från rollen.

Varje användningsfall anger om det är användarinitierat (någon i eMarketeer eller Dynamics utlöser det, direkt eller via en automatisering de konfigurerat) eller automatiskt (en återkommande bakgrundssynk). De två automatiska flödena — samtyckessynk och prenumerationssynk — påverkar bara kontakter som redan finns i båda systemen; de hämtar aldrig in nya poster till endera sidan på egen hand.

1. Ansluta och installera

Körs en gång, när din administratör ansluter Dynamics 365 till eMarketeer. Integrationen verifierar att applikationsanvändaren fungerar och installerar sedan sina komponenter: en "eMarketeer"-publisher, två anpassade tabeller för prenumerationssynk (em_subscriptions, em_subscriptioncategories) med nycklar och relationer, en systemvy och ett avsnitt på Contact-formuläret som visar prenumerationer, webhooks som meddelar eMarketeer när kontakter skapas eller uppdateras, och eMarketeers kontaktkortspanel (en HTML-webbresurs).

Utlösare: användarinitierad. Körs bara när din administratör ansluter integrationen.

Tabeller som används: publisher, system forms, web resources, service endpoints, SDK-meddelanderegistreringar, tabell-/nyckel-/relationsdefinitioner (metadata), saved queries.

Behörigheter som krävs: posterna markerade med enbart anslut/koppla från i "Alla behörigheter i översikt". Bara vid installation.

Vad som händer	Tabell	Åtkomst	Behörighet
Verifiera att applikationsanvändaren är konfigurerad (WhoAmI)	—	Read	ingen
Kontrollera att de nödvändiga tabellerna är synliga	—	Read	ingen
Kontrollera att granskning är aktiverat på Contact	metadata	Read	prvReadEntity
Skapa "eMarketeer"-publishern (prefix em)	publisher	Read + Create	prvReadPublisher, prvCreatePublisher
Skapa de två anpassade prenumerationstabellerna	metadata	Read + Create	prvReadEntity, prvCreateEntity, prvCreateAttribute
Skapa alternativa nycklar på dessa tabeller	metadata	Read + Create	prvReadEntityKey, prvCreateEntityKey
Skapa relationer till Contact	metadata	Read + Create	prvReadRelationship, prvCreateRelationship
Skapa prenumerationsvyn	savedquery	Read + Create	prvReadCustomization, prvWriteCustomization
Lägga till ett prenumerationsavsnitt i Contact-formuläret	systemform	Read + Write	prvReadSystemForm, prvWriteSystemForm
Publicera anpassningarna	—	Execute	prvPublishCustomization
Registrera eMarketeers webhook-endpoint	serviceendpoint	Read + Create	prvReadServiceEndpoint, prvCreateServiceEndpoint
Registrera webhook-steg för Contact create/update	sdkmessage, sdkmessageprocessingstep	Read + Create	prvReadSdkMessage, prvReadSdkMessageProcessingStep, prvCreateSdkMessageProcessingStep
Installera kontaktkortspanelen	webresource	Read + Create + Write	prvReadWebResource, prvCreateWebResource, prvWriteWebResource

2. Koppla från och avinstallera

Körs en gång om du kopplar från integrationen. Tar bort allt som användningsfall 1 installerade.

Utlösare: användarinitierad. Körs bara när din administratör kopplar från integrationen.

Tabeller som används: service endpoints, SDK-meddelanderegistreringar, tabelldefinitioner (metadata), web resources.

Behörigheter som krävs: prvReadSdkMessageProcessingStep, prvDeleteSdkMessageProcessingStep; prvReadServiceEndpoint, prvDeleteServiceEndpoint; prvReadWebResource, prvDeleteWebResource; prvReadEntity, prvDeleteEntity. Bara vid avinstallation.

Vad som händer	Tabell	Åtkomst	Behörighet
Ta bort webhook-registreringarna	sdkmessageprocessingstep, serviceendpoint	Read + Delete	prvReadSdkMessageProcessingStep, prvDeleteSdkMessageProcessingStep, prvReadServiceEndpoint, prvDeleteServiceEndpoint
Ta bort de två anpassade prenumerationstabellerna	metadata	Read + Delete	prvReadEntity, prvDeleteEntity
Ta bort kontaktkortspanelen	webresource	Read + Delete	prvReadWebResource, prvDeleteWebResource

3. Exportera kontakter och leads till Dynamics

Det här är det centrala utgående flödet: eMarketeer-automatiseringar och funktionen för manuell "dela till Dynamics" skapar eller uppdaterar Leads och kontakter i din miljö. Innan något skapas letar integrationen upp befintliga poster via e-post, telefon eller företag för att undvika dubbletter. Den kopplar nya Leads till en matchande Contact eller Account, kan skapa Account när en kontakt delas med ett nytt företag, och listar dina Dynamics-användare så att en ägare kan väljas för nya poster.

Utlösare: användarinitierad. Antingen delar någon manuellt en kontakt till Dynamics, eller når en kontakt ett exportsteg i en automatisering ditt team har byggt. Inget exporteras utan ett sådant steg.

Tabeller som används: contact, lead, account, systemuser, role.

Behörigheter som krävs: contact Read/Create/Append; lead Read/Create/Write/Append; account Read/Create/Append To; systemuser Read/Append To; role Read.

Vad som händer	Tabell	Åtkomst	Behörighet
Slå upp befintliga kontakter (via e-post, id, företag, ursprunglig lead)	contact (+ account)	Read	prvReadContact, prvReadAccount
Slå upp befintliga Leads (via e-post, företag, id)	lead	Read	prvReadLead
Skapa en Lead (valfritt kopplad till ägare / parent Contact / Account)	lead	Create	prvCreateLead, prvAppendLead, prvAppendToUser, prvAppendToContact, prvAppendToAccount
Uppdatera en befintlig Lead	lead	Update	prvWriteLead
Skapa en Contact (valfritt kopplad till Account / ägare)	contact	Create	prvCreateContact, prvAppendContact, prvAppendToAccount, prvAppendToUser, prvAssignContact
Sök / läs konton	account	Read	prvReadAccount
Skapa ett Account (vid delning med ett nytt företag)	account	Create	prvCreateAccount
Lista användare för ägar-dropdown	systemuser, role	Read	prvReadUser, prvReadRole

4. Logga marknadsföringsaktiviteter

eMarketeer-automatiseringssteg skriver Tasks och Phone Calls till matchande Leads eller kontakter, så att ditt säljteam ser marknadsföringshistoriken i Dynamics. När ett steg anger en ägare skapas aktiviteten på uppdrag av den Dynamics-användaren, så den visas med rätt skapare.

Utlösare: användarinitierad. Körs bara när en kontakt når ett aktivitetssteg i en automatisering ditt team har byggt.

Tabeller som används: task, phone call, activity party, contact, lead, systemuser.

Behörigheter som krävs: Activity Create/Append; contact och lead Read/Append To; systemuser Read/Append To; Act on Behalf of Another User.

Vad som händer	Tabell	Åtkomst	Behörighet
Hitta den Lead/Contact som aktiviteten ska kopplas till	contact, lead	Read	prvReadContact, prvReadLead
Skapa en Task på posten	task	Create	prvCreateActivity, prvAppendActivity, prvAppendToLead / prvAppendToContact
Skapa ett Phone Call på posten	phonecall, activityparty	Create	samma som Task, plus prvAppendToUser
Läsa ägarens Entra ID-objekt-id (för attribution)	systemuser	Read	prvReadUser
Skapa aktiviteten som den valda användaren	—	—	prvActOnBehalfOfAnotherUser

5. Marknadsföringslistor

Det här fungerar i två riktningar. eMarketeer kan importera medlemmarna i en Dynamics-marknadsföringslista (statisk eller dynamisk) som eMarketeer-kontakter, inklusive deras företagsnamn, och automatiseringssteg kan lägga till de Leads och kontakter de skapade i en befintlig Dynamics-marknadsföringslista. Integrationen skapar eller tar aldrig bort marknadsföringslistor i din miljö.

Utlösare: användarinitierad. Importer startas av en eMarketeer-användare som väljer en lista; att lägga till medlemmar sker bara via ett automatiseringssteg ditt team har byggt.

Tabeller som används: list, contact, lead, account.

Behörigheter som krävs: list Read/Write/Append To; contact och lead Read/Append; account Read.

Vad som händer	Tabell	Åtkomst	Behörighet
Lista och läs marknadsföringslistor	list	Read	prvReadList
Läs statiska listmedlemmar	list, contact, lead	Read	prvReadList, prvReadContact, prvReadLead
Läs dynamiska listmedlemmar (kör listans egen fråga)	contact	Read	prvReadContact
Läs medlemsdetaljer och deras företag	contact, account	Read	prvReadContact, prvReadAccount
Lägg till medlemmar i en lista (association)	list, contact, lead	Update	prvWriteList, prvAppendToList, prvAppendContact / prvAppendLead

6. Samtyckessynk

Håller e-postsamtycket synkroniserat i båda riktningarna med ett enda fält: donotbulkemail.

Dynamics → eMarketeer: integrationen läser Dataverse-granskningsloggen för ändringar av det fältet och tillämpar dem på matchande eMarketeer-kontakter, så att en avanmälan gjord i Dynamics blockerar marknadsförings-e-post i eMarketeer.

eMarketeer → Dynamics: när en kontakt avanmäler sig i eMarketeer sätter integrationen donotbulkemail på matchande Dynamics Contact. Inget annat fält på Contact ändras någonsin av det här flödet.

Utlösare: automatisk. Körs som en återkommande bakgrundssynk. Den påverkar bara kontakter som finns i båda systemen (matchade via e-post eller en etablerad länk) och skapar aldrig poster på endera sidan.

Tabeller som används: contact, audit, attributdefinitioner (metadata).

Behörigheter som krävs: contact Read/Write; View Audit History och View Audit Summary; granskning aktiverat på Contact-tabellen.

Vad som händer	Tabell	Åtkomst	Behörighet
Hitta kolumnnumret för donotbulkemail	metadata	Read	prvReadEntity, prvReadAttribute
Läsa granskningsposter för samtyckeändringar på kontakter	audit	Read	prvReadRecordAuditHistory, prvReadAuditSummary
Lösa upp de granskade kontakterna	contact	Read	prvReadContact
Skriva donotbulkemail på kontakter	contact	Update	prvWriteContact

7. Prenumerationssynk

Speglar eMarketeers prenumerationskategorier och varje kontakts prenumerationsval till de två anpassade tabellerna som integrationen installerade (em_subscriptions, em_subscriptioncategories), och läser ändringar gjorda i Dynamics (via prenumerationsavsnittet på Contact-formuläret) tillbaka till eMarketeer. Alla skrivningar i det här flödet går till integrationens egna anpassade tabeller; dina kontakter läses bara.

Utlösare: automatisk. Körs i bakgrunden när prenumerationsdata ändras på endera sidan (i Dynamics via de webhooks som installerades vid anslutning). Precis som samtyckessynken gäller den bara kontakter som finns i båda systemen.

Tabeller som används: em_subscriptions (anpassad), em_subscriptioncategories (anpassad), contact.

Behörigheter som krävs: Read, Create, Write, Delete, Append och Append To på de två anpassade tabellerna; contact Read och Append To.

Vad som händer	Tabell	Åtkomst	Behörighet
Läsa prenumerationskategorier	em_subscriptioncategories	Read	prvReadem_subscriptioncategories
Skapa / byta namn på kategorier	em_subscriptioncategories	Create + Update	prvCreateem_subscriptioncategories, prvWriteem_subscriptioncategories
Ta bort kategorier raderade i eMarketeer	em_subscriptioncategories	Delete	prvDeleteem_subscriptioncategories
Läsa prenumerationstillstånd	em_subscriptions	Read	prvReadem_subscriptions
Spara prenumerationstillstånd (kopplade till Contact + kategori)	em_subscriptions	Create + Update	prvCreateem_subscriptions, prvWriteem_subscriptions, prvAppendem_subscriptions, prvAppendToContact, prvAppendToem_subscriptioncategories
Ta bort inaktuella prenumerationsrader	em_subscriptions	Delete	prvDeleteem_subscriptions
Läsa kontakter (matchning via e-post, initial synk)	contact	Read	prvReadContact

8. Kontaktkort och att lägga till Dynamics-poster i eMarketeer

Kontaktkortspanelen som installeras på dina Contact- och Lead-formulär visar eMarketeers marknadsföringshistorik för posten som visas. Därifrån (eller automatiskt via contact-created-webhooken) kan en Dynamics-Contact eller Lead läggas till i eMarketeer: integrationen läser posten och dess parent Account och skapar en matchande kontakt i eMarketeer. Det här flödet är skrivskyddat i din miljö.

Utlösare: användarinitierad. En Dynamics-användare visar en post i panelen eller lägger till den i eMarketeer därifrån. När contact-created-webhooken är aktiverad meddelas eMarketeer automatiskt om nyligen skapade Dynamics-kontakter, men en post kan bara komma in i eMarketeers marknadsföringsdatabas via de flöden som beskrivs här.

Tabeller som används: contact, lead, account.

Behörigheter som krävs: contact, lead och account Read only.

Vad som händer	Tabell	Åtkomst	Behörighet
Panelen läser den öppna Contact/Lead-postens e-post (körs i den visande användarens webbläsare, under den användarens egna behörigheter)	—	Read	ingen för applikationsanvändaren
Läsa Contact eller Lead som ska läggas till	contact, lead	Read	prvReadContact, prvReadLead
Läsa parent Account (företagsnamn)	account	Read	prvReadAccount

Utbytta data

Det här avsnittet listar all data som passerar mellan de två systemen, för granskning ur dataskyddssynpunkt. Inga informationskategorier eller personuppgifter utöver vad som listas här utbyts. Integrationen överför samma kategorier av personuppgifter som den tidigare godkända samtyckesintegrationen (vanliga affärskontaktuppgifter, samtycksstatus och prenumerationsval) och tillför inga nya. Den utför ingen berikning, poängsättning eller inferens: varje värde som skrivs till endera systemet har angetts av en användare i ett av de två systemen.

Dynamics 365 → eMarketeer

Data	Fält	När
Kontakt-/Lead-visitkortsuppgifter	förnamn, efternamn, e-postadress, telefon, mobiltelefon, jobbtitel, hälsningsfras, företagsnamn, post-id, skapad datum	Import av marknadsföringslistans medlemmar; lägga till en post i eMarketeer från kontaktskortet; matchning inför en export
Account-uppgifter (företag)	företagsnamn, adress (gata, stad, delstat/region, postnummer, land)	Visas när ett företag väljs under export; importeras som kontaktens företagsnamn
Samtycksstatus	flaggan donotbulkemail och granskningens tidsstämpel för ändringen	Samtyckessynk
Prenumerationsval	kategori och prenumererad ja/nej per kontakt (från integrationens egna em_subscriptions-tabell)	Prenumerationssynk
Dynamics-användarkatalogposter	förnamn, efternamn, jobbets e-postadress och (för den valda ägaren) Entra ID-objekt-id	Fyller i "postägare"-dropdown i eMarketeer; tillskriver aktiviteter till den valda användaren

eMarketeer → Dynamics 365

Data	Fält	När
Kontaktuppgifter skrivna till Leads/kontakter	förnamn, efternamn, e-postadress, telefon, mobiltelefon, jobbtitel, hälsningsfras, företagsnamn, adress (gata, stad, delstat/region, postnummer, land)	Export av en kontakt eller lead (användningsfall 3)
Nya Account-uppgifter	företagsnamn och valfritt kontaktens adress	Delning av kontakt med ett nytt företag
Marknadsföringsaktivitetsposter	ämne och beskrivningstext (kampanj-/meddelandenamn och utfall enligt konfiguration i automatiseringen), datum, ägande användare	Loggning av aktiviteter (användningsfall 4)
Samtycksstatus	enbart flaggan donotbulkemail	Samtyckessynk, när en kontakt avanmäler sig i eMarketeer
Prenumerationsdata	kategorinamn; per kontakt, prenumererad ja/nej kopplad till Contact-posten (radnyckeln i de anpassade tabellerna härleds från kontaktens e-postadress och kategori)	Prenumerationssynk, skrivet till integrationens egna anpassade tabeller

Registrerade personer begränsas till de kontakter och Leads ditt team väljer att hantera i båda systemen, plus namnen och jobbets e-postadresser för dina egna Dynamics-användare enligt ovan. Inga särskilda kategorier av personuppgifter (artikel 9 i GDPR) läses eller skrivs någonsin av integrationen själv. Fritext-fält som den överför, till exempel aktivitetsbeskrivningar, innehåller bara vad ditt team konfigurerar i eMarketeer.

Komplett referens för API-anrop

Den här tabellen listar varje Dataverse Web API-anrop som integrationen gör. Anrop markerade med enbart anslut eller enbart koppla från körs bara under användningsfallen 1 och 2.

HTTP-anrop	Tabell	Åtkomst	Behörighet som krävs
GET /contacts?$filter=emailaddress1 eq ...	contact	Read	prvReadContact
GET /contacts?$filter=contactid eq ...&$select=...	contact	Read	prvReadContact
GET /contacts?$filter=...&$expand=parentcustomerid_account	contact, account	Read	prvReadContact + prvReadAccount
GET /contacts?$filter=companyname eq ...	contact	Read	prvReadContact
GET /contacts?$filter=_originatingleadid_value eq ...	contact	Read	prvReadContact
GET /contacts?$top=1000&$orderby=...&$filter=...	contact	Read	prvReadContact
POST /contacts	contact	Create	prvCreateContact; prvAppendContact + prvAppendToAccount / prvAppendToUser vid länkning av Account / ägare; prvAssignContact
POST /contacts/Microsoft.Dynamics.CRM.UpdateMultiple (fält: donotbulkemail)	contact	Update	prvWriteContact
GET /leads?$filter=emailaddress1 eq ...	lead	Read	prvReadLead
GET /leads?$filter=... (företags- och aktiva lead-filter)	lead	Read	prvReadLead
GET /leads(id)	lead	Read	prvReadLead
POST /leads	lead	Create	prvCreateLead; prvAppendLead + prvAppendToUser / prvAppendToContact / prvAppendToAccount vid länkning av ägare / Contact / Account
PATCH /leads(id)	lead	Update	prvWriteLead
GET /accounts?$filter=accountid eq ...	account	Read	prvReadAccount
GET /accounts?$filter=... (namnsökning)	account	Read	prvReadAccount
POST /accounts	account	Create	prvCreateAccount
GET /lists?$filter=...	list	Read	prvReadList
GET /lists(id)	list	Read	prvReadList
GET /lists(id)?$expand=listcontact_association / listlead_association	list, contact, lead	Read	prvReadList + prvReadContact / prvReadLead
GET /contacts?fetchXml=... (kör en dynamisk listas lagrade fråga)	contact	Read	prvReadContact
POST /AddListMembersList	list, contact, lead	Update (association)	prvWriteList + prvAppendToList + prvAppendContact / prvAppendLead
POST /tasks	task	Create	prvCreateActivity + prvAppendActivity + prvAppendToLead / prvAppendToContact
POST /phonecalls	phonecall, activityparty	Create	samma som tasks + prvAppendToUser
CallerObjectId-huvud på POST /tasks / /phonecalls	—	—	prvActOnBehalfOfAnotherUser
GET /systemusers?$select=...&$filter=...	systemuser	Read	prvReadUser
GET /systemusers(id)?$select=azureactivedirectoryobjectid	systemuser	Read	prvReadUser
GET /privileges?$filter=...; GET /roles?$filter=...	privilege, role	Read	prvReadRole (privilegetabellen har ingen dedikerad läsbehörighet)
GET /audits?$select=...&$filter=objecttypecode eq 'contact' and ...	audit	Read	prvReadRecordAuditHistory + prvReadAuditSummary
GET /RetrieveAvailableLanguages()	—	Read	ingen
GET /EntityDefinitions(LogicalName='contact')/Attributes?$select=...	metadata	Read	prvReadEntity + prvReadAttribute
GET /em_subscriptioncategorieseses	em_subscriptioncategories	Read	prvReadem_subscriptioncategories
GET /em_subscriptionses?$filter=...	em_subscriptions	Read	prvReadem_subscriptions
POST /em_subscriptioncategorieseses/Microsoft.Dynamics.CRM.UpsertMultiple	em_subscriptioncategories	Create + Update	prvCreateem_subscriptioncategories + prvWriteem_subscriptioncategories
POST /em_subscriptionses/Microsoft.Dynamics.CRM.UpsertMultiple	em_subscriptions	Create + Update	prvCreateem_subscriptions + prvWriteem_subscriptions + prvAppendem_subscriptions; prvAppendToContact + prvAppendToem_subscriptioncategories
GET + DELETE /em_subscriptionses(id) / /em_subscriptioncategorieseses(id)	em_subscriptions, em_subscriptioncategories	Delete	prvDeleteem_subscriptions + prvDeleteem_subscriptioncategories
GET / POST /publishers — enbart anslut	publisher	Read + Create	prvReadPublisher, prvCreatePublisher
GET / POST /EntityDefinitions — enbart anslut	metadata	Read + Create	prvReadEntity + prvCreateEntity + prvCreateAttribute
GET / POST /EntityDefinitions(...)/Keys — enbart anslut	metadata	Read + Create	prvReadEntityKey + prvCreateEntityKey
GET / POST /RelationshipDefinitions — enbart anslut	metadata	Read + Create	prvReadRelationship + prvCreateRelationship
GET /EntityDefinitions; DELETE /EntityDefinitions(id) — enbart koppla från	metadata	Read + Delete	prvReadEntity + prvDeleteEntity
GET / POST /savedqueries — enbart anslut	savedquery	Read + Create	prvReadCustomization / prvWriteCustomization
GET /systemforms?$filter=...; PATCH /systemforms(id) — enbart anslut	systemform	Read + Update	prvReadSystemForm / prvWriteSystemForm
POST /PublishXml — enbart anslut	—	Execute	prvPublishCustomization
GET /customcontrols — enbart anslut	customcontrol	Read	ingen dedikerad (ingen prvReadCustomControl finns)
GET / POST /serviceendpoints — enbart anslut	serviceendpoint	Read + Create	prvReadServiceEndpoint / prvCreateServiceEndpoint
GET /sdkmessages; GET /sdkmessagefilters — enbart anslut	sdkmessage, sdkmessagefilter	Read	prvReadSdkMessage
GET / POST /sdkmessageprocessingsteps — enbart anslut	sdkmessageprocessingstep	Read + Create	prvReadSdkMessageProcessingStep + prvCreateSdkMessageProcessingStep
GET + DELETE /sdkmessageprocessingsteps(id); GET + DELETE /serviceendpoints(id) — enbart koppla från	sdkmessageprocessingstep, serviceendpoint	Read + Delete	prvReadSdkMessageProcessingStep + prvDeleteSdkMessageProcessingStep; prvReadServiceEndpoint + prvDeleteServiceEndpoint
GET /webresourceset?$filter=... — enbart anslut/koppla från	webresource	Read	prvReadWebResource
POST / PATCH /webresourceset(id) — enbart anslut	webresource	Create + Update	prvCreateWebResource / prvWriteWebResource
DELETE /webresourceset(id) — enbart koppla från	webresource	Delete	prvDeleteWebResource
GET /WhoAmI() — enbart anslut	—	Read	ingen
GET /api/data/v9.2/ (servicedokument) — enbart anslut	—	Read	ingen
GET /EntityDefinitions(LogicalName='contact')?$select=IsAuditEnabled — enbart anslut	metadata	Read	prvReadEntity

Autentiseringsendpoints

Det här är de identitetsrelaterade anrop som integrationen gör utanför din Dataverse-miljö:

Anrop	Endpoint	Syfte
Token-begäran	POST https://login.microsoftonline.com/{yourtenant}/oauth2/v2.0/token med grant_type=client_credentials och scope=https://<yourenvironment>/.default	Hämtar applikationsanvändarens åtkomsttoken. Ingen användarkontext, inga Microsoft Graph-scope.
Miljöidentifiering	GET https://globaldisco.crm.dynamics.com/api/discovery/v2.0/Instances, med den anslutande administratörens egna token, bara vid initial anslutning	Hittar Dynamics-miljön att ansluta till.