DokumentationAEM 6.4Användarhandbok om Forms

Konfigurera datakällor configure-data-sources

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • User
CAUTION
AEM 6.4 har nått slutet på den utökade supporten och denna dokumentation är inte längre uppdaterad. Mer information finns i teknisk supportperiod. Hitta de versioner som stöds här.

Lär dig hur du konfigurerar olika typer av datakällor och använder dem för att skapa formulärdatamodeller.

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 och Oracle RDBMS
  • 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 configure-relational-database

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
    note note
    NOTE
    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.
    2. I Plain Text anger du lösenordet eller en sträng som ska krypteras och klickar 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 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]:[host]/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
    note note
    NOTE
    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 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 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 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 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 dialog. 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.
    • Välj autentiseringstyp - Ingen, OAuth2.0, Grundläggande autentisering, API-nyckel eller Anpassad autentisering - för att få åtkomst till RESTful-tjänsten och ange därefter information för autentisering.

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

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

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 dialog. 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 autentiseringstyp - Ingen, OAuth2.0, Grundläggande autentisering, Anpassad autentisering eller X509-token - för att få åtkomst till SOAP-tjänsten och ange därefter information för autentisering.

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

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

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
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 dialog. 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.
    note note
    NOTE
    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.

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

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da