DocumentatieCampaignDocumentatie voor Campaign v8

Werken met Campagne en Microsoft Dynamics 365 crm-ms-dynamics

Last update: Wed Feb 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Beginner
  • Intermediate
  • Admin
  • User

Activeer uw gegevens van CRM over kanaalmededeling: leer hoe te om contacten van over te gaan Microsoft Dynamics 365 naar Adobe Campaign en deel gegevens over de campagneprestaties (verstuurt, opent, klikt en stuit) van Adobe Campaign naar Microsoft Dynamics 365.

Zodra configuratie wordt gedaan, wordt de gegevenssynchronisatie tussen systemen uitgevoerd via een specifieke werkschemaactiviteit. Meer informatie.

NOTE
Ondersteunde versies voor Microsoft Dynamics worden gedetailleerd beschreven in de campagne Compatibiliteitsmatrix.

Voer de onderstaande stappen uit om een speciale externe account te configureren voor het importeren en exporteren van Microsoft Dynamics 365-gegevens naar Adobe Campaign.

Voor elk systeem, moeten deze stappen door een beheerder worden uitgevoerd.

CAUTION
De stappen in deze documentatie zullen u door het creëren van integratie/registraties begeleiden die het toewijzen van toestemmingen en/of admin toegang impliceren. Het is uw verantwoordelijkheid om ervoor te zorgen dat deze stappen voldoen aan uw bedrijfsbeleid alvorens uit te voeren, en hen zorgvuldig uit te voeren.

Microsoft Dynamics 365 configureren config-crm-microsoft

Microsoft Dynamics 365 verbinden om met Adobe Campaign te werken via Web-API, aanmelden bij Microsoft Azure Directory met een Algemene beheerder referentie en volg de onderstaande stappen:

  1. Krijg uw Dynamica 365 toepassings (cliënt) identiteitskaart Meer informatie
  2. Sleutel-id voor Microsoft Dynamics Certificate en Key ID genereren. Meer informatie
  3. Machtigingen configureren. Meer informatie
  4. Maak een App-gebruiker. Meer informatie
  5. Codeer de persoonlijke sleutel. Meer informatie

Dynamics 365 Client ID ophalen get-client-id-microsoft

Om de toepassings (cliënt) identiteitskaart te krijgen, moet u een App in Azure Actieve Folder registreren.

  1. Bladeren naar Azure Active Directory > App-registraties en selecteert u Nieuwe registratie.
  2. Voer een unieke naam in die u kunt helpen een instantie te identificeren, zoals adobecampagne<instance identifier>.

Als u het bestand eenmaal hebt opgeslagen, wijst Microsoft Azure Directory een unieke gebeurtenis toe Toepassings-id (client) naar uw app. Deze id hebt u later nodig bij het configureren van Dynamics 365 in Adobe Campaign.

Meer informatie in Microsoft Dynamics 365 - documentatie.

Sleutel-id voor Microsoft Dynamics Certificate en Key ID genereren config-certificate-key-id

Om de Id van certificaatsleutel (customKeyIdentifier) en de Sleutel-id (keyId), moet u een certificaat uploaden. Certificaten kunnen als geheimen worden gebruikt om de identiteit van de toepassing te bewijzen wanneer een token wordt aangevraagd. U kunt het ook openbare sleutels noemen.

Volg de onderstaande stappen:

  1. Bladeren naar Azure Active Directory > App-registraties en selecteer de toepassing die eerder is gemaakt.
  2. Selecteren op Certificaten en geheim.
  3. Van de Certificaten tabblad, klikt u op Certificaat uploaden
  4. Upload uw openbare certificaat.
  5. Bladeren naar de Manifest koppeling om de Id van certificaatsleutel (customKeyIdentifier) en de Sleutel-id (keyId).

De Id van certificaatsleutel (customKeyIdentifier) en de Sleutel-id (keyId) zijn nodig in Campagne om uw externe rekening van Microsoft Dynamics 365 CRM te vormen gebruikend het Certificaat CRM O-Auth type.

Het genereren van het openbare certificaat

U kunt opensl gebruiken om het certificaat te genereren.

Bijvoorbeeld:

code language-none 
- openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout '<'private key name'>' -out '<'public certificate name'>
note note
NOTE
U kunt het aantal dagen hier wijzigen -days 365, in de voorbeeldcode voor een langere geldigheidsperiode van het certificaat.

