Konfigurera datakällor configure-data-sources
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:
- Aktivera avancerade nätverk via molnhanterings-API, eftersom portar är inaktiverade som standard.
- Lägg till JDBC-drivrutinsberoenden i Maven.
Steg för att konfigurera en relationsdatabas
Du kan konfigurera relationsdatabaser med Experience Manager Konfiguration av webbkonsol. Gör följande:
-
Gå till Experience Manager webbkonsol på
https://server:host/system/console/configMgr
. -
Sök Day Commons JDBC Connections Pools konfiguration. Välj det här alternativet om du vill öppna konfigurationen i redigeringsläge.
-
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. -
-
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:
-
Gå till Tools > General > Configuration Browser.
- Se Konfigurationsläsaren mer information.
-
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.
-
I Configuration Browser väljer du
global
mapp och markera Properties. -
I Configuration Properties dialogruta, aktivera Cloud Configurations.
-
Välj Save & Close för att spara konfigurationen och stänga dialogrutan.
-
-
I Configuration Browser, markera Create.
-
I Create Configuration anger du en rubrik för mappen och aktiverar Cloud Configurations.
-
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
-
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.
-
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.
-
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.
-
-
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
-
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.
-
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.
-
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.
-
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"
}
-
Välj Form Data Model HTTP Client Configuration for REST data source.
-
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:
-
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.
-
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.
-
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.
-
-
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:
En steg-för-steg-guide för att konfigurera Microsoft®® Dynamics 365, online eller lokalt, se Microsoft® Dynamics OData-konfiguration.
-
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.
-
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.
-
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. -
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.