DocumentatieAEM 6.4Gids voor formulieren

Configuratie Microsoft Dynamics OData microsoft-dynamics-odata-configuration

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • User
CAUTION
AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.

Gebruik, integreer en werk met de online en in-gebouw diensten van de Dynamica van Microsoft door het model van vormgegevens.

gegevensintegratie

Microsoft Dynamics is een ERP-software (Customer Relationship Management) en Enterprise Resource Planning (Enterprise Resource Planning) die bedrijfsoplossingen biedt voor het maken en beheren van klantaccounts, contactpersonen, leads, kansen en gevallen. AEM Forms-gegevensintegratie biedt een OData-cloudserviceconfiguratie om Forms te integreren met zowel de online server als de server voor Microsoft Dynamics op locatie. Hiermee kunt u een formuliergegevensmodel maken op basis van de entiteiten, kenmerken en services die zijn gedefinieerd in de service Microsoft Dynamics. Met het gegevensmodel van het formulier kunt u adaptieve formulieren maken die interageren met de Microsoft Dynamics-server om bedrijfsworkflows mogelijk te maken. Bijvoorbeeld:

  • Query uitvoeren op Microsoft Dynamics-server voor gegevens en aangepaste formulieren vooraf invullen
  • Gegevens naar Microsoft Dynamics schrijven bij het verzenden van aangepaste formulieren
  • Gegevens schrijven in Microsoft Dynamics via aangepaste entiteiten die zijn gedefinieerd in het formuliergegevensmodel en omgekeerd

Het AEM Forms-add-on-pakket bevat ook een referentie OData-configuratie die u kunt gebruiken om Microsoft Dynamics snel met AEM Forms te integreren.

Wanneer het pakket is geïnstalleerd, zijn de volgende entiteiten en services beschikbaar op uw AEM Forms-exemplaar:

  • MS Dynamics OData Cloud Service (OData Service)
  • Formuliergegevensmodel met vooraf geconfigureerde Microsoft Dynamics-entiteiten en -services.

De Cloud Service OData en het model van vormgegevens met vooraf gevormde entiteiten en de diensten van de Dynamica van Microsoft zijn beschikbaar op uw instantie van AEM Forms slechts als de looppaswijze voor de AEM instantie wordt geplaatst zoals samplecontent(standaard). Voor meer informatie bij het vormen van looppaswijzen voor een AEM instantie, zie Modi uitvoeren.

Vereisten prerequisites

Voordat u begint met het instellen en configureren van Microsoft Dynamics, moet u ervoor zorgen dat:

Reactie-URL instellen voor geregistreerde toepassing Microsoft Dynamics set-reply-url-for-registered-microsoft-dynamics-application

Ga als volgt te werk om de antwoordURL voor geregistreerde Microsoft Dynamics-toepassing in te stellen:

NOTE
Gebruik deze procedure alleen tijdens de integratie van AEM Forms met de online Microsoft Dynamics-server.

  1. Ga naar Microsoft Azure Active Directory-account en voeg de volgende URL voor de configuratie van de cloudservice toe in Reply URLs instellingen voor uw geregistreerde toepassing:

    https://[server]:[port]/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html

    azure_directory

  2. Sla de configuratie op.

Microsoft Dynamics voor IFD configureren configure-microsoft-dynamics-for-ifd

Microsoft Dynamics gebruikt op basis van claims om externe gebruikers toegang te bieden tot gegevens op de Microsoft Dynamics CRM-server. Om dit toe te laten, doe het volgende om de Dynamica van Microsoft voor Internet-Onder ogen ziet plaatsing (IFD) te vormen en claimmontages te vormen.

NOTE
Gebruik deze procedure slechts terwijl het integreren van AEM Forms met de server van de Dynamiek van Microsoft op-gebouw.

  1. Microsoft Dynamics on-premisse instantie voor IFD configureren, zoals beschreven in IFD configureren voor Microsoft Dynamics.

  2. Stel de volgende bevelen in werking gebruikend Vensters PowerShell om claimmontages op IFD-Toegelaten Dynamiek van Microsoft te vormen:

    code language-none 
    Add-PSSnapin Microsoft.Crm.PowerShell
 $ClaimsSettings = Get-CrmSetting -SettingType OAuthClaimsSettings
 $ClaimsSettings.Enabled = $true
 Set-CrmSetting -Setting $ClaimsSettings

    Zie Toepassingsregistratie voor CRM op locatie (IFD) voor meer informatie.

OAuth-client configureren op AD FS-computer configure-oauth-client-on-ad-fs-machine

Doe het volgende om een cliënt OAuth op de Actieve machine van de Diensten van de Federatie van de Folder (AD FS) te registreren en toegang op de machine van het ADS te verlenen:

