Gegevensbronnen configureren configure-data-sources
Leer hoe u verschillende typen gegevensbronnen configureert en hoe u modellen met formuliergegevens maakt.
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 en Oracle RDBMS
- Gebruikersprofiel AEM
- RESTful-webservices
- SOAP-webservices
- OData-diensten
De integratie van gegevens steunt OAuth2.0, Basisauthentificatie, en API Zeer belangrijke authentificatietypes out-of-the-box, en staat het uitvoeren van douaneauthentificatie voor de toegang tot van de Webdiensten toe. Terwijl RESTful, op ZEEP-Gebaseerde, en de diensten OData in de Diensten van de Wolk van AEM worden gevormd, JDBC voor relationele gegevensbestanden en schakelaar voor AEM gebruikersprofiel worden 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:
-
Ga naar AEM webconsole op
https://[server]:[host]/system/console/configMgr
. -
Zoeken naar Apache Sling Connection Pooled DataSource configuratie. Tik om de configuratie te openen in de bewerkingsmodus.
-
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 om verbinding te maken met het JDBC-stuurprogramma
note note NOTE Zorg ervoor dat u gevoelige informatie zoals wachtwoorden codeert alvorens de gegevensbron te vormen. Coderen: - Ga naar
https://[server]:[port]/system/console/crypto
. - In de Plain Text veld, geef het wachtwoord of een tekenreeks op die u wilt versleutelen en klik op Protect.
De gecodeerde tekst wordt weergegeven in het veld Beveiligde tekst dat u in de configuratie kunt opgeven. -
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.
-
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)
-
Tikken Save om de configuratie op te slaan.
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:
-
Ga naar AEM webconsole op
https://[server]:[host]/system/console/configMgr
. -
Zoeken naar AEM Forms Data Integrations - User Profile Connector Configuration en tik om de configuratie te openen in de bewerkingsmodus.
-
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 &asteren; 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 hetcity
eigenschap of typestring
aanwezig in een knooppunt onderprofile/empLocation/
knooppunt. Nochtans, moeten de knopen die het gespecificeerde bezit bevatten een verenigbare structuur volgen. -
Tikken Save om de configuratie op te slaan.
Map configureren voor configuraties van cloudservices cloud-folder
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 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:
-
Ga naar Tools > General > Configuration Browser.
- Zie de Documentatie van de configuratievenster voor meer informatie .
-
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.
- In de Configuration Browser, selecteert u de
global
map en tik Properties. - In de Configuration Properties dialoogvenster, inschakelen Cloud Configurations.
- Tikken Save & Close om de configuratie op te slaan en het dialoogvenster af te sluiten.
- In de Configuration Browser, selecteert u de
-
In de Configuration Browser, tikken Create.
-
In de Create Configuration een titel voor de map opgeven en inschakelen Cloud Configurations.
-
Tikken 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, moet u ervoor 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:
-
Ga naar Tools > Cloud Services > Data Sources. Tik 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.
-
Tikken Create om de Create Data Source Configuration dialog. Geef een naam en eventueel een titel voor de configuratie op. Selecteer RESTful Service van de Service Type keuzelijst, bladert u optioneel naar een miniatuurafbeelding voor de configuratie en tikt u op Next.
-
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 Wagger of upload het dossier van de Swagger van uw lokaal dossiersysteem.
- Selecteer het authentificatietype — niets, OAuth2.0, Basisauthentificatie, API Sleutel, of de Authentificatie van de Douane — om tot de dienst toegang te hebben RESTful, en dienovereenkomstig details voor authentificatie te verstrekken.
-
Tikken Create om de wolkenconfiguratie voor de RESTful dienst tot stand te brengen.
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 de WSDL-URL voor de webservice hebben en het volgende doen:
-
Ga naar Tools > Cloud Services > Data Sources. Tik 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.
-
Tikken Create om de Create Data Source Configuration dialog. Geef een naam en eventueel een titel voor de configuratie op. Selecteer SOAP Web Service van de Service Type keuzelijst, bladert u optioneel naar een miniatuurafbeelding voor de configuratie en tikt u op Next.
-
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, BasisAuthentificatie, de Authentificatie van de Douane, of Token X509 — om tot de dienst van de ZEEP toegang te hebben, en dienovereenkomstig de details voor authentificatie te verstrekken.
Als u Token X509 als Type van Authentificatie selecteert, 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.
-
-
Tikken 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:
-
Ga naar Tools > Cloud Services > Data Sources. Tik 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.
-
Tikken Create om de Create Data Source Configuration dialog. Geef een naam en eventueel een titel voor de configuratie op. Selecteer OData Service van de Service Type keuzelijst, bladert u optioneel naar een miniatuurafbeelding voor de configuratie en tikt u op Next.
-
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, 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 U moet OAuth 2.0 authentificatietype selecteren om met de diensten van de Dynamiek van Microsoft te verbinden gebruikend eindpunt OData als de dienstwortel. -
Tikken Maken om de wolkenconfiguratie voor de dienst te creëren OData.
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 zojuist geconfigureerde gegevensbronnen. Zie Formuliergegevensmodel maken voor meer informatie.