DokumentationAEM 6.4Användarhandbok om Forms

Microsoft Dynamics OData-konfiguration microsoft-dynamics-odata-configuration

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

Skapat för:

  • User
CAUTION
AEM 6.4 har nått slutet på den utökade supporten och denna dokumentation är inte längre uppdaterad. Mer information finns i teknisk supportperiod. Hitta de versioner som stöds här.

Utnyttja, integrera och arbeta med online- och lokala Microsoft Dynamics-tjänster via formulärdatamodell.

dataintegrering

Microsoft Dynamics är en CRM- och ERP-programvara (Enterprise Resource Planning) som innehåller företagslösningar för att skapa och hantera kundkonton, kontakter, leads, möjligheter och ärenden. AEM Forms dataintegrering tillhandahåller en OData-molntjänstkonfiguration som integrerar Forms med både online- och lokal Microsoft Dynamics-server. Det gör att du kan skapa en formulärdatamodell som baseras på de enheter, attribut och tjänster som definieras i Microsoft Dynamics-tjänsten. Formulärdatamodellen kan användas för att skapa anpassade formulär som interagerar med Microsoft Dynamics-servern för att möjliggöra affärsarbetsflöden. Till exempel:

  • Fråga Microsoft Dynamics-servern efter data och förifylla adaptiva formulär
  • Skriv data i Microsoft Dynamics när formulär skickas med adaptiv form
  • Skriv data i Microsoft Dynamics via anpassade entiteter som definierats i formulärdatamodellen och vice versa

AEM Forms tilläggspaket innehåller även OData-referenskonfiguration som du kan använda för att snabbt integrera Microsoft Dynamics med AEM Forms.

När paketet är installerat är följande enheter och tjänster tillgängliga på din AEM Forms-instans:

  • MS Dynamics OData-Cloud Service (OData-tjänst)
  • Formulärdatamodell med förkonfigurerade Microsoft Dynamics-enheter och -tjänster.

OData-Cloud Servicen och formulärdatamodellen med förkonfigurerade Microsoft Dynamics-enheter och -tjänster är bara tillgängliga på din AEM Forms-instans om körningsläget för den AEM instansen är inställt på samplecontent(standard). Mer information om hur du konfigurerar körningslägen för en AEM instans finns i Körningslägen.

Förutsättningar prerequisites

Innan du börjar konfigurera och konfigurera Microsoft Dynamics måste du se till att du har:

Ange svars-URL för registrerat Microsoft Dynamics-program set-reply-url-for-registered-microsoft-dynamics-application

Gör följande för att ange svars-URL för det registrerade Microsoft Dynamics-programmet:

NOTE
Använd bara den här proceduren när du integrerar AEM Forms med Microsoft Dynamics onlineserver.

  1. Gå till Microsoft Azure Active Directory-kontot och lägg till följande URL för molntjänstkonfiguration i Reply URLs inställningar för ditt registrerade program:

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

    azure_directory

  2. Spara konfigurationen.

Konfigurera Microsoft Dynamics för IFD configure-microsoft-dynamics-for-ifd

Microsoft Dynamics använder anspråksbaserad autentisering för att ge åtkomst till data på Microsoft Dynamics CRM-servern till externa användare. Gör så här för att konfigurera Microsoft Dynamics för Internet-baserad distribution (IFD) och konfigurera anspråksinställningar om du vill aktivera detta.

NOTE
Använd bara den här proceduren när du integrerar AEM Forms med en lokal Microsoft Dynamics-server.

  1. Konfigurera den lokala instansen av Microsoft Dynamics för IFD enligt beskrivningen i Konfigurera IFD för Microsoft Dynamics.

  2. Kör följande kommandon med Windows PowerShell för att konfigurera anspråksinställningar för IFD-aktiverade Microsoft Dynamics:

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

    Se Appregistrering för CRM lokalt (IFD) för mer information.

Konfigurera OAuth-klient på AD FS-dator configure-oauth-client-on-ad-fs-machine

Gör följande för att registrera en OAuth-klient på AD FS-datorn (Active Directory Federation Services) och bevilja åtkomst på AD FS-datorn:

