Gegevensbronnen configureren configure-data-sources

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

Gegevensintegratie

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

Gegevensintegratie ondersteunt OAuth2.0(Autorisatiecode, Client Credentials), Basic Authentication, en API Key authentication types out-of-the-box, en staat het uitvoeren van douaneauthentificatie voor de toegang tot van de Webdiensten toe. Terwijl RESTful, op SOAP-Gebaseerde, 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. Zoeken 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]:[poort]"/systeem/console/crypto.
    2. In de Plain Text veld, geef het wachtwoord of een 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. Inschakelen Test on Borrow of Test on Return om te specificeren dat de voorwerpen alvorens worden geleend of van en aan de pool teruggegeven, worden gevalideerd.

  5. Geef een SQL SELECT-query op in het dialoogvenster Validation Query veld voor het valideren van verbindingen vanuit de pool. 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. Selecteren 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 op https://'[server]:[poort]'system/console/configMgr.

  2. Zoeken naar AEM Forms Data Integrations - User Profile Connector Configuration en selecteer deze optie om de configuratie te openen in de bewerkingsmodus.

  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
    De * in het bovenstaande voorbeeld worden alle knooppunten onder de profile/empLocation/ knooppunt in AEM gebruikersprofiel in CRXDE-structuur. Dit betekent dat het formuliergegevensmodel toegang heeft tot het dialoogvenster city eigenschap of type string aanwezig in een knooppunt onder profile/empLocation/ knooppunt. Nochtans, moeten de knopen die het gespecificeerde bezit bevatten een verenigbare structuur volgen.
  4. Selecteren 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 /conf in AEM opslagplaats. Standaard worden de conf map bevat de global map waar u configuraties voor cloudservices kunt maken. U moet deze optie echter handmatig inschakelen voor cloudconfiguraties. U kunt ook extra mappen maken in conf om cloudserviceconfiguraties te maken en te organiseren.

De map configureren voor configuraties van cloudservices:

  1. Ga naar Tools > General > Configuration Browser.

  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. In de Configuration Browser, selecteert u de global map en selecteer Properties.

    2. In de Configuration Properties dialoogvenster, inschakelen Cloud Configurations.

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

  3. In de Configuration Browser, selecteert u Create.

  4. In de Create Configuration een titel voor de map opgeven en inschakelen Cloud Configurations.

  5. Selecteren Create om de map te maken die is ingeschakeld voor configuraties van de cloudservice.

RESTful-webservices configureren configure-restful-web-services

RESTful-webservice kan worden beschreven met Specificaties van de wagon in JSON- of YAML-indeling in een Swagger-definitiebestand. 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 Map configureren voor configuraties van cloudservices voor informatie over het maken en configureren van een map voor cloudserviceconfiguraties.

  2. Selecteren Create om de Create Data Source Configuration wizard. Geef een naam en eventueel een titel voor de configuratie op. Selecteer RESTful Service van de Service Type vervolgkeuzelijst, bladert u optioneel naar een miniatuurafbeelding voor de configuratie en selecteert u Next.

  3. Specificeer de volgende details voor de RESTful dienst:

    • Selecteer URL of Dossier van de Bron van de Wagger 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 de bron van de wagen 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 verificatietype: None, OAuth2.0(Autorisatiecode, Client Credentials), Basic Authentication, API Key, Custom Authentication, of Mutual Authentication, om toegang te krijgen tot de RESTful-service en dienovereenkomstig gegevens te verstrekken voor verificatie.

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

    Als u Mutual Authentication als authentificatietype, zie Op certificaten gebaseerde wederzijdse verificatie voor RESTful- en SOAP-webservices.

  4. Selecteren Create om de wolkenconfiguratie voor de RESTful dienst te creëren.

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

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

  1. Aanmelden bij Experience Manager Forms Instantie van auteur als beheerder en ga naar Experience Manager bundels voor webconsoles. De standaard-URL is https://localhost:4502/system/console/configMgr.

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

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

    • Geef het maximale aantal toegestane verbindingen op tussen het gegevensmodel van het formulier en de RESTful-webservices in het dialoogvenster Connection limit in total veld. De standaardwaarde is 20 verbindingen.

    • Specificeer het maximumaantal toegestane verbindingen voor elke route in Connection limit on per route basis veld. De standaardwaarde is 2 verbindingen.

    • Geef de duur op, gedurende welke een blijvende HTTP-verbinding in leven blijft in het dialoogvenster Keep alive veld. De standaardwaarde is 15 seconden.

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

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