Vervolgens moet u het certificaat coderen in base64. Om dit te doen, kunt u de hulp van een Codeur gebruiken Base64 of de bevellijn gebruiken base64 -w0 private.key voor Linux.

Machtigingen configureren config-permissions-microsoft

Stap 1: Configureer de Vereiste machtigingen voor de app die is gemaakt.

  1. Navigeren naar Azure Active Directory > App-registraties en selecteer de toepassing die eerder is gemaakt.
  2. Klikken Instellingen linksboven.
  3. Aan Vereiste machtigingen, klikt u op Toevoegen en Selecteer een API > Dynamics CRM Online.
  4. Klikken Selecteren, enable Access Dynamics 365 as organisation users selectievakje en klik op Selecteren.
  5. Selecteer vervolgens in uw app de optie Manifest onder de Beheren -menu.
  6. Van de Manifest editor, stelt de allowPublicClient eigenschap van null tot true en klik op Opslaan.

Stap 2: Toekenning beheerder

  1. Navigeren naar Azure Active Directory > Enterprise-toepassingen.
  2. Selecteer de toepassing waaraan u admin toestemming voor de gehele huurder wilt verlenen.
  3. Selecteer in het menu van het linkerdeelvenster de optie Machtigingen krachtens Beveiliging.
  4. Klikken Toelating beheerder.

Raadpleeg voor meer informatie hierover Azure-documentatie.

Een App-gebruiker maken create-app-user-microsoft

NOTE
Deze stap is optioneel met Password credentials verificatie.

De gebruiker van de app is de gebruiker die de hierboven geregistreerde toepassing zal gebruiken. Wijzigingen die met de bovenstaande app zijn aangebracht in Microsoft Dynamics, worden via deze gebruiker doorgevoerd.

Stap 1: Een niet-interactieve gebruiker maken op de azure actieve map

  1. Klikken Azure Active Directory > Users en klik op Nieuwe gebruiker.
  2. Geef een juiste naam die u wilt gebruiken en de gebruikersnaam moet een e-mailindeling zijn.
  3. Kies Dynamics 365 Administrator in de Maprol.

Stap 2: Een juiste licentie toewijzen aan de gemaakte gebruiker

  1. Van Microsoft Azure, klikt u op Admin-app.
  2. Ga naar Gebruikers > Actieve gebruikers en klik op de nieuwe gebruiker.
  3. Klikken op Productlicenties bewerken en selecteert u de Dynamics 365 Customer Engagement Plan.
  4. Klikken Sluiten.

Stap 3: Maak een toepassingsgebruiker op Dynamics CRM

  1. Van Microsoft Azure, navigeer naar Instellingen > Beveiliging > Gebruikers.
  2. Klik in de vervolgkeuzelijst en selecteer Toepassingsgebruikers en klik op Nieuw.
  3. Gebruik dezelfde gebruikersnaam als de gebruiker die hierboven in de actieve map is gemaakt.
  4. Wijs het Toepassings-id for de toepassing die u eerder hebt gemaakt.
  5. Klikken op Rollen beheren en kiest u Systeembeheerder rol voor de gebruiker.

Campagne configureren configure-acc-for-microsoft

Verbinding maken new-ms-dyn-external-account

