Gegevensbronnen configureren configure-data-sources

Versie
Artikelkoppeling
AEM 6,5
klik hier
AEM as a Cloud Service
Dit artikel

de integratie van Gegevens

Experience Manager Forms Met gegevensintegratie kunt u verschillende gegevensbronnen configureren en verbinden. De volgende typen worden buiten de box ondersteund:

  • Relationele databases - MySQL, Microsoft® SQL Server, IBM® DB2® , postgreSQL en Oracle RDBMS
  • RESTful-webservices
  • SOAP webservices
  • OData-diensten (versie 4.0)
  • Microsoft® Dynamics
  • Salesforce
  • Microsoft® Azure Blob Storage

De integratie van gegevens steunt OAuth2.0 ( Code van de Vergunning, de Verantwoordelijkheden van de Cliënt), Basisauthentificatie, en API Zeer belangrijke authentificatietypen uit-van-de-doos, en staat het uitvoeren van douaneauthentificatie voor de toegang tot van de Webdiensten toe. Terwijl RESTful, SOAP-gebaseerde, en OData de diensten in Experience Manager as a Cloud Service worden gevormd, worden JDBC voor relationele gegevensbestanden en schakelaar voor Experience Manager gebruikersprofiel gevormd in Experience Manager Webconsole.

Relationele database configureren configure-relational-database

Vereisten

Voordat u relationele databases configureert met gebruik van de Experience Manager webconsoleconfiguratie, moet u:

Stappen om een relationele database te configureren

U kunt relationele databases configureren met Experience Manager Web Console Configuration. Ga als volgt te werk:

  1. Ga naar Experience Manager webconsole op https://server:host/system/console/configMgr .

  2. Zoek Day Commons JDBC Connections Pools -configuratie. Selecteer deze optie om de configuratie te openen in de bewerkingsmodus.

    JDBC Connector Pool

  3. In de configuratiedialoog, specificeer de details voor het gegevensbestand u, zoals wilt vormen:

    • Java™-klassenaam voor het JDBC-stuurprogramma

    • URI voor JDBC-verbinding

    • Gebruikersnaam en wachtwoord voor verbinding met het JDBC-stuurprogramma

    • Geef een SQL SELECT-query op in het veld Validation Query om verbindingen vanuit de pool te valideren. De query moet ten minste één rij retourneren. Geef op basis van uw database een van de volgende opties op:

      • SELECT 1 (MySQL en MS® SQL)
      • SELECTEER 1 uit twee items (Oracle)
    • Naam van de gegevensbron

    Voorbeeldtekenreeksen voor het configureren van een relationele database:

    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
    Zie SQL verbindingen gebruikend JDBC DataSourcePoolvoor meer gedetailleerde informatie.
  4. Selecteer Save om de configuratie op te slaan.

Nu, kunt u het gevormde relationele gegevensbestand met uw Model van de Gegevens van het Vorm (FDM) gebruiken.

Map configureren voor configuraties van cloudservices cloud-folder

Configuratie voor map met cloudservices is vereist voor het configureren van cloudservices voor RESTful-, SOAP- en OData-services.

Alle configuraties van de cloudservice in Experience Manager worden geconsolideerd in de /conf -map in de Experience Manager -opslagplaats. Standaard bevat de map conf de map global waarin u cloudserviceconfiguraties kunt maken. U moet deze optie echter handmatig inschakelen voor cloudconfiguraties. U kunt ook extra mappen maken in conf om configuraties voor cloudservices te maken en in te delen.