NOTE
Gebruik deze procedure slechts terwijl het integreren van AEM Forms met de server van de Dynamiek van Microsoft op-gebouw.

  1. Voer de volgende opdracht uit:

    Add-AdfsClient -ClientId “<Client-ID>” -Name "<name>" -RedirectUri "<redirect-uri>" -GenerateClientSecret

    Waar:

    • Client-ID is een cliëntidentiteitskaart u het gebruiken van om het even welke generator kunt produceren GUID.

    • redirect-uri is de URL naar de Microsoft Dynamics OData cloud service op AEM Forms. De standaardcloudservice die wordt geïnstalleerd met het AEM Forms-pakket, wordt geïmplementeerd op de volgende URL:

      code language-none 
      http://[server]:[port]/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html

  2. Voer de volgende opdracht uit om toegang te verlenen op de AD FS-computer:

    Grant-AdfsApplicationPermission -ClientRoleIdentifier “<Client-ID>” -ServerRoleIdentifier <resource> -ScopeNames openid

    Waar:

    • resource is de URL van de Microsoft Dynamics-organisatie.

  3. Microsoft Dynamics gebruikt HTTPS-protocol. Als u AD FS-eindpunten wilt aanroepen vanaf de Forms-server, installeert u het Microsoft Dynamics-sitecertificaat in het Java-certificaatarchief met de keytool op de computer waarop AEM Forms wordt uitgevoerd.

Cloudservice configureren voor uw Microsoft Dynamics-service configure-cloud-service-for-your-microsoft-dynamics-service

De MS Dynamics OData Cloud Service (OData Service) configuratie komt met standaard configuratie OData. Ga als volgt te werk om de instantie te configureren voor verbinding met uw Microsoft Dynamics.

  1. Navigeren naar Tools > Cloud Services > Data Sources en tik op de knop global configuratiemap.

  2. Selecteren MS Dynamics OData Cloud Service (OData Service) configuratie en tikken Properties. Het dialoogvenster voor de configuratie-eigenschap van de cloudservice wordt geopend.

    In de Authentication Settings tab:

    1. Voer de waarde in voor de Service Root veld. Ga naar de instantie Dynamics en navigeer naar Developer Resources om de waarde voor het gebied van de Wortel van de Dienst te bekijken. Bijvoorbeeld https://<tenant-name>/api/data/v9.1/
    2. De standaardwaarden in het dialoogvenster Client Id (ook aangeduid als Application ID), Client Secret, OAuth URL, Refresh Token URL, Access Token URL, en Resource velden met waarden uit de configuratie van de Microsoft Dynamics. Het is verplicht de URL van de dynamische instantie op te geven in het dialoogvenster Resource veld voor het configureren van Microsoft Dynamics met een formuliergegevensmodel. Gebruik de URL van de hoofdmap van de service om de URL van de dynamische instantie af te leiden. Bijvoorbeeld: https://org.crm.dynamics.com.
    3. Opgeven openid in de Authorization Scope veld voor autorisatieproces op Microsoft Dynamics.

    dynamics_authentication_settings

  3. Klik op Connect to OAuth. U wordt omgeleid naar de aanmeldingspagina van Microsoft Dynamics.

  4. Meld u aan met uw Microsoft Dynamics-referenties en accepteer dit om de configuratie van de cloudservice in staat te stellen verbinding te maken met de service Microsoft Dynamics. Het is een eenmalige taak om verbinding tot stand te brengen tussen de cloudservice en de service.

    Vervolgens wordt u omgeleid naar de configuratiepagina van de cloudservice, die een bericht weergeeft dat de OData-configuratie is opgeslagen.

De de wolkendienst van de Cloud Service van de Dynamica van MS (OData Service) wordt gevormd en met uw dienst van de Dynamica verbonden.

Formuliergegevensmodel maken create-form-data-model

Wanneer u het AEM Forms-pakket installeert, een formuliergegevensmodel Microsoft Dynamics FDM, wordt geïmplementeerd op uw AEM. Door gebrek, gebruikt het model van vormgegevens de dienst van de Dynamiek van Microsoft die in de Cloud Service van de Dynamiek van MS (OData Service) als zijn gegevensbron wordt gevormd.

Als u het gegevensmodel van het formulier voor het eerst opent, wordt verbinding gemaakt met de geconfigureerde Microsoft Dynamics-service en worden entiteiten opgehaald van de instantie van Microsoft Dynamics. De 'contact'- en 'lead'-entiteiten van Microsoft Dynamics worden al toegevoegd aan het formuliergegevensmodel.

Ga naar Forms > Data Integrations. Selecteren Microsoft Dynamics FDM en klik op Edit om het formuliergegevensmodel te openen in de bewerkingsmodus. U kunt het formuliergegevensmodel ook rechtstreeks openen via de volgende URL:

https://[*server*]:[*port*]/aem/fdm/editor.html/content/dam/formsanddocuments-fdm/ms-dynamics-fdm

default-fdm-1

Vervolgens kunt u een adaptief formulier maken op basis van het formuliergegevensmodel en dit gebruiken in verschillende aangepaste gevallen voor formuliergebruik, zoals:

  • Het adaptieve formulier vooraf invullen door informatie op te vragen bij Microsoft Dynamics entities and services
  • Microsoft Dynamics-serverbewerkingen aanroepen die zijn gedefinieerd in een formuliergegevensmodel met behulp van adaptieve formulierregels
  • Verzonden formuliergegevens naar Microsoft Dynamics-entiteiten schrijven

Het wordt aanbevolen een kopie te maken van het formuliergegevensmodel dat bij het AEM Forms-pakket wordt geleverd en gegevensmodellen en -services naar wens te configureren. Zo weet u zeker dat toekomstige updates van het pakket het gegevensmodel van het formulier niet overschrijven.

Voor meer informatie over het creëren van en het gebruiken van het model van vormgegevens in bedrijfswerkschema's, zie Gegevensintegratie.

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da