Zelfstudie: Formuliergegevensmodel maken

Deze zelfstudie is een stap in de serie Uw eerste adaptieve vorm maken. U wordt aangeraden de reeks in chronologische volgorde te volgen om het volledige gebruik van de zelfstudie te begrijpen, uit te voeren en aan te tonen.

Informatie over de zelfstudie

Met de AEM Forms-module voor gegevensintegratie kunt u een formuliergegevensmodel maken op basis van verschillende bronnen van back-endgegevens, zoals AEM gebruikersprofiel, RESTful-webservices, SOAP-webservices, OData-services en relationele databases. 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.

Zie AEM Forms Data Integration voor meer informatie over de integratie van formuliergegevens en het formuliergegevensmodel.

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:

• MySQL-database configureren als gegevensbron
• Formuliergegevensmodel maken met MySQL-database
• Formuliergegevensmodel configureren
• Formuliergegevensmodel testen

Het formuliergegevensmodel ziet er ongeveer als volgt uit:

A. Gevormde gegevensbronnen B. Gegevensbronschema's C. Available de modelvoorwerpen D. Data E. Configured de diensten

Vereisten

Voordat u begint, moet u het volgende doen:

• MySQL-database met voorbeeldgegevens zoals vermeld in de sectie Voorwaarden van Uw eerste adaptieve formulier maken
• OSGi-bundel voor MySQL JDBC-stuurprogramma, zoals wordt uitgelegd in Bundling the JDBC Database Driver
• Adaptief formulier zoals uitgelegd in de eerste zelfstudie Een adaptief formulier maken

Stap 1: MySQL-database configureren als gegevensbron

U kunt verschillende typen gegevensbronnen configureren om een formuliergegevensmodel te maken. Voor dit leerprogramma, zullen wij het gegevensbestand vormen MySQL dat u met steekproefgegevens vormde en bevolkt. 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:

1. Installeer het JDBC-stuurprogramma voor MySQL-database als een OSGi-bundel:

   1. Meld u als beheerder aan bij AEM Forms Author Instance en ga naar AEM bundels voor webconsoles. De standaard-URL is http://localhost:4502/system/console/bundles.

   2. Tik Installeren/bijwerken. Er verschijnt een dialoogvenster Bundels uploaden/installeren.

   3. Tik Kies Bestand om door de OSGi-bundel van het MySQL JDBC-stuurprogramma te bladeren en deze te selecteren. Selecteer Bundel starten en Pakketten vernieuwen en tik Installeren of bijwerken. Zorg ervoor dat het JDBC-stuurprogramma voor MySQL van de Oracle Corporation actief is. Het stuurprogramma is geïnstalleerd.

2. MySQL-database configureren als gegevensbron:

   1. Ga naar AEM webconsole op http://localhost:4502/system/console/configMgr.

   2. Zoek Apache Sling Connection Pooled DataSource configuratie. Tik om de configuratie te openen in de bewerkingsmodus.

   3. Geef in het dialoogvenster Configuratie de volgende gegevens op:

      • Naam gegevensbron: u kunt elke gewenste naam opgeven. Geef bijvoorbeeld WeRetailMySQL op.
      • Naam van de de diensteigenschap 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-stuurprogrammaklasse: Geef de Java-klassenaam van het JDBC-stuurprogramma op. Geef voor MySQL-database com.mysql.jdbc.Driver op.
      • URI JDBC-verbinding: Geef de verbindings-URL van de database op. Voor MySQL-database die wordt uitgevoerd op poort 3306 en schema weretail, is de URL: jdbc:mysql://[server]:3306/weretail?autoReconnect=true&useUnicode=true&characterEncoding=utf-8
      • Gebruikersnaam: Gebruikersnaam van de database. Het is vereist om JDBC-stuurprogramma in staat te stellen een verbinding met de database tot stand te brengen.
      • Wachtwoord: Wachtwoord van de database. Het is vereist om JDBC-stuurprogramma in staat te stellen een verbinding met de database tot stand te brengen.
      • Testen op lenen: Schakel de optie Testen op lenen in.
      • Testen op Return: Schakel de optie Testen op retourneren in.
      • Validatiecequery: Geef een SQL SELECT-query op om verbindingen vanuit de pool te valideren. De query moet ten minste één rij retourneren. Bijvoorbeeld select* van klantgegevens.
      • Transactieisolatie: Stel de waarde in op READ_COMTED.

      Laat andere eigenschappen standaard waarden en tik Save.
      Er wordt een configuratie gemaakt die lijkt op de volgende configuratie.

   

Stap 2: Formuliergegevensmodel maken

AEM Forms biedt een intuïtieve gebruikersinterface voor het maken van een formuliergegevensmodel🔗 van geconfigureerde gegevensbronnen. U kunt meerdere gegevensbronnen gebruiken in een formuliergegevensmodel. Voor ons gebruiksgeval, zullen wij de gevormde gegevensbron gebruiken MySQL.

Ga als volgt te werk om het formuliergegevensmodel te maken:

1. Navigeer in AEM auteurinstantie naar Forms > Gegevensintegratie s.

2. Tik Maken > Formuliergegevensmodel.

3. Geef in het dialoogvenster Formuliergegevensmodel maken een naam op voor het formuliergegevensmodel. Bijvoorbeeld customer-Shipping-billing-details. Tik Volgende.

