Konfigurera datakällor configure-data-sources

Version
Artikellänk
AEM as a Cloud Service
Klicka här
AEM 6.5
Den här artikeln

Dataintegrering

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, postgreSQL och Sybase
  • AEM användarprofil
  • RESTful web services
  • SOAP webbtjänster
  • OData-tjänster

Dataintegrering har stöd för autentiseringstyperna OAuth2.0(Auktoriseringskod, Klientautentiseringsuppgifter), Grundläggande autentisering och API-nyckelautentisering som är körklara och tillåter implementering av anpassad autentisering för åtkomst till webbtjänster. Medan RESTful-, SOAP- och OData-tjänster konfigureras i AEM Cloud Service konfigureras JDBC för relationsdatabaser och koppling för AEM användarprofil i AEM webbkonsol.

Konfigurera relationsdatabas configure-relational-database

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

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

  2. Leta efter Apache Sling Connection Pooled DataSource-konfiguration. Välj det här alternativet om du vill ö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
    note note
    NOTE
    Kontrollera att du krypterar känslig information, t.ex. lösenord, innan du konfigurerar datakällan. Kryptera:
    1. Gå till https://'[server]:[port]'/system/console/crypto.
    2. I fältet Plain Text anger du lösenordet eller en sträng som ska krypteras och väljer 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 SELECT-fråga (SQL) i fältet Validation Query om du vill 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. Välj Save om du vill spara konfigurationen.

    note note
    NOTE
    Om din Forms datamodell innehåller ett objekt som är ett reserverat nyckelord för relationsdatabasen kan det leda till problem med tillägg, uppdatering eller hämtning av data. Undvik därför att använda sådana objekt i formulärdatamodellen.

Konfigurera AEM användarprofil configure-aem-user-profile

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. Leta efter AEM Forms Data Integrations - User Profile Connector Configuration och välj 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 är 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
    note note
    NOTE
    * i ovanstående exempel betecknar alla noder under noden profile/empLocation/ i AEM användarprofil i CRXDE-strukturen. Det betyder att formulärdatamodellen har åtkomst till egenskapen city av typen string som finns i en nod under noden profile/empLocation/. Noderna som innehåller den angivna egenskapen måste dock följa en konsekvent struktur.
  4. Välj Save om du vill spara konfigurationen.

Konfigurera mapp för molntjänstkonfigurationer cloud-folder

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

Alla molntjänstkonfigurationer i AEM konsolideras i mappen /conf i AEM. Mappen conf innehåller som standard mappen global där du kan skapa molntjänstkonfigurationer. Du måste dock manuellt aktivera den för molnkonfigurationer. Du kan också 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 markerar du mappen global och väljer Properties.

    2. Aktivera Cloud Configurations i dialogrutan Configuration Properties.

    3. Välj Save & Close om du vill spara konfigurationen och stänga dialogrutan.

  3. I Configuration Browser väljer du Create.

  4. I dialogrutan Create Configuration anger du en rubrik för mappen och aktiverar Cloud Configurations.

  5. Välj Create om du vill skapa den mapp som är aktiverad för molntjänstkonfigurationer.

Konfigurera RESTful-webbtjänster configure-restful-web-services

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 se till att du antingen har 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. Välj den mapp där du vill skapa en molnkonfiguration.

    Mer information om hur du skapar och konfigurerar en mapp för molntjänstkonfigurationer finns i Konfigurera mapp för molntjänstkonfigurationer.

  2. Välj Create för att öppna Create Data Source Configuration wizard. Ange ett namn och eventuellt en rubrik för konfigurationen, välj RESTful Service i listrutan Service Type, bläddra och välj en miniatyrbild för konfigurationen och välj Next.

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

    • Välj URL eller Fil i listrutan Swagger Source 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 är följande fält förifyllda 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.
      • Bassö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 autentiseringstypen - Ingen, OAuth2.0(Auktoriseringskod, Klientautentiseringsuppgifter), 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 som autentiseringstyp anger du värdet för API-nyckeln. API-nyckeln kan skickas som en begäranderubrik eller som en frågeparameter. Välj något av dessa alternativ i listrutan Location och ange namnet på huvudet eller frågeparametern i fältet 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. Välj Create om du vill skapa molnkonfigurationen för RESTful-tjänsten.

