Gegevensbronnen configureren configure-data-sources

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

de Integratie van Gegevens

Met AEM Forms Data Integration kunt u verschillende gegevensbronnen configureren en verbinden. De volgende types worden gesteund uit-van-de-doos. Met weinig aanpassing kunt u echter ook andere gegevensbronnen integreren.

  • Relationele databases - MySQL, Microsoft SQL Server, IBM DB2, Oracle RDBMS, postgreSQL en Sybase
  • Gebruikersprofiel AEM
  • RESTful-webservices
  • SOAP webservices
  • OData-diensten

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, op SOAP-Gebaseerd, en de diensten OData in AEM Cloud Servicen worden gevormd, wordt JDBC voor relationele gegevensbestanden en schakelaar voor AEM gebruikersprofiel gevormd in AEM Webconsole.

Relationele database configureren configure-relational-database

U kunt relationele gegevensbestanden vormen gebruikend AEM de Configuratie van de Console van het Web. Ga als volgt te werk:

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

  2. Zoek naar Apache Sling Connection Pooled DataSource configuratie. Selecteer deze optie om de configuratie te openen in de bewerkingsmodus.

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

    • Naam van de gegevensbron
    • Het bezit van de gegevensbrondienst dat de naam van de gegevensbron opslaat
    • Java-klassenaam voor het JDBC-stuurprogramma
    • URI voor JDBC-verbinding
    • Gebruikersnaam en wachtwoord voor verbinding met het JDBC-stuurprogramma
    note note
    NOTE
    Zorg ervoor dat u gevoelige informatie zoals wachtwoorden codeert alvorens de gegevensbron te vormen. Coderen:
    1. Ga naar https://' [ server ]:[ haven ]'/system/console/crypto.
    2. Geef in het veld Plain Text het wachtwoord of een willekeurige tekenreeks op die u wilt versleutelen en selecteer Protect .
    De gecodeerde tekst wordt weergegeven in het veld Beveiligde tekst dat u in de configuratie kunt opgeven.
  4. Schakel Test on Borrow of Test on Return in om op te geven dat de objecten worden gevalideerd voordat ze van en naar de pool worden geleend of geretourneerd.

  5. 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)
  6. Selecteer Save om de configuratie op te slaan.

    note note
    NOTE
    Als uw Forms-gegevensmodel een object bevat dat een gereserveerd trefwoord is voor uw relationele database, kan dit leiden tot problemen met het toevoegen, bijwerken of ophalen van gegevens. Vermijd dus het gebruik van dergelijke objecten in uw formuliergegevensmodel.

Gebruikersprofiel AEM configureren configure-aem-user-profile

