DokumentationAEM 6.5Användarhandbok

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

Last update: Sat Jul 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Administratör
  • Användare
  • Utvecklare
Version
Artikellänk
AEM as a Cloud Service
Klicka här
AEM 6.5
Den här artikeln

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 Data Integration tillhandahåller en OData-molntjänstkonfiguration som kan integrera 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 omvänt

AEM Forms tilläggspaket innehåller även OData-konfiguration för referens 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.

Förkonfigurerade Microsoft Dynamics-enheter och -tjänster i en formulärdatamodell är bara tillgängliga på din AEM Forms-instans om körningsläget för den AEM instansen är inställt på samplecontent (standard). MS Dynamics OData-Cloud Servicen (OData Service) är även tillgänglig med andra körningslägen. Mer information om hur du konfigurerar körningslägen för en AEM 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 Svara-URL:er-inställningarna för det registrerade programmet:

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

    Azure-katalog

  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-shell 
    Add-PSSnapin Microsoft.Crm.PowerShell
 $ClaimsSettings = Get-CrmSetting -SettingType OAuthClaimsSettings
 $ClaimsSettings.Enabled = $true
 Set-CrmSetting -Setting $ClaimsSettings

    Mer information finns i Appregistrering för lokal CRM (IFD).

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:

      https://'[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 kommandot keytool på den dator som kör AEM Forms.

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

Konfigurationen för MS Dynamics OData-Cloud Servicen (OData-tjänsten) levereras med OData-standardkonfigurationen. 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 markera konfigurationsmappen global.

  2. Markera konfigurationen MS Dynamics OData-Cloud Service (OData-tjänst) och välj Properties. Dialogrutan för konfigurationsegenskapen för molntjänster öppnas.

    På fliken Autentiseringsinställningar:

    1. Ange värdet för fältet Tjänstrot. Gå till Dynamics-instansen och navigera till Resurser för utvecklare 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 fälten Klient-ID (kallas även Program-ID), Klienthemlighet, OAuth URL, Uppdatera token-URL, Åtkomsttoken-URL och Resurs med värden från din Microsoft Dynamics-tjänstkonfiguration . Det är obligatoriskt att ange den dynamiska instansens URL i fältet Resurs 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. Exempel: https://org.crm.dynamics.com.

    3. Ange openid i fältet Auktoriseringsomfång för auktoriseringsprocessen i Microsoft Dynamics.

    Autentiseringsinställningar

  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 distribueras en formulärdatamodell, Microsoft Dynamics FDM, 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.

Gå till Forms > Data Integrations om du vill granska formulärdatamodellen. Välj Microsoft Dynamics FDM och klicka på Redigera 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 arbetsflöden finns i Dataintegrering.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2