Konfigurera datakällor

Med AEM Forms dataintegrering kan du konfigurera och ansluta till olika datakällor. Följande typer stöds inte. Men med liten anpassning kan ni också integrera andra datakällor.

  • Relationsdatabaser - MySQL, Microsoft SQL Server, IBM DB2, Oracle RDBMS och Sybase
  • AEM användarprofil
  • RESTful web services
  • SOAP-baserade webbtjänster
  • OData-tjänster

Dataintegrering har stöd för autentiseringstyperna OAuth2.0, Grundläggande autentisering och API Key som är färdiga och tillåter implementering av anpassad autentisering för åtkomst till webbtjänster. Medan RESTful-, SOAP-baserade och OData-tjänster är konfigurerade i AEM Cloud Services, konfigureras JDBC för relationsdatabaser och koppling för AEM användarprofil i AEM webbkonsol.

Konfigurera relationsdatabas

Du kan konfigurera relationsdatabaser med hjälp AEM Konfiguration av webbkonsol. Gör följande:

  1. Gå till AEM webbkonsol på https://server:host/system/console/configMgr.

  2. Sök efter Apache Sling Connection Pooled DataSource konfiguration. Tryck för att öppna konfigurationen i redigeringsläge.

  3. I konfigurationsdialogrutan anger du information för den databas som du vill konfigurera, till exempel:

    • Datakällans namn
    • Egenskapen för datakälltjänst som lagrar datakällans namn
    • Java-klassnamn för JDBC-drivrutinen
    • URI för JDBC-anslutning
    • Användarnamn och lösenord för anslutning till JDBC-drivrutinen
    OBSERVERA

    Kontrollera att du krypterar känslig information, t.ex. lösenord, innan du konfigurerar datakällan. Så här krypterar du:

    1. Gå till https://'[server]:[port]/system/console/crypto.
    1. I **Plain Text** anger du lösenordet eller en sträng som ska krypteras och trycker på **Protect**.
    

    Den krypterade texten visas i fältet Skyddad text som du kan ange i konfigurationen.

  4. Aktivera Test on Borrow eller Test on Return för att ange att objekten valideras innan de lånas eller returneras från respektive till poolen.

  5. Ange en SQL SELECT-fråga i Validation Query fält för att validera anslutningar från poolen. Frågan måste returnera minst en rad. Baserat på din databas anger du något av följande:

    • SELECT 1 (MySQL och MS SQL)
    • VÄLJ 1 från dubbla (Oracle)
  6. Tryck Save för att spara konfigurationen.

Konfigurera AEM användarprofil