4. Het uitgezochte scherm van gegevensbron maakt een lijst van alle gevormde gegevensbronnen. Selecteer WeRetailMySQL gegevensbron en tik Create.

   

Het formuliergegevensmodel customer-Shipping-billing-details wordt gemaakt.

Stap 3: Formuliergegevensmodel configureren

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:

1. Navigeer bij AEM auteurinstantie naar Forms > Gegevensintegratie. De standaard-URL is http://localhost:4502/aem/forms.html/content/dam/formsanddocuments-fdm.

2. Het model customer-Shipping-billing-details formuliergegevens dat u eerder hebt gemaakt, wordt hier weergegeven. Open het in bewerkingsmodus.

   De geselecteerde gegevensbron WeRetailMySQL wordt gevormd in het model van vormgegevens.

   

3. Vouw de WebRailMySQL-gegevensbronstructuur uit. Selecteer de volgende gegevensmodelvoorwerpen en de diensten van weretail > customerdetails schema aan vormgegevensmodel:

   • Objecten gegevensmodel:

     • id
     • name
     • ShippingAddress
     • stad
     • state
     • postcode

   • Services:

     • get
     • update

   Tik op Geselecteerde objecten toevoegen om geselecteerde gegevensmodelobjecten en -services toe te voegen aan het formuliergegevensmodel.

   

   OPMERKING

   De standaard krijgt, update, en neemt de diensten voor JDBC- gegevensbronnen op uit-van-de-doos met het model van vormgegevens.

4. Configureer lees- en schrijfservices voor het gegevensmodelobject.

   1. Selecteer het customerdetails gegevensmodelobject en tik Eigenschappen bewerken.

   2. Selecteer get in de vervolgkeuzelijst Leesservice. Het id argument, dat de primaire sleutel in het voorwerp van het klantdetailgegevensmodel is wordt automatisch toegevoegd. Tik en configureer het argument als volgt.

      

   3. Selecteer op dezelfde manier update als Schrijverservice. Het customerdetails voorwerp wordt automatisch toegevoegd als argument. Het argument is als volgt geconfigureerd.

      

      Voeg het id argument als volgt toe en vorm.

      

   4. Tik Done om de objecteigenschappen van het gegevensmodel op te slaan. Tik vervolgens op Opslaan om het formuliergegevensmodel op te slaan.

      De get en update services worden toegevoegd als standaardservices voor het gegevensmodelobject.

      

5. Ga naar het tabblad Services en configureer get en update services.

   1. Selecteer de get service en tik Eigenschappen bewerken. Het dialoogvenster Eigenschappen wordt geopend.

   2. Geef het volgende op in het dialoogvenster Eigenschappen bewerken:

      • Titel: Geef de titel van de service op. Bijvoorbeeld: Verzendadres ophalen.

      • Omschrijving: Geef een beschrijving op met een gedetailleerde werking van de service. Bijvoorbeeld:

        Deze service haalt het verzendadres en andere klantgegevens op uit MySQL-database

      • Uitvoermodelobject: Selecteer schema met klantgegevens. Bijvoorbeeld:

        customerdetail-schema

      • Retourarray: Schakel de optie Return- array uit.

      • Argumenten: Selecteer een argument met de naam ID.

      Tik Done. De dienst om klantendetails van het gegevensbestand terug te winnen MySQL wordt gevormd.

      

   3. Selecteer de update-service en tik Eigenschappen bewerken. Het dialoogvenster Eigenschappen wordt geopend.

   4. Geef het volgende op in het dialoogvenster Eigenschappen bewerken:

      • Titel: Geef de titel van de service op. Bijvoorbeeld Verzendadres bijwerken.

      • Omschrijving: Geef een beschrijving op met een gedetailleerde werking van de service. Bijvoorbeeld:

        Deze service werkt het verzendadres en verwante velden in de MySQL-database bij

      • Invoermodelobject: Selecteer schema met klantgegevens. Bijvoorbeeld:

        customerdetail-schema

      • Uitvoertype: Selecteer BOOLEAN.

      • Argumenten: Selecteer een argument met de naam ​​ID en klantgegevens.

      Tik Done. De update dienst om klantendetails in het gegevensbestand bij te werken MySQL wordt gevormd.

      

Het gegevensmodelvoorwerp en de diensten in het model van vormgegevens worden gevormd. U kunt nu het formuliergegevensmodel testen.

Stap 4: Formuliergegevensmodel testen

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:

1. Ga naar het tabblad Model, selecteer customerdetails gegevensmodelobject en tik Model Object testen.

2. Selecteer Model-object lezen in het venster Testmodel / Service in de vervolgkeuzelijst Selecteer model / service.

3. Geef in de sectie customerdetails een waarde op voor het argument id in de geconfigureerde MySQL-database en tik Test.

   De klantgegevens voor de opgegeven id worden opgehaald en weergegeven in de sectie Uitvoer, zoals hieronder wordt weergegeven.

   

4. 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, zal het de bijgewerkte klantendetails terugwinnen en tonen zoals hieronder getoond.

   

Business.Adobe.com-bronnen

Personalized Experiences Customer Communications Content Intelligence Version History Customer Experience Management Headless Cms