Konfigurera datakällor configure-data-sources

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

Dataintegrering

Experience Manager Forms Med dataintegrering kan du konfigurera och ansluta till olika datakällor. Följande typer stöds:

  • Relationsdatabaser - MySQL, Microsoft® SQL Server, IBM® DB2®, postgreSQL, och Oracle RDBMS
  • RESTful web services
  • SOAP-baserade webbtjänster
  • OData-tjänster (version 4.0)
  • Microsoft® Dynamics
  • SalesForce
  • Microsoft® Azure Blob Storage

Dataintegrering stöder OAuth2.0(Auktoriseringskod, Klientautentiseringsuppgifter), grundläggande autentisering och API-nyckelautentiseringstyper är körklara och tillåter implementering av anpassad autentisering för åtkomst till webbtjänster. SOAP-baserade tjänster och OData-tjänster är konfigurerade i RESTful Experience Manager as a Cloud Service, JDBC för relationsdatabaser och anslutningsprogram för Experience Manager användarprofilen är konfigurerad i Experience Manager webbkonsol.

Konfigurera relationsdatabas configure-relational-database

Förutsättningar

Innan du konfigurerar relationsdatabaser med Experience Manager Konfiguration av webbkonsol, det är obligatoriskt att:

Steg för att konfigurera en relationsdatabas

Du kan konfigurera relationsdatabaser med Experience Manager Konfiguration av webbkonsol. Gör följande:

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

  2. Sök Day Commons JDBC Connections Pools konfiguration. Välj det här alternativet om du vill öppna konfigurationen i redigeringsläge.

    JDBC Connector Pool

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

    • Java™-klassnamn för JDBC-drivrutinen

    • URI för JDBC-anslutning

    • Användarnamn och lösenord för anslutning till JDBC-drivrutinen

    • 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)
    • Datakällans namn

    Exempelsträngar för att konfigurera en relationsdatabas:

    code language-text
       "datasource.name": "sqldatasourcename-mysql",
       "jdbc.driver.class": "com.mysql.jdbc.Driver",
       "jdbc.connection.uri": "jdbc:mysql://$[env:AEM_PROXY_HOST;default=proxy.tunnel]:30001/sqldatasourcename"
    
    note note
    NOTE
    Se SQL-anslutningar med JDBC DataSourcePool för mer detaljerad information.
  4. Välj Save för att spara konfigurationen.

Nu kan du använda den konfigurerade relationsdatabasen med din formulärdatamodell.

Konfigurera mapp för molntjänstkonfigurationer cloud-folder

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 Experience Manager konsolideras i /conf mapp i Experience Manager databas. Som standard är conf mappen innehåller global mapp där du kan skapa molntjänstkonfigurationer. Du måste dock manuellt aktivera det 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 markera Properties.

    2. I Configuration Properties dialogruta, aktivera Cloud Configurations.

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

  3. I Configuration Browser, markera Create.

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

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

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

RESTful web services can description using Swagger-specifikationer i JSON- eller YAML-format i Swagger definitionsfil. Konfigurera RESTful-webbtjänsten i Experience Manager as a Cloud Service, se till att du har antingen Swagger fil (Swagger version 2.0) eller Swagger fil (Swagger version 3.0) i filsystemet eller den URL där filen finns.

Konfigurera RESTful-tjänster för Open API Specification version 2.0 configure-restful-services-open-api-2.0

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

    Se Konfigurera mapp för molntjänstkonfigurationer för information om hur du skapar och konfigurerar en 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 från Service Type nedrullningsbar meny där du kan bläddra och välja en miniatyrbild för konfigurationen och välja Next.

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

    • Välj en URL eller fil på menyn Swagger Source och ange Swagger URL till​ Swagger definitionsfil eller ladda upp Swagger från det lokala filsystemet.

    • Baserat på​ Swagger Källindata., följande fält är 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älla.

      • 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 autentiseringstyp - Ingen, OAuth2.0(Auktoriseringskod, Klientautentiseringsuppgifter), Basic Authentication, API Key eller Custom Authentication - för att få åtkomst till RESTful-tjänsten och ange därmed 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 efter behov.

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

Konfigurera RESTful-tjänster för Open API Specification version 3.0 configure-restful-services-open-api-3.0

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

    Se Konfigurera mapp för molntjänstkonfigurationer för information om hur du skapar och konfigurerar en 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 från Service Type nedrullningsbar meny där du kan bläddra och välja en miniatyrbild för konfigurationen och välja Next.

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

    • Välj en URL eller fil på menyn Swagger Source och ange Swagger 3.0 URL till​ Swagger definitionsfil eller ladda upp Swagger från det lokala filsystemet.
    • Baserat på​ Swagger Källindata, anslutningsinformationen med målservern visas.
    • Välj autentiseringstyp - Ingen, OAuth2.0(Auktoriseringskod, Klientautentiseringsuppgifter), Basic Authentication, API Key eller Custom Authentication - för att få åtkomst till RESTful-tjänsten och ange därmed 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 efter behov.

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

