DocumentatieAEM 6.4Gids voor formulieren

Zelfstudie: Formuliergegevensmodel maken tutorial-create-form-data-model

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • User
CAUTION
AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.

04-create-form-data-model-main

Deze zelfstudie is een stap in de Uw eerste adaptieve formulier maken reeks. 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.

Over de zelfstudie about-the-tutorial

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.

Voor meer informatie over de integratie van formuliergegevens en het formuliergegevensmodel raadpleegt u AEM Forms-gegevensintegratie.

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:

form-data-model_l

A. Gevormde gegevensbronnen B. Gegevensbronschema's C. Beschikbare services D. Gegevensmodelobjecten E. Gevormde services

Vereisten prerequisites

Voordat u begint, moet u het volgende doen:

Stap 1: MySQL-database configureren als gegevensbron config-database

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 AEM Forms-gegevensintegratie.

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. Tikken Installeren/bijwerken. An Bundels uploaden/installeren wordt weergegeven.

    3. Tikken Bestand kiezen om te doorbladeren en de MySQL JDBC bestuurder OSGi bundel te selecteren. Selecteren Bundel starten en Pakketten vernieuwen en tikken 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. Zoeken 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.
      • Eigenschapnaam van DataSource-service: 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. Voor MySQL-database geeft u com.mysql.jdbc.Driver.
      • URI voor 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: De optie Testen op lenen optie.
      • Testen op rendement: De optie Testen op rendement optie.
      • Validatiezoekopdracht: Geef een SQL SELECT-query op om verbindingen vanuit de pool te valideren. De query moet ten minste één rij retourneren. Bijvoorbeeld: &last selecteren; van klantgegevens.
      • Transactieisolatie: Stel de waarde in op READ_COMTED.

      Andere eigenschappen standaard laten staan waarden en tikken Opslaan.
      Er wordt een configuratie gemaakt die lijkt op de volgende configuratie.

    relationele database-data-source-configuration

Stap 2: Formuliergegevensmodel maken create-fdm

AEM Forms biedt een intuïtieve gebruikersinterface voor een formuliergegevensmodel maken van gevormde 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. Tikken Maken > Formuliergegevensmodel.

  3. Geef in het dialoogvenster Formuliergegevensmodel maken een name voor het formuliergegevensmodel. Bijvoorbeeld: klant-verzend-facturerings-details. Tikken Volgende.

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

    gegevensbron-selectie

De klant-verzend-facturerings-details formuliergegevensmodel wordt gemaakt.

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:

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

  2. De klant-verzend-facturerings-details Hier wordt het formuliergegevensmodel weergegeven dat u eerder hebt gemaakt. Open het in bewerkingsmodus.

    De geselecteerde gegevensbron WeRetailMySQL is geconfigureerd in het formuliergegevensmodel.

    default-fdm

  3. Vouw de WebRailMySQL-gegevensbronstructuur uit. Selecteer de volgende gegevensmodelvoorwerpen en de diensten van wieg > klantgegevens schema naar formuliergegevensmodel:

    • Gegevensmodelobjecten:

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

    • Services:

      • get
      • update

    Tikken Geselecteerde toevoegen Hiermee voegt u geselecteerde gegevensmodelobjecten en -services toe aan het formuliergegevensmodel.

    weretail-schema

    note note
    NOTE
    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 klantgegevens gegevensmodelobject en tik Eigenschappen bewerken.

    2. Selecteren get in de vervolgkeuzelijst Leesservice. De id argument, de primaire sleutel in het gegevensmodelobject van de klant is, wordt automatisch toegevoegd. Tikken aem_6_3_edit en configureer het argument als volgt.

      standaard lezen

    3. Selecteer op dezelfde manier update als de schrijfservice. De klantgegevens object automatisch als een argument toegevoegd. Het argument is als volgt geconfigureerd.

      standaard schrijven

      Voeg en vorm toe id als volgt.

      id-arg

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

      De get en update de diensten worden toegevoegd als standaarddiensten voor het voorwerp van het gegevensmodel.

      data-model-object

  5. Ga naar de Services tab en configure get en update diensten.

    1. Selecteer get service en tikken 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.

      • Beschrijving: 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: De opdracht Retourarray optie.

      • Argumenten: Benoemd argument selecteren ID.

      Tikken Gereed. De dienst om klantendetails van het gegevensbestand terug te winnen MySQL wordt gevormd.

      verzendadres-herwinning

    3. Selecteer update service en tikken 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.

      • Beschrijving: 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: Selecteren BOOLEAN.

      • Argumenten: Benoemd argument selecteren ID en klantgegevens.

      Tikken Gereed. De update de dienst om klantendetails in het MySQL gegevensbestand bij te werken wordt gevormd.

      send-address-update

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

Stap 4: Formuliergegevensmodel 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:

  1. Ga naar de Model selecteert u de klantgegevens gegevensmodelobject en tik Model-object testen.

  2. In de Testmodel/service venster, selecteert u Model-object lezen van de Model/service selecteren vervolgkeuzelijst.

  3. In de klantgegevens -sectie, geeft u een waarde op voor de id argument dat in het gevormde gegevensbestand MySQL bestaat en tikt Testen.

    De klantgegevens die aan opgegeven id zijn gekoppeld, worden opgehaald en weergegeven in het dialoogvenster Uitvoer zoals hieronder weergegeven.

    testmodel

  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.

    test-schrijven-model

    Nu, als u de gelezen modeldienst opnieuw voor identiteitskaart 7107215 test, zal het de bijgewerkte klantendetails terugwinnen en tonen zoals hieronder getoond.

    lezen-bijgewerkt

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da