SOAP-webservices configureren configure-soap-web-services

SOAP-webservices worden beschreven met Web Services Description Language (WSDL)-specificaties. Als u op SOAP gebaseerde webservice wilt configureren in AEM cloudservices, moet u ervoor zorgen dat u over de WSDL-URL voor de webservice beschikt 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 Map configureren voor configuraties van cloudservices voor informatie over het maken en configureren van een map voor cloudserviceconfiguraties.

  2. Selecteren Create om de Create Data Source Configuration wizard. Geef een naam en eventueel een titel voor de configuratie op. Selecteer SOAP Web Service van de Service Type vervolgkeuzelijst, bladert u optioneel naar een miniatuurafbeelding voor de configuratie en selecteert u 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 verificatietype: None, OAuth2.0(Autorisatiecode, Client Credentials), Basisverificatie, Aangepaste verificatie, Token X509 of Wederzijdse verificatie — voor toegang tot de SOAP-service en dienovereenkomstig de gegevens voor verificatie opgeven.

      Als u X509 Token Als het type van Authentificatie, vorm het X509- certificaat. Zie voor meer informatie Certificaten instellen.
      Geef de alias KeyStore voor het X509-certificaat op in het dialoogvenster Key Alias veld. Geef de tijd in seconden op totdat de verificatieaanvraag geldig blijft in het dialoogvenster Time To Live veld. Selecteer desgewenst om de berichttekst, de tijdstempelkop of beide te ondertekenen.

      Als u Mutual Authentication als authentificatietype, zie Op certificaten gebaseerde wederzijdse verificatie voor RESTful- en SOAP-webservices.

  4. Selecteren 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
Formuliergegevensmodel ondersteunt OData versie 4.
Voor geleidelijke gids om Dynamica 365 van Microsoft, online of op-gebouw te vormen, zie Configuratie Microsoft Dynamics OData.
  1. Ga naar Tools > Cloud Services > Data Sources. Selecteer deze optie om de map te selecteren waarin u een cloudconfiguratie wilt maken.

    Zie Map configureren voor configuraties van cloudservices voor informatie over het maken en configureren van een map voor cloudserviceconfiguraties.

  2. Selecteren Create om de Create Data Source Configuration wizard. Geef een naam en eventueel een titel voor de configuratie op. Selecteer OData Service van de Service Type vervolgkeuzelijst, bladert u optioneel naar een miniatuurafbeelding voor de configuratie en selecteert u Next.

  3. Specificeer de volgende details voor de dienst OData:

    • Service Root URL voor de OData-service die moet worden geconfigureerd.
    • Selecteer het verificatietype: None, OAuth2.0(Autorisatiecode, Client Credentials), Basisverificatie of Aangepaste verificatie — toegang tot de OData-service en dienovereenkomstig de gegevens voor verificatie 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. Selecteren Maken om de wolkenconfiguratie voor de dienst te creëren OData.

Op certificaten gebaseerde wederzijdse verificatie 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. De persoonlijke sleutel (certificaat) uploaden naar AEM Forms server. De persoonlijke sleutel uploaden:

    1. Aanmelden bij uw AEM Forms als beheerder.
    2. Ga naar Tools > Security > Users. Selecteer de fd-cloudservice gebruiker en selecteer Properties.
    3. Open de Keystore tabblad, vouwt u de Add Private Key from KeyStore file , uploadt u het KeyStore-bestand, geeft u de aliassen, wachtwoorden en selecteert u 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. Navigeren naar Tools > Security > Trust Store.
    2. Breid uit Add Certificate from CER file selecteert u Select Certificate File, uploadt u het certificaat en selecteert u Submit.
  3. Configureren SOAP of RESTful webservices als gegevensbron en selecteer Mutual authentication als het verificatietype. Als u meerdere zelfondertekende certificaten configureert voor fd-cloudservice -gebruiker, 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 Formuliergegevensmodel maken voor meer informatie.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2