DokumentationAEM as a Cloud ServiceAnvändarhandbok

Konfigurera datakällor configure-data-sources

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

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

Dataintegrering

Med dataintegrering i Experience Manager Forms 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 webbtjänster
  • OData-tjänster (version 4.0)
  • Microsoft® Dynamics
  • SalesForce
  • Microsoft® Azure Blob Storage

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 har konfigurerats i Experience Manager as a Cloud Service konfigureras JDBC för relationsdatabaser och koppling för användarprofilen Experience Manager i webbkonsolen Experience Manager.

Konfigurera relationsdatabas configure-relational-database

Förutsättningar

Innan du konfigurerar relationsdatabaser med hjälp av webbkonsolkonfigurationen i Experience Manager måste du:

Steg för att konfigurera en relationsdatabas

Du kan konfigurera relationsdatabaser med hjälp av webbkonsolkonfigurationen för Experience Manager. Gör följande:

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

  2. Leta reda på konfigurationen för Day Commons JDBC Connections Pools. Välj det här alternativet om du vill öppna konfigurationen i redigeringsläge.

    JDBC-kopplingspool

  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 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)

    • 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
    Mer information finns i SQL-anslutningar med JDBC DataSourcePool.

  4. Välj Save om du vill spara konfigurationen.

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

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 mappen /conf i databasen Experience Manager. Mappen conf innehåller som standard mappen global där du kan skapa molntjänstkonfigurationer. Du måste dock manuellt aktivera det 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. Ange en rubrik för mappen i dialogrutan Create Configuration och aktivera 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änster kan beskrivas med Swagger-specifikationer i JSON- eller YAML-format i en Swagger -definitionsfil. Om du vill konfigurera RESTful-webbtjänsten i Experience Manager as a Cloud Service måste du ha antingen filen Swagger (Swagger Version 2.0) eller filen Swagger (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.

    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 en URL eller fil i listrutan Swagger Source och ange därför Swagger URL till definitionsfilen ​ Swagger eller överför filen Swagger 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 den nedrullningsbara listan beror på scheman som definierats i källan Swagger.
      • 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 eller Anpassad autentisering - för att få åtkomst till RESTful-tjänsten och ange därmed 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.

  4. Välj Create om du vill 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.

    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 en URL eller fil i listrutan Swagger Source och ange därför Swagger 3.0 URL till definitionsfilen ​ Swagger eller överför filen Swagger från det lokala filsystemet.
    • Baserat på indata från ​ Swagger Source visas anslutningsinformationen med målservern.
    • Välj autentiseringstypen - Ingen, OAuth2.0(Auktoriseringskod, Klientautentiseringsuppgifter), Grundläggande autentisering, API-nyckel eller Anpassad autentisering - för att få åtkomst till RESTful-tjänsten och ange därmed 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.

  4. Välj Create om du vill 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

Mer information finns i OpenAPI 3.0-specifikationen.

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

Experience Manager Forms utgör en datamodell när de integreras med RESTful-webbtjänster som datakälla, och innehåller HTTP-klientkonfigurationer för prestandaoptimering.

Ange följande egenskaper för konfigurationen Form Data Model HTTP Client Configuration for REST data source för att ange det reguljära uttrycket:

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

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

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

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

  • Använd egenskapen 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 dialogrutan Form Data Model HTTP Client Configuration for REST data source:

    • Ange maximalt antal tillåtna anslutningar mellan formulärdatamodellen (FDM) 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 två 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). Experience Manager Forms stöder inte WSDL-modellen av RPC-typ.

Om du vill konfigurera en SOAP webbtjänst i Experience Manager as a Cloud Service 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 autentiseringstyp - Ingen, OAuth2.0(Auktoriseringskod, Klientautentiseringsuppgifter), Grundläggande autentisering eller Anpassad autentisering - för att få åtkomst till SOAP och ange därefter information för autentisering.

  4. Välj Create om du vill skapa molnkonfigurationen för SOAP webbtjänst.

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 import-satser SOAP webbtjänstens WSDL. Som standard finns det inget värde i det här fältet. Därför blockerar Experience Manager alla importsatser som är tillgängliga i WSDL. Om du anger .* som värde i det här fältet tillåter Experience Manager alla importsatser.

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

{
  "importAllowlistPattern": ".*"
}

Generera OSGi-konfigurationer med AEM SDK och distribuera konfigurationen till din Cloud Service om du vill ange värden för en konfiguration.

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 Experience Manager as a Cloud Service kontrollerar du att du har tjänstens rot-URL och gör följande:

NOTE
Formulärdatamodellen (FDM) stöder OData version 4.
En steg-för-steg-guide om hur du konfigurerar Microsoft®® Dynamics 365, online eller lokalt, finns i Microsoft® Dynamics OData-konfiguration.

  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, API-nyckel eller Anpassad autentisering - för att få åtkomst till OData-tjänsten och ange därför informationen 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.

    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 Create om du vill 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 (FDM) eller, om du redan har skapat en formulärdatamodell (FDM) utan en datakälla, associera den med de datakällor du konfigurerade. Mer information finns i Skapa formulärdatamodell.

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