En del åtgärder som inte stöds av RESTful services Open API Specification version 3.0 är:

  • Återanrop
  • en/något av
  • Fjärrreferens
  • Länkar
  • Olika begärande organ för olika MIME-typer för en enda operation

Se OpenAPI 3.0-specifikation för detaljerad information.

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

Experience Manager Forms utgör en datamodell när den integreras med RESTful-webbtjänster eftersom datakällan innehåller HTTP-klientkonfigurationer för prestandaoptimering.

Ange följande egenskaper för Form Data Model HTTP Client Configuration for REST data source konfiguration som anger det reguljära uttrycket:

  • Använd http.connection.max.per.route -egenskap för att ange maximalt antal tillåtna anslutningar mellan formulärdatamodell och RESTful-webbtjänster. Standardvärdet är 20 anslutningar.

  • Använd http.connection.max egenskapen för att ange maximalt antal tillåtna anslutningar för varje flöde. Standardvärdet är 40 anslutningar.

  • Använd http.connection.keep.alive.duration egenskapen för att ange varaktigheten för vilken en beständig HTTP-anslutning hålls vid liv. Standardvärdet är 15 sekunder.

  • Använd http.connection.timeout egenskapen för att ange varaktigheten, för vilken Experience Manager Forms servern väntar på att en anslutning ska upprättas. Standardvärdet är 10 sekunder.

  • Använd http.socket.timeout för att ange den maximala tidsperioden för inaktivitet mellan två datapaket. Standardvärdet är 30 sekunder.

I följande JSON-fil visas ett exempel:

{
   "http.connection.keep.alive.duration":"15",
   "http.connection.max.per.route":"20",
   "http.connection.timeout":"10",
   "http.socket.timeout":"30",
   "http.connection.idle.connection.timeout":"15",
   "http.connection.max":"40"
}
  1. Välj Form Data Model HTTP Client Configuration for REST data source.

  2. I Form Data Model HTTP Client Configuration for REST data source dialog:

    • Ange maximalt antal tillåtna anslutningar mellan formulärdatamodellen 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 två 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 configure-soap-web-services

SOAP-baserade webbtjänster beskrivs med WSDL-specifikationer (Web Services Description Language). Experience Manager Forms stöder inte WSDL-modellen i RPC-format.

Konfigurera SOAP-baserad webbtjänst i Experience Manager as a Cloud Service, kontrollera 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.

    Se Konfigurera mapp för molntjänstkonfigurationer för information om hur du skapar och konfigurerar en 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 från Service Type nedrullningsbar meny där du kan bläddra och välja en miniatyrbild för konfigurationen och välja 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 autentiseringstyp - Ingen, OAuth2.0(Auktoriseringskod, Klientautentiseringsuppgifter), Basic Authentication eller Custom Authentication - för att få åtkomst till SOAP-tjänsten och därmed ange information för autentisering.

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

Aktivera användning av importsatser i SOAP-webbtjänster WSDL enable-import-statements

Du kan ange ett reguljärt uttryck som fungerar som filter för absoluta URL:er som tillåts som importsatser i SWDL för SOAP-webbtjänster. Som standard finns det inget värde i det här fältet. Detta resulterar i Experience Manager blockerar alla importsatser som är tillgängliga i WSDL. Om du anger .* som värdet i detta fält, Experience Manager tillåter alla importsatser.

Ange importAllowlistPattern egenskapen för Form Data Model SOAP Web Services Import Allowlist -konfiguration för att ange det reguljära uttrycket. I följande JSON-fil visas ett exempel:

{
  "importAllowlistPattern": ".*"
}

Så här anger du värden för en konfiguration: Generera OSGi-konfigurationer med AEM SDKoch distribuera konfigurationen till din Cloud Service.

Konfigurera OData-tjänster config-odata

En OData-tjänst identifieras av tjänstens rot-URL. Konfigurera en OData-tjänst i Experience Manager as a Cloud Service, kontrollera att du har tjänstens rot-URL och gör följande:

NOTE
Formulärdatamodellen stöder OData version 4.
En steg-för-steg-guide för att konfigurera Microsoft®® Dynamics 365, online eller lokalt, se Microsoft® Dynamics OData-konfiguration.
  1. Gå till Tools > Cloud Services > Data Sources. Välj den mapp där du vill skapa en molnkonfiguration.

    Se Konfigurera mapp för molntjänstkonfigurationer för information om hur du skapar och konfigurerar en 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 från Service Type nedrullningsbar meny där du kan bläddra och välja en miniatyrbild för konfigurationen och välja 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(Auktoriseringskod, Klientautentiseringsuppgifter), Basic Authentication, API Key eller Custom Authentication - för att få åtkomst till OData-tjänsten och därmed ange autentiseringsinformationen.

    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 efter behov.

    note note
    NOTE
    Välj autentiseringstypen OAuth 2.0 att ansluta till Microsoft®® Dynamics tjänster som använder OData-slutpunkten som tjänstrot.
  4. Välj Create för att skapa molnkonfigurationen för OData-tjänsten.

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. Se Skapa formulärdatamodell för mer information.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab