Zelfstudie: Formuliergegevensmodel maken tutorial-create-form-data-model
Dit leerprogramma is een stap in creeert Uw Eerste AanpassingsVormreeksen. De Adobe raadt u aan de reeks in chronologische volgorde te volgen om de volledige Gebruikszaak van de zelfstudie te begrijpen, uit te voeren en te demonstreren.
Over de zelfstudie about-the-tutorial
AEM de module van de de gegevensintegratie van Forms kunt u een model van vormgegevens tot stand brengen van verschillende achterste gegevensbronnen zoals AEM gebruikersprofiel, RESTful Webdiensten, SOAP-gebaseerde Webdiensten, de diensten van OData, en relationele gegevensbestanden. U kunt gegevensmodelobjecten en -services configureren in een formuliergegevensmodel en deze koppelen aan een adaptief formulier. Adaptieve formuliervelden zijn gebonden aan objecteigenschappen van gegevensmodellen. Met deze services kunt u het adaptieve formulier vooraf invullen en verzonden formuliergegevens terugschrijven naar het gegevensmodelobject.
Voor meer informatie over de integratie van vormgegevens en model van vormgegevens, zie de Integratie van Gegevens van AEM Forms.
Deze zelfstudie begeleidt u door de stappen voor het voorbereiden, maken, configureren en koppelen van een formuliergegevensmodel aan een adaptief formulier. Aan het einde van deze zelfstudie kunt u het volgende doen:
Het formuliergegevensmodel ziet er ongeveer als volgt uit:
A. Vormde gegevensbronnen B. De schema's van de Gegevensbron C. Beschikbare diensten D. de modelvoorwerpen van Gegevens E. Vormde diensten
Vereisten prerequisites
Voordat u begint, moet u het volgende doen:
- MySQL gegevensbestand met steekproefgegevens zoals die in de sectie van Vereisten van worden verklaard creeer uw eerste adaptieve vorm
- OSGi bundel voor MySQL bestuurder JDBC zoals verklaard in Bundling de Bestuurder van het Gegevensbestand JDBC
- De adaptieve vorm zoals verklaard in het eerste leerprogramma leidt tot een adaptieve vorm
Stap 1: Vorm MySQL gegevensbestand als gegevensbron config-database
U kunt verschillende typen gegevensbronnen configureren om een formuliergegevensmodel te maken. Voor deze zelfstudie configureert u de MySQL-database die u hebt geconfigureerd en gevuld met voorbeeldgegevens. Voor informatie over andere gesteunde gegevensbronnen en hoe te om hen te vormen, zie de Integratie van Gegevens van AEM Forms.
Ga als volgt te werk om uw MySQL -database te configureren:
-
Installeer het JDBC-stuurprogramma voor de MySQL -database als een OSGi-bundel:
-
Download MySQL OSGi-bundel voor JDBC-stuurprogramma van
http://www.java2s.com/ref/jar/download-orgosgiservicejdbc100jar-file.html. -
Meld u aan bij AEM Forms Author Instance als beheerder en ga naar bundels met AEM-webconsoles. De standaard-URL is https://localhost:4502/system/console/bundles.
-
Selecteer Install/Update. Er wordt een Upload / Install Bundles dialoogvenster weergegeven.
-
Selecteer Choose File om door de bundel MySQL OSGi van het JDBC-stuurprogramma te bladeren en deze te selecteren. Selecteer Start Bundle en Refresh Packages en selecteer Install or Update . Controleer of het Oracle Corporation’s JDBC-stuurprogramma voor MySQL actief is. Het stuurprogramma is geïnstalleerd.
-
-
MySQL -database configureren als gegevensbron:
-
Ga naar AEM Webconsole in https://localhost:4502/system/console/configMgr.
-
Bepaal de plaats van Apache die Verbinding Gepoold DataSource configuratie. Selecteer deze optie om de configuratie te openen in de bewerkingsmodus.
-
Geef in het dialoogvenster Configuratie de volgende gegevens op:
- naam Datasource: u kunt om het even welke naam specificeren. Bijvoorbeeld, specificeer WeRetailMySQL.
- Naam van het de dienstbezit DataSource: specificeer naam van het de dienstbezit die de naam DataSource bevat. Het wordt gespecificeerd terwijl het registreren van de gegevensbroninstantie als dienst OSGi. Bijvoorbeeld, datasource.name.
- JDBC bestuurdersklasse: specificeer Java™ klassennaam van de bestuurder JDBC. Geef MySQL voor database com.mysql.jdbc.Driver op.
- JDBC verbinding URI: specificeer verbinding URL van het gegevensbestand. Voor MySQL -database die wordt uitgevoerd op poort 306 en schema
weretailis de URL:jdbc:mysql://'server':3306/weretail?autoReconnect=true&useUnicode=true&characterEncoding=utf-8
note note NOTE Wanneer de MySQL -database zich achter een firewall bevindt, is de hostnaam van de database geen openbare DNS. Het IP-adres van de database moet worden toegevoegd aan het /etc/hosts-bestand van de AEM-hostcomputer. - Gebruikersnaam: Gebruikersnaam van de database. U moet het JDBC-stuurprogramma inschakelen om een verbinding met de database tot stand te brengen.
- Wachtwoord: Wachtwoord van het gegevensbestand. Het is vereist om JDBC-stuurprogramma in staat te stellen een verbinding met de database tot stand te brengen.
note note NOTE AEM Forms biedt geen ondersteuning voor NT-verificatie voor MySQL . Ga naar AEM Webconsole in https://localhost:4502/system/console/configMgren onderzoek "Apache het Verdelen Verbinding Gepoolde Gegevensbron". Voor de eigenschap "JDBC connection URI" stelt u de waarde van "IntegratedSecurity" in op False en gebruikt u de gemaakte gebruikersnaam en het gemaakte wachtwoord voor verbinding met de database MySQL . -
Test op Krediet: laat de Test on Borrow optie toe.
-
Test op Terugkeer: laat de Test on Return optie toe.
-
Vraag van de Bevestiging: specificeer een SQL UITGEZOCHTE vraag om verbindingen van de pool te bevestigen. De query moet ten minste één rij retourneren. Bijvoorbeeld, selecteer * van klantdetails.
-
Isolatie van de Transactie: Plaats de waarde aan READ_COMTED.
Verlaat andere eigenschappen met standaard waardenen selecteer Save.
Er wordt een configuratie gemaakt die lijkt op de volgende configuratie.
-
Stap 2: Formuliergegevensmodel maken create-fdm
AEM Forms biedt een intuïtieve gebruikersinterface om een formuliergegevensmodel🔗 te maken op basis van geconfigureerde gegevensbronnen. U kunt meerdere gegevensbronnen in een formuliergegevensmodel gebruiken. In dit geval kunt u de geconfigureerde MySQL gegevensbron gebruiken.
Ga als volgt te werk om een formuliergegevensmodel te maken:
-
Navigeer in AEM auteurinstantie naar Forms > Data Integrations .
-
Selecteer Create > Form Data Model .
-
In de Create dialoog van het Model van Gegevens van de Vorm, specificeer a naam voor het model van vormgegevens. Bijvoorbeeld, klant-verschepen-facturerend-details. Selecteer Next .
-
Het uitgezochte scherm van gegevensbron maakt een lijst van alle gevormde gegevensbronnen. Selecteer WijRetailMySQL gegevensbron en selecteer Create.
Het klant-verschepen-factureren-details model van vormgegevens wordt gecreeerd.
Stap 3: Formuliergegevensmodel configureren config-fdm
Het configureren van het formuliergegevensmodel omvat:
- toevoegen, gegevensmodelobject en -services
- het vormen lees en schrijf de diensten voor de voorwerpen van het gegevensmodel
Voer de volgende handelingen uit om het formuliergegevensmodel te configureren:
-
Navigeer in AEM auteurinstantie naar Forms > Data Integrations . Het gebrek URL is https://localhost:4502/aem/forms.html/content/dam/formsanddocuments-fdm.
-
Het klant-verschepen-factureren-details model van vormgegevens u vroeger creeerde is hier vermeld. Open het in de bewerkingsmodus.
De geselecteerde gegevensbron WeRetailMySQL wordt gevormd in het model van vormgegevens.
-
Vouw de WebRailMySQL-gegevensbronstructuur uit. Selecteer de volgende voorwerpen en de diensten van het gegevensmodel van weretail > klantdetails schema zodat kunt u gegevensmodel vormen:
-
modelvoorwerpen van Gegevens:
- id
- name
- ShippingAddress
- stad
- state
- postcode
-
Diensten:
- Toevoegen
- update
Selecteer toevoegen Geselecteerde om geselecteerde voorwerpen en de diensten van het gegevensmodel aan het model van vormgegevens toe te voegen.
note note NOTE De standaard krijgt, update, en neemt de diensten voor JDBC- gegevensbronnen op uit-van-de-doos met het model van vormgegevens. -
-
Configureer lees- en schrijfservices voor het gegevensmodelobject.
-
Selecteer het klantDetails voorwerp van het gegevensmodel en selecteer Edit Properties.
-
Selecteer get in de vervolgkeuzelijst Leesservice. Het identiteitskaart argument, dat de primaire sleutel in het voorwerp van de klantendetails gegevensmodel is wordt automatisch toegevoegd. Selecteer
-
Selecteer op dezelfde manier update als de Write Service. Het klantdetails voorwerp wordt automatisch toegevoegd als argument. Het argument is als volgt geconfigureerd.
Voeg en vorm het identiteitskaart argument als volgt toe.
-
Selecteer Done om de eigenschappen van het gegevensmodel op te slaan. Selecteer Save vervolgens om het formuliergegevensmodel op te slaan.
De get en update services worden toegevoegd als standaardservices voor het gegevensmodelobject.
-
-
Ga naar het tabblad Services en configureer get - en update -services.
-
Selecteer de service get en selecteer Edit Properties . Het dialoogvenster Eigenschappen wordt geopend.
-
Geef het volgende op in het dialoogvenster Eigenschappen bewerken:
-
Titel: Specificeer titel van de dienst. Bijvoorbeeld: Verzendadres ophalen.
-
Beschrijving: Specificeer beschrijving die het gedetailleerde functioneren van de dienst bevatten. Bijvoorbeeld:
Deze service haalt het verzendadres en andere klantgegevens op uit de MySQL -database
-
ModelVoorwerp van de Output: Selecteer schema dat klantengegevens bevat. Bijvoorbeeld:
klantdetailschema
-
serie van de Terugkeer: Maak de serie van de Terugkeer optie onbruikbaar.
-
Argumenten: selecteer het argument id .
Selecteer Done. De service voor het ophalen van klantgegevens uit de MySQL-database is geconfigureerd.
-
-
Selecteer de service update en selecteer Edit Properties . Het dialoogvenster Eigenschappen wordt geopend.
-
Geef het volgende op in het dialoogvenster Edit Properties :
-
Titel: Specificeer titel van de dienst. Bijvoorbeeld Verzendadres bijwerken.
-
Beschrijving: Specificeer beschrijving die het gedetailleerde functioneren van de dienst bevatten. Bijvoorbeeld:
Deze service werkt het verzendadres en verwante velden in de MySQL-database bij
-
ModelVoorwerp van de Input: Selecteer schema dat klantengegevens bevat. Bijvoorbeeld:
klantdetailschema
-
Type van Output: Selecteer BOOLEAN.
-
Argumenten: Selecteer argumentnaam identiteitskaart en klantdetails.
Selecteer Done. De update -service voor het bijwerken van klantgegevens in de MySQL -database is geconfigureerd.
-
-
Het gegevensmodelvoorwerp en de diensten in het model van vormgegevens worden gevormd. U kunt nu het formuliergegevensmodel testen.
Stap 4: Model voor formuliergegevens testen test-fdm
U kunt het gegevensmodelobject en de services testen om te controleren of het formuliergegevensmodel correct is geconfigureerd.
Voer de volgende handelingen uit om de test uit te voeren:
-
Ga naar het Model lusje, selecteer het klantDetails voorwerp van het gegevensmodel, en selecteer Test Model Object.
-
Selecteer in het Test Model/Service -venster Read model object in de vervolgkeuzelijst Select Model/Service .
-
In de klantendetails sectie, specificeer een waarde voor het identiteitskaart argument dat in het gevormde MySQL gegevensbestand bestaat en Test selecteert.
De klantgegevens die aan de opgegeven id zijn gekoppeld, worden opgehaald en in de sectie Output weergegeven, zoals hieronder wordt weergegeven.
-
Op dezelfde manier kunt u het Schrijven modelvoorwerp en de diensten testen.
In het volgende voorbeeld werkt de updateservice de adresgegevens voor de id 7102715 in de database bij.
Nu, als u de gelezen modeldienst opnieuw voor identiteitskaart 7107215 test, haalt het en toont de bijgewerkte klantendetails zoals hieronder getoond.