U kunt AEM gebruikersprofiel vormen gebruikend de Configuratie van de Verbinding van het Profiel van de Gebruiker in AEM Console van het Web. Ga als volgt te werk:

  1. Ga naar AEM Webconsole in https://' [ server ]:[ haven ] systeem/console/configMgr.

  2. Zoek AEM Forms Data Integrations - User Profile Connector Configuration en selecteer om de configuratie in Edit wijze te openen.

  3. In het dialoogvenster Configuratie gebruikersprofiel-aansluiting kunt u eigenschappen van gebruikersprofielen toevoegen, verwijderen of bijwerken. De opgegeven eigenschappen zijn beschikbaar voor gebruik in het formuliergegevensmodel. Gebruik de volgende indeling om gebruikersprofieleigenschappen op te geven:

    name=[property_name_with_location_in_user_profile],type=[property_type]

    Voorbeelden:

    • name=profile/phoneNumber,type=string
    • name=profile/empLocation/*/city,type=string
    note note
    NOTE
    In het bovenstaande voorbeeld geeft * alle knooppunten onder het knooppunt profile/empLocation/ in AEM gebruikersprofiel in de CRXDE-structuur aan. Dit betekent dat het formuliergegevensmodel toegang heeft tot de eigenschap city van het type string in elk knooppunt onder het knooppunt profile/empLocation/ . Nochtans, moeten de knopen die het gespecificeerde bezit bevatten een verenigbare structuur volgen.
  4. Selecteer Save om de configuratie op te slaan.

Map configureren voor configuraties van cloudservices cloud-folder

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

Alle configuraties van de cloudservice in AEM worden geconsolideerd in de map /conf in AEM 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 Webdienst kan worden beschreven gebruikend de specificaties van de Waggerin formaat JSON of YAML in een de definitiedossier van de Wagger. Als u de RESTful-webservice in AEM cloudservices wilt configureren, dient u ervoor te zorgen dat het Swagger-bestand zich op uw bestandssysteem bevindt of de URL waar het bestand wordt gehost.

Doe het volgende de diensten RESTful vormen:

  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 URL of Dossier van Swagger Source drop-down, en specificeer dienovereenkomstig Swagger URL aan het de definitiedossier van de Swagger of upload het dossier van de Swagger van uw lokaal dossiersysteem.

    • Op basis van de invoer van Swagger Source worden de volgende velden vooraf gevuld met waarden:

      • Schema: de overdrachtprotocollen die door de REST API worden gebruikt. Het aantal schematypen die in de drop-down lijst worden getoond hangt van de regelingen af die in de bron van de Swagger 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, Sleutel API, Douane Authentificatie, of Wederzijdse Authentificatie — 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 .

    Als u Mutual Authentication als authentificatietype selecteert, zie Op certificaat-gebaseerde wederzijdse authentificatie voor RESTful en SOAP Webdiensten.

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

Het model van de gegevens van de vormHTTP cliëntconfiguratie om prestaties te optimaliseren fdm-http-client-configuration

Experience Manager Forms -formuliergegevensmodel wanneer integratie met RESTful-webservices als gegevensbron HTTP-clientconfiguraties bevat voor optimalisatie van prestaties.
Voer de volgende stappen uit om de HTTP-client van het formuliergegevensmodel te configureren:

  1. Meld u aan bij Experience Manager Forms Instantie auteur als beheerder en ga naar Experience Manager -bundels voor webconsoles. Het gebrek URL is https://localhost:4502/system/console/configMgr.

  2. Selecteer Form Data Model Http Client Configuration for REST data source .

  3. In het dialoogvenster Form Data Model Http Client Configuration for REST data source :

    • Geef het maximale aantal toegestane verbindingen op tussen het gegevensmodel van het formulier 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 2 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) 🔗. Als u op SOAP gebaseerde webservice wilt configureren in AEM cloudservices, moet u de WSDL-URL voor de webservice hebben en het volgende doen:

  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, de Authentificatie van de Douane, Symbolische X509, of Wederzijdse Authentificatie — om tot de SOAP dienst toegang te hebben, en dienovereenkomstig de details voor authentificatie te verstrekken.

      Als u X509 Token selecteert als het verificatietype, configureert u het X509-certificaat. Voor meer informatie, zie de certificaten van de Opstelling.
      Geef de alias KeyStore voor het X509-certificaat op in het veld Key Alias . Geef de tijd in seconden op totdat de verificatieaanvraag geldig blijft in het veld Time To Live . Selecteer desgewenst om de berichttekst, de tijdstempelkop of beide te ondertekenen.

      Als u Mutual Authentication als authentificatietype selecteert, zie Op certificaat-gebaseerde wederzijdse authentificatie voor RESTful en SOAP Webdiensten.

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

OData-services configureren config-odata

De dienst OData wordt geïdentificeerd door zijn de dienstwortel URL. Als u een OData-service in AEM cloudservices wilt configureren, moet u ervoor zorgen dat u over de URL van de servicehoofdmap voor de service beschikt en moet u het volgende doen:

NOTE
Het gegevensmodel van de vorm steunt OData versie 4.
Voor geleidelijke gids om Dynamiek 365 van Microsoft, online of op-gebouw te vormen, zie {de Configuratie van de Dynamica OData van 0} Microsoft 🔗.
  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, of de Authentificatie van de Douane — om tot de dienst toegang te hebben OData, en dienovereenkomstig de details voor authentificatie te verstrekken.
    note note
    NOTE
    Selecteer OAuth 2.0 authentificatietype om met de diensten van de Dynamiek van Microsoft te verbinden gebruikend eindpunt OData als de de dienstwortel.
  4. Selecteer creeer om de wolkenconfiguratie voor de dienst te creëren OData.

Wederzijdse verificatie op basis van certificaten voor RESTful- en SOAP-webservices mutual-authentication

Wanneer u wederzijdse verificatie inschakelt voor het gegevensmodel van het formulier, wordt elkaars identiteit geverifieerd door zowel het gegevensbrongegevensmodel als het gegevensgegevensmodel van AEM server waarop formuliergegevens worden uitgevoerd, voordat gegevens worden gedeeld. U kunt wederzijdse authentificatie voor REST en SOAP gebaseerde verbindingen (gegevensbronnen) gebruiken. Om wederzijdse authentificatie voor een model van vormgegevens op uw milieu van AEM Forms te vormen:

  1. Upload de persoonlijke sleutel (certificaat) naar de AEM Forms -server. De persoonlijke sleutel uploaden:

    1. Meld u als beheerder aan bij uw AEM Forms -server.
    2. Ga naar Tools > Security > Users. Selecteer de gebruiker fd-cloudservice en selecteer Properties .
    3. Open het tabblad Keystore , vouw de optie Add Private Key from KeyStore file uit, upload het KeyStore-bestand, geef de aliassen, wachtwoorden op en selecteer Submit . Het certificaat wordt geüpload. De alias van de persoonlijke sleutel wordt vermeld in het certificaat en ingesteld tijdens het maken van het certificaat.
  2. Upload vertrouwenscertificaat naar Global Trust Store. Het certificaat uploaden:

    1. Navigeer naar Tools > Security > Trust Store .
    2. Vouw de optie Add Certificate from CER file uit, selecteer Select Certificate File , upload het certificaat en selecteer Submit .
  3. Vorm SOAPof RESTfulWebdiensten als gegevensbron en selecteer Mutual authentication als authentificatietype. Als u meerdere zelfondertekende certificaten configureert voor de gebruiker van fd-cloudservice , geeft u de naam van de sleutelalias voor het certificaat op.

Volgende stappen next-steps

U hebt de gegevensbronnen geconfigureerd. Vervolgens kunt u een formuliergegevensmodel maken of als u al een formuliergegevensmodel 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
19ffd973-7af2-44d0-84b5-d547b0dffee2