HTTP-klientkonfiguration för formulärdatamodell för optimering av prestanda fdm-http-client-configuration

Experience Manager Forms formulärdatamodell vid integrering med RESTful-webbtjänster som datakälla innehåller HTTP-klientkonfigurationer för prestandaoptimering.
Utför följande steg för att konfigurera HTTP-klientmodellen för formulärdata:

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

  2. Välj Form Data Model Http Client Configuration for REST data source.

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

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

    • Ange maximalt antal tillåtna anslutningar för varje väg i fältet Connection limit on per route basis. Standardvärdet är 2 anslutningar.

    • Ange varaktigheten, för vilken en beständig HTTP-anslutning hålls aktiv, i fältet Keep alive. Standardvärdet är 15 sekunder.

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

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

Konfigurera SOAP webbtjänster configure-soap-web-services

SOAP webbtjänster beskrivs med hjälp av WSDL-specifikationerna (Web Services Description Language). Om du vill konfigurera SOAP webbtjänst i AEM molntjänster kontrollerar du att du har WSDL-URL:en för webbtjänsten och gör följande:

  1. Gå till Tools > Cloud Services > Data Sources. Välj den mapp där du vill skapa en molnkonfiguration.

    Mer information om hur du skapar och konfigurerar en mapp för molntjänstkonfigurationer finns i Konfigurera mapp för molntjänstkonfigurationer.

  2. Välj 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 i listrutan Service Type, bläddra och välj en miniatyrbild för konfigurationen och välj Next.

  3. Ange följande för SOAP webbtjänst:

    • 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(Auktoriseringskod, Klientautentiseringsuppgifter), Grundläggande autentisering, Anpassad autentisering, X509-token eller Ömsesidig autentisering - för att få åtkomst till den SOAP tjänsten och ange autentiseringsuppgifterna i enlighet med detta.

      Om du väljer X509 Token som autentiseringstyp konfigurerar du X509-certifikatet. Mer information finns i Konfigurera certifikat.
      Ange KeyStore-alias för X509-certifikatet i fältet Key Alias. Ange i sekunder tiden tills autentiseringsbegäran fortsätter att gälla i fältet Time To Live. 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. Välj Create om du vill skapa molnkonfigurationen för SOAP webbtjänst.

Konfigurera OData-tjänster config-odata

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:

NOTE
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. Välj den mapp där du vill skapa en molnkonfiguration.

    Mer information om hur du skapar och konfigurerar en mapp för molntjänstkonfigurationer finns i Konfigurera mapp för molntjänstkonfigurationer.

  2. Välj Create för att öppna Create Data Source Configuration wizard. Ange ett namn och eventuellt en rubrik för konfigurationen, välj OData Service i listrutan Service Type, bläddra och välj en miniatyrbild för konfigurationen och välj 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 autentiseringstypen - Ingen, OAuth2.0(Auktoriseringskod, Klientautentiseringsuppgifter), Grundläggande autentisering eller Anpassad autentisering - för att få åtkomst till OData-tjänsten och ange därför informationen för autentisering.
    note note
    NOTE
    Välj autentiseringstypen OAuth 2.0 om du vill ansluta till Microsoft Dynamics-tjänster med OData-slutpunkten som tjänstrot.
  4. Välj Skapa om du vill skapa molnkonfigurationen för OData-tjänsten.

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

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 servern AEM Forms. Så här överför du den privata nyckeln:

    1. Logga in på din AEM Forms-server som administratör.
    2. Navigera till Tools > Security > Users. Markera användaren fd-cloudservice och välj Properties.
    3. Öppna fliken Keystore, utöka alternativet Add Private Key from KeyStore file, ladda upp KeyStore-filen, ange alias, lösenord och välj 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 alternativet Add Certificate from CER file, välj Select Certificate File, överför certifikatet och välj Submit.
  3. Konfigurera webbtjänsterna SOAP eller RESTful som datakälla och välj Mutual authentication som autentiseringstyp. Om du konfigurerar flera självsignerade certifikat för användaren fd-cloudservice anger du certifikatets nyckelalias.

Nästa steg next-steps

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 konfigurerade. Mer information finns i Skapa formulärdatamodell.

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