Du kan konfigurera AEM användarprofil med hjälp av konfigurationen för anslutning av användarprofil i AEM webbkonsol. Gör följande:

  1. Gå till AEM webbkonsol på https://'[server]:[port]system/console/configMgr.

  2. Sök efter AEM Forms Data Integrations - User Profile Connector Configuration och tryck för att öppna konfigurationen i redigeringsläge.

  3. I dialogrutan Konfiguration av anslutning till användarprofil kan du lägga till, ta bort eller uppdatera egenskaper för användarprofiler. De angivna egenskaperna kommer att vara tillgängliga för användning i formulärdatamodellen. Använd följande format för att ange egenskaper för användarprofiler:

    name=[property_name_with_location_in_user_profile],type=[property_type]

    Exempel:

    • name=profile/phoneNumber,type=string
    • name=profile/empLocation/*/city,type=string
    OBSERVERA

    The * i ovanstående exempel betecknar alla noder under profile/empLocation/ i AEM användarprofil i CRXDE-struktur. Det innebär att formulärdatamodellen har åtkomst till city type-egenskap string finns i en nod under profile/empLocation/ nod. Noderna som innehåller den angivna egenskapen måste dock följa en konsekvent struktur.

  4. Tryck Save för att spara konfigurationen.

Konfigurera mapp för molntjänstkonfigurationer

OBSERVERA

Konfiguration för molntjänstmappen krävs för konfigurering av molntjänster för RESTful-, SOAP- och OData-tjänster.

Alla konfigurationer av molntjänster i AEM konsolideras i /conf AEM i databasen. Som standard är conf mappen innehåller global mapp där du kan skapa molntjänstkonfigurationer. Du måste dock manuellt aktivera den för molnkonfigurationer. Du kan även skapa ytterligare mappar i conf för att skapa och organisera molntjänstkonfigurationer.

Så här konfigurerar du mappen för molntjänstkonfigurationer:

  1. Gå till Tools > General > Configuration Browser.

  2. Gör följande för att aktivera den globala mappen för molnkonfigurationer eller hoppa över det här steget för att skapa och konfigurera en annan mapp för molntjänstkonfigurationer.

    1. I Configuration Browser väljer du global mapp och tryck Properties.

    2. I Configuration Properties dialogruta, aktivera Cloud Configurations.

    3. Tryck Save & Close för att spara konfigurationen och stänga dialogrutan.

  3. I Configuration Browser, trycka Create.

  4. I Create Configuration dialogruta, ange en rubrik för mappen och aktivera Cloud Configurations.

  5. Tryck Create för att skapa en mapp som är aktiverad för molntjänstkonfigurationer.

Konfigurera RESTful-webbtjänster

RESTful-webbtjänsten kan beskrivas med Swagger-specifikationer i JSON- eller YAML-format i en Swagger-definitionsfil. Om du vill konfigurera RESTful-webbtjänsten i AEM-molntjänster måste du ha antingen Swagger-filen i filsystemet eller URL:en där filen finns.

Gör följande för att konfigurera RESTful-tjänster:

  1. Gå till Tools > Cloud Services > Data Sources. Tryck för att välja den mapp där du vill skapa en molnkonfiguration.

    Se Konfigurera mapp för molntjänstkonfigurationer om du vill ha information om hur du skapar och konfigurerar en mapp för molntjänstkonfigurationer.

  2. Tryck Create för att öppna Create Data Source Configuration wizard. Ange ett namn och eventuellt en rubrik för konfigurationen, välj RESTful Service från Service Type nedrullningsbar meny, där du kan bläddra och välja en miniatyrbild för konfigurationen, och trycka på Next.

  3. Ange följande information för RESTful-tjänsten:

    • Välj URL eller Fil i listrutan Växlingskälla och ange därför SWAGGER-URL:en till Swagger-definitionsfilen eller överför Swagger-filen från det lokala filsystemet.

    • Baserat på indata från Swagger Source fylls följande fält i med värden:

      • Schema: De överföringsprotokoll som används av REST API. Antalet schematyper som visas i listrutan beror på scheman som definieras i Swagger-källan.

      • Värd: Domännamnet eller IP-adressen för värden som använder REST API. Det är ett obligatoriskt fält.

      • Grundsökväg: URL-prefixet för alla API-sökvägar. Det är ett valfritt fält.\

        Om det behövs kan du redigera de förifyllda värdena för dessa fält.

    • Välj autentiseringstyp - Ingen, OAuth2.0, Grundläggande autentisering, API-nyckel, Anpassad autentisering eller Ömsesidig autentisering - för att få åtkomst till RESTful-tjänsten och ange information för autentisering.

    Om du väljer API Key Ange värdet för API-nyckeln som autentiseringstyp. API-nyckeln kan skickas som en begäranderubrik eller som en frågeparameter. Välj ett av dessa alternativ på menyn Location nedrullningsbar lista och ange namnet på huvudet eller frågeparametern i Parameter Name i enlighet med detta.

    Om du väljer Mutual Authentication som autentiseringstyp, se Certifikatbaserad ömsesidig autentisering för RESTful- och SOAP-webbtjänster.

  4. Tryck Create för att skapa molnkonfigurationen för RESTful-tjänsten.

HTTP-klientkonfiguration för formulärdatamodell för optimering av prestanda

Experience Manager Forms formulärdatamodell vid integrering med RESTful-webbtjänster som datakälla inkluderar HTTP-klientkonfigurationer för prestandaoptimering.
Utför följande steg för att konfigurera HTTP-klienten för formulärdatamodellen:

  1. Logga in på Experience Manager Forms Skapa instans som administratör och gå till Experience Manager webbkonsolpaket. Standardwebbadressen är https://localhost:4502/system/console/configMgr.

  2. Tryck på Form Data Model Http Client Configuration for REST data source.

  3. I Form Data Model Http Client Configuration for REST data source dialog:

    • Ange maximalt antal tillåtna anslutningar mellan formulärdatamodell och RESTful-webbtjänster i dialogrutan Connection limit in total fält. Standardvärdet är 20 anslutningar.

    • Ange maximalt antal tillåtna anslutningar för varje flöde i dialogrutan Connection limit on per route basis fält. Standardvärdet är 2 anslutningar.

    • Ange hur länge en beständig HTTP-anslutning ska vara aktiv i Keep alive fält. Standardvärdet är 15 sekunder.

    • Ange varaktigheten som Experience Manager Forms servern väntar på att en anslutning ska upprättas i Connection timeout fält. Standardvärdet är 10 sekunder.

    • Ange den maximala tidsperioden för inaktivitet mellan två datapaket i Socket timeout fält. Standardvärdet är 30 sekunder.

Konfigurera SOAP-webbtjänster

SOAP-baserade webbtjänster beskrivs med WSDL-specifikationer (Web Services Description Language). Om du vill konfigurera en SOAP-baserad webbtjänst i AEM-molntjänster kontrollerar du att du har WSDL-webbadressen för webbtjänsten och gör följande:

  1. Gå till Tools > Cloud Services > Data Sources. Tryck för att välja den mapp där du vill skapa en molnkonfiguration.

    Se Konfigurera mapp för molntjänstkonfigurationer om du vill ha information om hur du skapar och konfigurerar en mapp för molntjänstkonfigurationer.

  2. Tryck Create för att öppna Create Data Source Configuration wizard. Ange ett namn och eventuellt en rubrik för konfigurationen, välj SOAP Web Service från Service Type nedrullningsbar meny, där du kan bläddra och välja en miniatyrbild för konfigurationen, och trycka på Next.

  3. Ange följande för SOAP-webbtjänsten:

    • WSDL-URL för webbtjänsten.

    • Tjänstslutpunkt. Ange ett värde i det här fältet om du vill åsidosätta tjänstslutpunkten som anges i WSDL.

    • Välj autentiseringstypen - Ingen, OAuth2.0, Grundläggande autentisering, Anpassad autentisering, X509-token eller Ömsesidig autentisering - för att få åtkomst till SOAP-tjänsten och ange därför informationen för autentisering.

      Om du väljer X509 Token som autentiseringstyp, konfigurera X509-certifikatet. Mer information finns i Konfigurera certifikat.
      Ange KeyStore-alias för X509-certifikatet i Key Alias fält. Ange tiden i sekunder tills autentiseringsbegäran är giltig i Time To Live fält. Du kan också välja att signera meddelandetexten eller tidsstämpelhuvudet eller båda.

      Om du väljer Mutual Authentication som autentiseringstyp, se Certifikatbaserad ömsesidig autentisering för RESTful- och SOAP-webbtjänster.

  4. Tryck Create för att skapa molnkonfigurationen för SOAP-webbtjänsten.

Konfigurera OData-tjänster

En OData-tjänst identifieras av tjänstens rot-URL. Om du vill konfigurera en OData-tjänst i AEM-molntjänster kontrollerar du att du har tjänstens rot-URL och gör följande:

OBSERVERA

Formulärdatamodellen stöder OData version 4.
Stegvisa anvisningar om hur du konfigurerar Microsoft Dynamics 365, online eller lokalt, finns i Konfiguration av Microsoft Dynamics OData.

  1. Gå till Tools > Cloud Services > Data Sources. Tryck för att välja den mapp där du vill skapa en molnkonfiguration.

    Se Konfigurera mapp för molntjänstkonfigurationer om du vill ha information om hur du skapar och konfigurerar en mapp för molntjänstkonfigurationer.

  2. Tryck Create för att öppna Create Data Source Configuration wizard. Ange ett namn och eventuellt en rubrik för konfigurationen, välj OData Service från Service Type nedrullningsbar meny, där du kan bläddra och välja en miniatyrbild för konfigurationen, och trycka på Next.

  3. Ange följande information för OData-tjänsten:

    • Tjänstens rot-URL för OData-tjänsten som ska konfigureras.
    • Välj autentiseringstyp - Ingen, OAuth2.0, Grundläggande autentisering eller Anpassad autentisering - för att få åtkomst till OData-tjänsten och ange därefter information för autentisering.
    OBSERVERA

    Du måste välja autentiseringstypen OAuth 2.0 om du vill ansluta till Microsoft Dynamics-tjänster med OData-slutpunkten som tjänstrot.

  4. Tryck Skapa för att skapa molnkonfigurationen för OData-tjänsten.

Certifikatbaserad ömsesidig autentisering för RESTful- och SOAP-webbtjänster

När du aktiverar ömsesidig autentisering för formulärdatamodell autentiserar både datakällan och AEM Server som kör formulärdatamodellen varandras identitet innan data delas. Du kan använda ömsesidig autentisering för REST- och SOAP-baserade anslutningar (datakällor). Så här konfigurerar du ömsesidig autentisering för en formulärdatamodell i din AEM Forms-miljö:

  1. Överför den privata nyckeln (certifikatet) till AEM Forms server. Så här överför du den privata nyckeln:
    1. Logga in på AEM Forms server som administratör.
    2. Navigera till Tools > Security > Users. Välj fd-cloudservice användare och knacka Properties.
    3. Öppna Keystore -fliken, expandera Add Private Key from KeyStore file , ladda upp KeyStore-filen, ange alias, lösenord och tryck Submit. Certifikatet överförs. Aliaset för den privata nyckeln anges i certifikatet och anges när certifikatet skapas.
  2. Överför förtroendecertifikat till Global Trust Store. Så här överför du certifikatet:
    1. Navigera till Tools > Security > Trust Store.
    2. Expandera Add Certificate from CER file alternativ, tryck Select Certificate File, ladda upp certifikatet och tryck på Submit.
  3. Konfigurera SOAP eller RESTful webbtjänster som datakälla och välj Mutual authentication som autentiseringstyp. Om du konfigurerar flera självsignerade certifikat för fd-cloudservice anger du namnet på certifikatets nyckelalias.

Nästa steg

Du har konfigurerat datakällorna. Därefter kan du skapa en formulärdatamodell eller, om du redan har skapat en formulärdatamodell utan en datakälla, associera den med de datakällor du just konfigurerade. Se Skapa formulärdatamodell för mer information.

På denna sida