NOTE
Använd bara den här proceduren när du integrerar AEM Forms med en lokal Microsoft Dynamics-server.

  1. Kör följande kommando:

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

    Var:

    • Client-ID är ett klient-ID som du kan generera med valfri GUID-generator.

    • redirect-uri är URL:en till molntjänsten Microsoft Dynamics OData på AEM Forms. Standardmolntjänsten som installeras med AEM Forms-paketet distribueras på följande URL:

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

  2. Kör följande kommando för att bevilja åtkomst på AD FS-datorn:

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

    Var:

    • resource är Microsoft Dynamics organisations-URL.

  3. Microsoft Dynamics använder HTTPS-protokoll. Om du vill anropa AD FS-slutpunkter från Forms-servern installerar du platscertifikatet för Microsoft Dynamics i Java-certifikatarkivet med hjälp av keytool på den dator där AEM Forms körs.

Konfigurera molntjänsten för din Microsoft Dynamics-tjänst configure-cloud-service-for-your-microsoft-dynamics-service

The MS Dynamics OData-Cloud Service (OData-tjänst) konfigurationen levereras med OData-standardkonfiguration. Så här konfigurerar du den för att ansluta till din Microsoft Dynamics-tjänst.

  1. Navigera till Tools > Cloud Services > Data Sources och trycker på global konfigurationsmapp.

  2. Välj MS Dynamics OData Cloud Service (OData Service) konfiguration och knacka Properties. Dialogrutan för konfigurationsegenskapen för molntjänster öppnas.

    I Authentication Settings tab:

    1. Ange värdet för Service Root fält. Gå till Dynamics-instansen och navigera till Developer Resources för att visa värdet för fältet Tjänstrot. Till exempel https://<tenant-name>/api/data/v9.1/
    2. Ersätt standardvärdena i dialogrutan Client Id (kallas även Application ID), Client Secret, OAuth URL, Refresh Token URL, Access Token URL och Resource fält med värden från din Microsoft Dynamics-tjänstkonfiguration. Det är obligatoriskt att ange dynamicinstansens URL i Resource för att konfigurera Microsoft Dynamics med en formulärdatamodell. Använd tjänstens rot-URL för att härleda den dynamiska instansens URL. Till exempel: https://org.crm.dynamics.com.
    3. Ange openid i Authorization Scope fält för auktoriseringsprocess i Microsoft Dynamics.

    dynamics_authentication_settings

  3. Klicka på Connect to OAuth. Du omdirigeras till inloggningssidan för Microsoft Dynamics.

  4. Logga in med dina Microsoft Dynamics-autentiseringsuppgifter och godkänn för att tillåta molntjänstkonfigurationen att ansluta till Microsoft Dynamics-tjänsten. Det är en engångsuppgift att upprätta en anslutning mellan molntjänsten och tjänsten.

    Du omdirigeras sedan till konfigurationssidan för molntjänsten, som visar ett meddelande om att OData-konfigurationen har sparats.

Molntjänsten MS Dynamics OData Cloud Service (OData Service) är konfigurerad och ansluten till Dynamics-tjänsten.

Skapa formulärdatamodell create-form-data-model

När du installerar AEM Forms-paketet skapas en formulärdatamodell,Microsoft Dynamics FDM, distribueras på din AEM. Som standard använder formulärdatamodellen Microsoft Dynamics-tjänsten som konfigurerats i MS Dynamics OData-Cloud Servicen (OData-tjänsten) som datakälla.

När formulärdatamodellen öppnas för första gången ansluter den till den konfigurerade Microsoft Dynamics-tjänsten och hämtar enheter från din Microsoft Dynamics-instans. Enheterna "contact" och "lead" från Microsoft Dynamics har redan lagts till i formulärdatamodellen.

Om du vill granska formulärdatamodellen går du till Forms > Data Integrations. Välj Microsoft Dynamics FDM och klicka Edit för att öppna formulärdatamodellen i redigeringsläge. Du kan även öppna formulärdatamodellen direkt från följande URL:

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

default-fdm-1

Därefter kan du skapa ett anpassat formulär baserat på formulärdatamodellen och använda det i olika varianter av formuläranvändningen, till exempel:

  • Fyll i anpassat formulär i förväg genom att fråga information från enheter och tjänster i Microsoft Dynamics
  • Anropa Microsoft Dynamics-serveråtgärder som definierats i en formulärdatamodell med hjälp av adaptiva formulärregler
  • Skriv skickade formulärdata till Microsoft Dynamics-enheter

Vi rekommenderar att du skapar en kopia av den formulärdatamodell som medföljer AEM Forms-paketet och konfigurerar datamodeller och tjänster så att de passar dina behov. Det ser till att eventuella framtida uppdateringar av paketet inte åsidosätter formulärdatamodellen.

Mer information om hur du skapar och använder formulärdatamodell i affärsarbetsflöden finns i Dataintegrering.

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