De map configureren voor configuraties van cloudservices:

  1. Ga naar Tools > General > Configuration Browser .

    • Zie Browser van de Configuratie 🔗 documentatie 0} {voor meer informatie.
  2. Ga als volgt te werk om de algemene map voor cloudconfiguraties in te schakelen of sla deze stap over om een andere map voor cloudserviceconfiguraties te maken en te configureren.

    1. Selecteer in Configuration Browser de map global en selecteer Properties .

    2. Schakel Cloud Configurations in het dialoogvenster Configuration Properties in.

    3. Selecteer Save & Close om de configuratie op te slaan en het dialoogvenster af te sluiten.

  3. Selecteer Create in de Configuration Browser .

  4. Geef in het dialoogvenster Create Configuration een titel op voor de map en schakel Cloud Configurations in.

  5. Selecteer Create om de map te maken die is ingeschakeld voor cloudserviceconfiguraties.

RESTful-webservices configureren configure-restful-web-services

De RESTful Webdiensten kunnen worden beschreven gebruikend specificaties van de Waggerin formaat JSON of YAML in a Swagger definitiedossier. Om RESTful Webdienst in Experience Manager as a Cloud Service te vormen, zorg ervoor dat u of het Swagger dossier ( Versie 2.0 van de Tagger) of Swagger dossier ( Versie van de Wagger 3.0) op uw dossiersysteem of URL hebt waar het dossier wordt ontvangen.

RESTful-services configureren voor Open API Specification versie 2.0 configure-restful-services-open-api-2.0

  1. Ga naar Tools > Cloud Services > Data Sources . Selecteer deze optie om de map te selecteren waarin u een cloudconfiguratie wilt maken.

    Zie omslag voor de configuraties van de wolkendienstvoor informatie over het creëren van en het vormen van een omslag voor de configuraties van de wolkendienst vormen.

  2. Selecteer Create om Create Data Source Configuration wizard te openen. Geef een naam en eventueel een titel voor de configuratie op, selecteer RESTful Service in de vervolgkeuzelijst Service Type , blader optioneel naar een miniatuurafbeelding en selecteer een miniatuurafbeelding voor de configuratie en selecteer Next .

  3. Specificeer de volgende details voor de RESTful dienst:

    • Selecteer een URL of een Dossier van Swagger Source drop-down, en specificeer dienovereenkomstig Swagger URL aan het ​ Swagger definitiedossier of upload het Swagger dossier van uw lokaal dossiersysteem.

    • Gebaseerd op de ​ Swagger input van Source., zijn de volgende gebieden pre-bevolkt met waarden:

      • Schema: de overdrachtprotocollen die door de REST API worden gebruikt. Het aantal schematypen dat in de drop-down lijst wordt getoond hangt van de regelingen af die in de Swagger bron worden bepaald.
      • Host: de domeinnaam of het IP-adres van de host die de REST API aanbiedt. Het is een verplicht veld.
      • Basispad: het URL-voorvoegsel voor alle API-paden. Het is een optioneel veld.
        Bewerk indien nodig de vooraf ingevulde waarden voor deze velden.
    • Selecteer het authentificatietype — niets, OAuth2.0 ( Code van de Vergunning, de Verantwoordelijkheden van de Cliënt), BasisAuthentificatie, API Sleutel, of de Authentificatie van de Douane — om tot de RESTful dienst toegang te hebben, en dienovereenkomstig details voor authentificatie te verstrekken.

    Als u API Key selecteert als verificatietype, geeft u de waarde voor de API-sleutel op. De API-sleutel kan als aanvraagheader of als queryparameter worden verzonden. Selecteer een van deze opties in de vervolgkeuzelijst Location en geef de naam van de header of de queryparameter dienovereenkomstig op in het veld Parameter Name .

  4. Selecteer Create om de wolkenconfiguratie voor de RESTful dienst tot stand te brengen.

RESTful-services configureren voor Open API Specification versie 3.0 configure-restful-services-open-api-3.0

  1. Ga naar Tools > Cloud Services > Data Sources . Selecteer deze optie om de map te selecteren waarin u een cloudconfiguratie wilt maken.

    Zie omslag voor de configuraties van de wolkendienstvoor informatie over het creëren van en het vormen van een omslag voor de configuraties van de wolkendienst vormen.

  2. Selecteer Create om Create Data Source Configuration wizard te openen. Geef een naam en eventueel een titel voor de configuratie op, selecteer RESTful Service in de vervolgkeuzelijst Service Type , blader optioneel naar een miniatuurafbeelding en selecteer een miniatuurafbeelding voor de configuratie en selecteer Next .

  3. Specificeer de volgende details voor de RESTful dienst:

    • Selecteer een URL of een Dossier van Swagger Source drop-down, en specificeer dienovereenkomstig Swagger 3.0 URL aan het ​ Swagger definitiedossier of upload het Swagger dossier van uw lokaal dossiersysteem.
    • Gebaseerd op de ​ Swagger input van Source, wordt de verbindingsinformatie met de doelserver getoond.
    • Selecteer het authentificatietype — niets, OAuth2.0 ( Code van de Vergunning, de Verantwoordelijkheden van de Cliënt), BasisAuthentificatie, API Sleutel, of de Authentificatie van de Douane — om tot de RESTful dienst toegang te hebben, en dienovereenkomstig details voor authentificatie te verstrekken.

    Als u API Key selecteert als verificatietype, geeft u de waarde voor de API-sleutel op. De API-sleutel kan als aanvraagheader of als queryparameter worden verzonden. Selecteer een van deze opties in de vervolgkeuzelijst Location en geef de naam van de header of de queryparameter dienovereenkomstig op in het veld Parameter Name .

  4. Selecteer Create om de wolkenconfiguratie voor de RESTful dienst tot stand te brengen.

Sommige bewerkingen die niet worden ondersteund door RESTful-services Open API Specification versie 3.0 zijn:

  • Callbacks
  • één of meer
  • Externe referentie
  • Koppelingen
  • Verschillende aanvraagorganen voor verschillende MIME-typen voor één enkele bewerking

Zie 3.0 Specificatie OpenAPIvoor gedetailleerde informatie.

De cliëntconfiguratie van HTTP van het het gegevensmodel van de vorm (FDM) om prestaties te optimaliseren fdm-http-client-configuration

Experience Manager Forms vormen een gegevensmodel wanneer het integreren met RESTful Webdiensten aangezien de gegevensbron de cliëntconfiguraties van HTTP voor prestatiesoptimalisering omvat.

Stel de volgende eigenschappen van de Form Data Model HTTP Client Configuration for REST data source -configuratie in om de reguliere expressie op te geven:

  • Gebruik de eigenschap http.connection.max.per.route om het maximum aantal toegestane verbindingen tussen het formuliergegevensmodel (FDM) en RESTful-webservices in te stellen. De standaardwaarde is 20 verbindingen.

  • Gebruik de eigenschap http.connection.max om het maximum aantal toegestane verbindingen voor elke route op te geven. De standaardwaarde is 40 verbindingen.

  • Gebruik de eigenschap http.connection.keep.alive.duration om de duur op te geven waarvoor een blijvende HTTP-verbinding in leven blijft. De standaardwaarde is 15 seconden.

  • Gebruik de eigenschap http.connection.timeout om de duur op te geven waarvoor de Experience Manager Forms -server wacht tot een verbinding tot stand is gebracht. De standaardwaarde is 10 seconden.

  • Gebruik de eigenschap http.socket.timeout om de maximale tijdsperiode voor inactiviteit tussen twee gegevenspakketten op te geven. De standaardwaarde is 30 seconden.

In het volgende JSON-bestand wordt een voorbeeld weergegeven:

{
   "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. Selecteer Form Data Model HTTP Client Configuration for REST data source .

  2. In het dialoogvenster Form Data Model HTTP Client Configuration for REST data source :

    • Geef het maximale aantal toegestane verbindingen op tussen het formuliergegevensmodel (FDM) en de RESTful-webservices in het veld Connection limit in total . De standaardwaarde is 20 verbindingen.

    • Geef het maximale aantal toegestane verbindingen voor elke route op in het veld Connection limit on per route basis . De standaardwaarde is twee verbindingen.

    • Geef in het veld Keep alive de duur op waarvoor een permanente HTTP-verbinding in leven blijft. De standaardwaarde is 15 seconden.

    • Geef in het veld Connection timeout de tijdsduur op waarvoor de Experience Manager Forms -server wacht tot een verbinding tot stand is gebracht. De standaardwaarde is 10 seconden.

    • Geef in het veld Socket timeout de maximale periode voor inactiviteit op tussen twee gegevenspakketten. De standaardwaarde is 30 seconden.

Webservices configureren SOAP configure-soap-web-services

Op SOAP gebaseerde Webdiensten worden beschreven gebruikend {de specificaties van de Beschrijving van de Diensten van het Web van 0} van de Taal (WSDL) 🔗. Experience Manager Forms biedt geen ondersteuning voor het WSDL-model in RPC-stijl.

Als u in Experience Manager as a Cloud Service op SOAP gebaseerde webservice wilt configureren, controleert u of u de WSDL-URL voor de webservice hebt en voert u de volgende handelingen uit:

  1. Ga naar Tools > Cloud Services > Data Sources . Selecteer deze optie om de map te selecteren waarin u een cloudconfiguratie wilt maken.

    Zie omslag voor de configuraties van de wolkendienstvoor informatie over het creëren van en het vormen van een omslag voor de configuraties van de wolkendienst vormen.

  2. Selecteer Create om Create Data Source Configuration wizard te openen. Geef een naam en eventueel een titel voor de configuratie op, selecteer SOAP Web Service in de vervolgkeuzelijst Service Type , blader optioneel naar een miniatuurafbeelding en selecteer een miniatuurafbeelding voor de configuratie en selecteer Next .

  3. Geef het volgende op voor de SOAP webservice:

    • WSDL-URL voor de webservice.

    • Service Endpoint. Specificeer een waarde op dit gebied om het de diensteindpunt met voeten te treden dat in WSDL wordt vermeld.

    • Selecteer het authentificatietype — niets, OAuth2.0 ( Code van de Vergunning, de Verantwoordelijkheden van de Cliënt), BasisAuthentificatie, of de Authentificatie van de Douane — om tot de SOAP dienst toegang te hebben, en dienovereenkomstig de details voor authentificatie te verstrekken.

  4. Selecteer Create om de cloudconfiguratie voor de SOAP webservice te maken.

Het gebruik van importinstructies in SOAP webservices WSDL inschakelen enable-import-statements

U kunt een reguliere expressie opgeven die fungeert als filter voor absolute URL's die zijn toegestaan als importinstructies in SOAP WSDL voor webservices. Standaard is er geen waarde in dit veld. Hierdoor blokkeert Experience Manager alle importinstructies die beschikbaar zijn in WSDL. Als u .* opgeeft als waarde in dit veld, staat Experience Manager alle instructies import toe.

Stel de eigenschap importAllowlistPattern van de Form Data Model SOAP Web Services Import Allowlist -configuratie in om de reguliere expressie op te geven. In het volgende JSON-bestand wordt een voorbeeld weergegeven:

{
  "importAllowlistPattern": ".*"
}

Om waarden van een configuratie te plaatsen, produceer OSGi Configuraties gebruikend de AEM SDK, en stel de configuratieaan uw instantie van de Cloud Service op.

OData-services configureren config-odata

De dienst OData wordt geïdentificeerd door zijn de dienstwortel URL. Als u een OData-service in Experience Manager as a Cloud Service wilt configureren, moet u ervoor zorgen dat u over de servicebasis-URL voor de service beschikt en moet u het volgende doen:

NOTE
Het gegevensmodel van de vorm (FDM) steunt OData versie 4.
Voor een geleidelijke gids om Microsoft®® Dynamics 365, online of op-gebouw te vormen, zie Microsoft® Dynamics Configuratie OData.
  1. Ga naar Tools > Cloud Services > Data Sources . Selecteer deze optie om de map te selecteren waarin u een cloudconfiguratie wilt maken.

    Zie omslag voor de configuraties van de wolkendienstvoor informatie over het creëren van en het vormen van een omslag voor de configuraties van de wolkendienst vormen.

  2. Selecteer Create om Create Data Source Configuration wizard te openen. Geef een naam en eventueel een titel voor de configuratie op, selecteer OData Service in de vervolgkeuzelijst Service Type , blader optioneel naar een miniatuurafbeelding en selecteer een miniatuurafbeelding voor de configuratie en selecteer Next .

  3. Specificeer de volgende details voor de dienst OData:

    • Service Root URL voor de OData-service die moet worden geconfigureerd.
    • Selecteer het authentificatietype — niets, OAuth2.0 ( de Code van de Vergunning, de Verantwoordelijkheden van de Cliënt), BasisAuthentificatie, Sleutel API, of de Authentificatie van de Douane — om tot de dienst toegang te hebben OData, en dienovereenkomstig de details voor authentificatie te verstrekken.

    Als u API Key selecteert als verificatietype, geeft u de waarde voor de API-sleutel op. De API-sleutel kan als aanvraagheader of als queryparameter worden verzonden. Selecteer een van deze opties in de vervolgkeuzelijst Location en geef de naam van de header of de queryparameter dienovereenkomstig op in het veld Parameter Name .

    note note
    NOTE
    Selecteer het OAuth 2.0 authentificatietype om met Microsoft®® Dynamics diensten te verbinden gebruikend het eindpunt OData als de dienstwortel.
  4. Selecteer Create om de wolkenconfiguratie voor de dienst te creëren OData.

Volgende stappen next-steps

U hebt de gegevensbronnen geconfigureerd. Vervolgens kunt u een FDM (Form Data Model) maken of als u al een FDM (Form Data Model) zonder gegevensbron hebt gemaakt, kunt u dit koppelen aan de gegevensbronnen die u hebt geconfigureerd. Zie het model van vormgegevensvoor details creëren.

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