Ten eerste moet u de externe account van Microsoft Dynamics 365 maken.

  1. Bladeren in het dialoogvenster Administration > Platform > External accounts van de Campagneverkenner en maak een externe account.

  2. Selecteren Microsoft Dynamics CRM externe rekening in de Type sectie.

  3. Selecteer de verificatiemethode in het dialoogvenster CRM O-Auth type vervolgkeuzelijst.

    1. De externe account van Microsoft Dynamics CRM configureren voor verbinding met Adobe Campaign met Wachtwoordreferenties de volgende gegevens verstrekken:

      • Server: URL van uw Microsoft CRM-server. Als u de URL van uw Microsoft CRM-server wilt vinden, opent u uw Microsoft Dynamics CRM-account en klikt u op Dynamics 365 en selecteert u uw app. Vervolgens vindt u de URL van de server in de adresbalk van uw browser, bijvoorbeeld https://myserver.crm.dynamics.com/.
      • Account: Account gebruikt om u aan te melden bij Microsoft CRM.
      • Wachtwoord: Account gebruikt om u aan te melden bij Microsoft CRM.
      • Client-id: De toepassings (client)-id is te vinden op de Microsoft Azure-beheerportal in het veld Uw codecategorie bijwerken, Client-id.
      • CRM-versie: Kies de versie van CRM 365 van Dynamica CRM.

    2. Om de externe rekening van CRM van de Dynamica van Microsoft te vormen om met Adobe Campaign te verbinden met Certificaat de volgende gegevens verstrekken:

      • Server: URL van uw Microsoft CRM-server. Als u de URL van uw Microsoft CRM-server wilt vinden, opent u uw Microsoft Dynamics CRM-account en klikt u op Dynamics 365 en selecteert u uw app. Vervolgens vindt u de URL van de server in de adresbalk van uw browser, bijvoorbeeld https://myserver.crm.dynamics.com/.
      • Persoonlijke sleutel: De persoonlijke sleutel kopiëren/plakken, gecodeerde base64, zoals uitgelegd in deze sectie.
      • Sleutel-id: Sleutel beschikbaar in het dialoogvenster Manifest tabblad van uw toepassing, zoals wordt uitgelegd in deze sectie.
      • Id van aangepaste sleutel: Identificatiecode beschikbaar in het dialoogvenster Manifest tabblad van uw toepassing, zoals wordt uitgelegd in deze sectie.
      • Client-id: Application (client) ID, te vinden op de Microsoft Azure-beheerportal, zoals uitgelegd in deze sectie.
      • CRM-versie: Kies de versie van CRM 365 van Dynamica CRM.

  4. Selecteer de Inschakelen om het account te activeren in Campagne.

NOTE
Om de opstelling goed te keuren, logoff en terug aan de cliëntconsole van Adobe Campaign.

Tabellen selecteren voor synchronisatie ms-dyn-create-tables

U kunt nu tabellen configureren voor synchronisatie.

  1. Klik op de knop Microsoft CRM configuration wizard….
  2. Selecteer de tabellen die u wilt synchroniseren en start het proces.
  3. Controleer het schema dat in Adobe Campaign is gegenereerd in het dialoogvenster Administration > Configuration > Data schemas knooppunt.
NOTE
Zorg ervoor dat u aan de lijst van gewenste personen twee URL's toevoegt: de server-URL en login.microsoftonline.com. Neem hiervoor contact op met uw Adobe.

Opsommingen synchroniseren sfdc-enum-sync

Zodra het schema wordt gecreeerd, kunt u opsommingen van Dynamiek 365 aan Adobe Campaign automatisch synchroniseren.

  1. Open de assistent vanuit de Synchronizing enumerations… koppeling.
  2. Selecteer de opsomming van Adobe Campaign die de Dynamica 365 opsomming aanpast.
    U kunt alle waarden van een Adobe Campaign-opsomming vervangen door die van de CRM: hiervoor selecteert u Yes in de Replace kolom.
  3. Klikken Next en vervolgens Start om de opsommingen te importeren.
  4. Bladeren in het dialoogvenster Administration > Platform > Enumerations knooppunt om geïmporteerde waarden te controleren.

Adobe Campaign en Microsoft Dynamics 365 zijn nu verbonden. U kunt gegevenssynchronisatie tussen de twee systemen instellen.

Als u gegevens wilt synchroniseren tussen Adobe Campaign-gegevens en Microsoft CRM, maakt u een workflow en gebruikt u de opdracht CRM connector activiteit.

Meer informatie over gegevenssynchronisatie op deze pagina.

Ondersteunde veldgegevenstypen ms-dyn-supported-types

Voor Microsoft Dynamics 365 worden de ondersteunde/niet-ondersteunde kenmerktypen hieronder vermeld:

Type kenmerk
Ondersteund
Basistypen: boolean, datetime, decimal, float, double, integer, bigint , string
Ja
Geld (als dubbel)
Ja
memo, entiteitsnaam, primarykey, uniqueidentifier (als tekenreeksen)
Ja
Status, picklist (we slaan de mogelijke waarden op in opsommingen), state (string)
Ja
owner (als string)
Ja
Opzoeken (alleen zoeken naar verwijzingen naar één entiteit)
Ja
klant
Nee
Betreffende
Nee
PartyList
Nee
ManagedProperty
Nee
recommendation-more-help
35662671-8e3d-4f04-a092-029a056c566b