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.

Formuliergegevensmodel maken voor interactieve communicatie

04-create-form-data-model-main

Deze zelfstudie is een stap in de Maak uw eerste interactieve communicatie 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 aangepaste formulier vooraf invullen en ingediende 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 om een formuliergegevensmodel voor te bereiden, te maken, te configureren en aan een interactieve communicatie te koppelen. Aan het einde van deze zelfstudie kunt u het volgende doen:

Het formuliergegevensmodel ziet er ongeveer als volgt uit:

form_data_model_callouts

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: De database instellen step-set-up-the-database

Een gegevensbestand is essentieel om een Interactieve Mededeling tot stand te brengen. Deze zelfstudie gebruikt een database voor het weergeven van het formuliergegevensmodel en persistentiemogelijkheden van interactieve communicatie. Opstelling een gegevensbestand dat klant, rekeningen, en vraaglijsten bevat.
De volgende afbeelding illustreert voorbeeldgegevens voor de klantentabel:

sample_data_cust

Gebruik de volgende verklaring DDL om tot de klant tabel in de database.

CREATE TABLE `customer` (
   `mobilenum` int(11) NOT NULL,
   `name` varchar(45) NOT NULL,
   `address` varchar(45) NOT NULL,
   `alternatemobilenumber` int(11) DEFAULT NULL,
   `relationshipnumber` int(11) DEFAULT NULL,
   `customerplan` varchar(45) DEFAULT NULL,
   PRIMARY KEY (`mobilenum`),
   UNIQUE KEY `mobilenum_UNIQUE` (`mobilenum`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8

Gebruik de volgende verklaring DDL om tot de rekeningen tabel in de database.

CREATE TABLE `bills` (
   `billplan` varchar(45) NOT NULL,
   `latepayment` decimal(4,2) NOT NULL,
   `monthlycharges` decimal(4,2) NOT NULL,
   `billdate` date NOT NULL,
   `billperiod` varchar(45) NOT NULL,
   `prevbal` decimal(4,2) NOT NULL,
   `callcharges` decimal(4,2) NOT NULL,
   `confcallcharges` decimal(4,2) NOT NULL,
   `smscharges` decimal(4,2) NOT NULL,
   `internetcharges` decimal(4,2) NOT NULL,
   `roamingnational` decimal(4,2) NOT NULL,
   `roamingintnl` decimal(4,2) NOT NULL,
   `vas` decimal(4,2) NOT NULL,
   `discounts` decimal(4,2) NOT NULL,
   `tax` decimal(4,2) NOT NULL,
   PRIMARY KEY (`billplan`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8

Gebruik de volgende verklaring DDL om tot de oproepen tabel in de database.

CREATE TABLE `calls` (
   `mobilenum` int(11) DEFAULT NULL,
   `calldate` date DEFAULT NULL,
   `calltime` varchar(45) DEFAULT NULL,
   `callnumber` int(11) DEFAULT NULL,
   `callduration` varchar(45) DEFAULT NULL,
   `callcharges` decimal(4,2) DEFAULT NULL,
   `calltype` varchar(45) DEFAULT NULL
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8

De oproepen de lijst omvat de vraagdetails zoals vraagdatum, vraagtijd, vraagaantal, vraagduur, en vraaglasten. De klant de lijst is verbonden met de vraaglijst gebruikend het Mobiele gebied van het Aantal (mobilenum). Voor elk mobiel nummer dat wordt vermeld in het dialoogvenster klant de tabel bevat meerdere records in de oproepen tabel. Bijvoorbeeld, kunt u de vraagdetails voor terugwinnen 1457892541 mobiel nummer door te verwijzen naar de oproepen tabel.

De rekeningen de tabel bevat de gegevens van de rekening, zoals de datum van de rekening, de factuurperiode, de maandelijkse kosten en de kosten van de oproep. De klant tabel is gekoppeld aan rekeningen tabel met het veld Bill Plan. Er is een plan verbonden aan elke klant in klant tabel. De rekeningen de tabel bevat de prijsgegevens voor alle bestaande plannen . U kunt bijvoorbeeld de abonnementsdetails ophalen voor Sarah van de klant tabel en gebruik deze gegevens om prijsgegevens op te halen uit de rekeningen tabel.

Stap 2: MySQL-database configureren als gegevensbron step-configure-mysql-database-as-data-source

U kunt verschillende typen gegevensbronnen configureren om een formuliergegevensmodel te maken. Voor dit leerprogramma, zult u het gegevensbestand vormen MySQL dat met steekproefgegevens wordt gevormd 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 MySQL.
      • 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-teleca, is de URL: jdbc:mysql://[server]:3306/teleca?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 klant.
      • 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.

    apache_configuration

Stap 3: Formuliergegevensmodel maken step-create-form-data-model

AEM Forms biedt een intuïtieve gebruikersinterface voor Een modus voor formuliergegevens makenl van gevormde gegevensbronnen. U kunt meerdere gegevensbronnen gebruiken in een formuliergegevensmodel. Voor het gebruiksgeval in deze zelfstudie, zult u MySQL als gegevensbron gebruiken.

Ga als volgt te werk om het formuliergegevensmodel te maken:

  1. Navigeer in AEM auteurinstantie naar Forms > Gegevensintegratie.

  2. Tikken Maken > Formuliergegevensmodel.

  3. Geef in de wizard Formuliergegevensmodel maken een name voor het formuliergegevensmodel. Bijvoorbeeld: FDM_Create_First_IC. Tikken Volgende.

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

    fdm_mysql_data_source

  5. Klikken Gereed. De FDM_Create_First_IC formuliergegevensmodel wordt gemaakt.

Stap 4: Formuliergegevensmodel configureren step-configure-form-data-model

Het formuliergegevensmodel configureren omvat:

Objecten en services voor gegevensmodellen toevoegen add-data-model-objects-and-services

  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 FDM_Create_First_IC Hier wordt het formuliergegevensmodel weergegeven dat u eerder hebt gemaakt. Selecteer het en tik Bewerken.

    De geselecteerde gegevensbron MySQL wordt weergegeven in het dialoogvenster Gegevensbronnen venster.

    mysql_fdm

  3. Breid uit MySQL gegevensbronstructuur. Selecteer de volgende gegevensmodelvoorwerpen en de diensten van teleca schema:

    • Gegevensmodelobjecten:

      • rekeningen
      • oproepen
      • klant

    • Services:

      • get
      • update

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

    select_data_model_objects_services

    De rekeningen, de vraag, en de objecten van het klantengegevensmodel worden getoond in de juiste ruit in Model tab. De get- en updateservices worden weergegeven in het dialoogvenster Services tab.

    data_model_objects

Berekende onderliggende eigenschappen maken voor gegevensmodelobject create-computed-child-properties-for-data-model-object

Een berekende eigenschap is de eigenschap waarvan de waarde wordt berekend op basis van een regel of expressie. Met behulp van een regel kunt u de waarde van een berekende eigenschap instellen op een letterlijke tekenreeks, een getal, het resultaat van een wiskundige expressie of de waarde van een andere eigenschap in het formuliergegevensmodel.

Maak op basis van het gebruiksgeval de gebruikskosten onderliggende berekende eigenschap in de rekeningen gegevensmodelobject met de volgende wiskundige expressie:

  • gebruikskosten = gesprekskosten + gesprekskosten voor conferenties + sms-tarieven + mobiele internettarieven + roaming nationaal + roaming internationaal + VAS (al deze eigenschappen zijn te vinden in het factuurgegevensmodelobject)

    Voor meer informatie over de gebruikskosten onderliggende berekende eigenschap, zie De interactieve communicatie plannen.

Voer de volgende stappen uit om berekende onderliggende eigenschappen voor het modelobject van rekeningen te maken:

  1. Schakel het selectievakje boven aan het dialoogvenster rekeningen gegevensmodelobject selecteren en tikken Onderliggende eigenschap maken.

  2. In de Onderliggende eigenschap maken deelvenster:

    1. Enter gebruikskosten als de naam van de onderliggende eigenschap.
    2. Inschakelen Berekend.
    3. Selecteren Float als type en tik Gereed om de eigenschap child toe te voegen aan de rekeningen gegevensmodelobject.

    create_child_property_float

  3. Tikken Regel bewerken om de Regeleditor te openen.

  4. Tikken Maken. De Waarde instellen regelvenster wordt geopend.

  5. Selecteer in het keuzemenu Optie selecteren de optie Wiskundige expressie.

    usage_lades_rule_editor

  6. Selecteer in de wiskundige expressie opvragingskosten en samenvattingskosten als respectievelijk eerste en tweede object. Selecteren plus als de operator. Tik binnen de wiskundige expressie en tik op Expressie uitbreiden toevoegen schaarste, onderlinge verbinding, landelijk, roamingintnl, en vas objecten naar de expressie.

    De volgende afbeelding toont de wiskundige expressie in de regeleditor:

    usage_lades_rule_all

  7. Tikken Gereed. De regel wordt gecreeerd in de Redacteur van de Regel.

  8. Tikken Sluiten om het venster van de Redacteur van de Regel te sluiten.

Koppelingen tussen gegevensmodelobjecten toevoegen add-associations-between-data-model-objects

Nadat de gegevensmodelobjecten zijn gedefinieerd, kunt u koppelingen tussen deze objecten maken. De koppeling kan een-op-een of een-op-een zijn. Bijvoorbeeld, kunnen er veelvoudige gebiedsdelen verbonden aan een werknemer zijn. Het wordt bedoeld als één-aan-vele vereniging en afgebeeld door 1:n op de lijn die bijbehorende voorwerpen van het gegevensmodel verbindt. Nochtans, als een vereniging een unieke werknemersnaam voor een bepaalde werknemersidentiteitskaart terugkeert, wordt het bedoeld als één-op-één vereniging.

Wanneer u gekoppelde gegevensmodelobjecten in een gegevensbron toevoegt aan een formuliergegevensmodel, blijven de koppelingen behouden en worden ze weergegeven als verbonden door pijllijnen.

Op basis van het gebruiksgeval kunt u de volgende koppelingen maken tussen de gegevensmodelobjecten:

Associatie
Gegevensmodelobjecten
1:n
klant:vraag (De veelvoudige vraag kan met een klant in een maandelijkse rekening worden geassocieerd)
1:1
klant:rekeningen (één rekening wordt geassocieerd met een klant voor een bepaalde maand)

Voer de volgende stappen uit om koppelingen te maken tussen gegevensmodelobjecten:

  1. Schakel het selectievakje boven aan het dialoogvenster klant gegevensmodelobject selecteren en tikken Koppeling toevoegen. De Koppeling toevoegen eigenschappenvenster wordt geopend.

  2. In de Koppeling toevoegen deelvenster:

    • Geef een titel op voor de koppeling. Het is een optioneel veld.
    • Selecteren Eén naar vele van de Type vervolgkeuzelijst.
    • Selecteren oproepen van de Modelobject vervolgkeuzelijst.
    • Selecteren get van de Service vervolgkeuzelijst.
    • Tikken Toevoegen om de klant gegevensmodelobject naar oproepen gegevensmodelobject dat een eigenschap gebruikt. Gebaseerd op het gebruiksgeval, moet het modelvoorwerp van vraaggegevens met het mobiele aantalbezit in het voorwerp van het klantengegevensmodel worden verbonden. De Argument toevoegen wordt geopend.

    add_association

  3. In de Argument toevoegen dialoogvenster:

    • Selecteren mobilenum van de Naam vervolgkeuzelijst. De eigenschap mobile number is een algemene eigenschap die beschikbaar is in de klant en die gegevensmodelobjecten aanroept. Dientengevolge, wordt het gebruikt om een verband tussen klant tot stand te brengen en de voorwerpen van het gegevensmodel te roepen.

      Voor elk mobiel aantal beschikbaar in het modelvoorwerp van klantengegevens, zijn er veelvoudige vraagverslagen beschikbaar in de vraaglijst.

    • Geef een optionele titel en beschrijving voor het argument op.

    • Selecteren klant van de Binding aan vervolgkeuzelijst.

    • Selecteren mobilenum van de Bindingswaarde vervolgkeuzelijst.

    • Tikken Toevoegen.

    add_association_argument

    De eigenschap mobilenum wordt weergegeven in het dialoogvenster Argumenten sectie.

    add_argument_association

  4. Tikken Gereed om een verbinding 1:n tussen klant en vraag de modelvoorwerpen van gegevens tot stand te brengen.

    Zodra u een vereniging tussen klant en vraag de modelvoorwerpen van gegevens hebt gecreeerd, creeer een 1:1 vereniging tussen de klant en de modelvoorwerpen van rekeningen.

  5. Schakel het selectievakje boven aan het dialoogvenster klant gegevensmodelobject selecteren en tikken Koppeling toevoegen. De Koppeling toevoegen eigenschappenvenster wordt geopend.

  6. In de Koppeling toevoegen deelvenster:

    • Geef een titel op voor de koppeling. Het is een optioneel veld.

    • Selecteren Eén op één van de Type vervolgkeuzelijst.

    • Selecteren rekeningen van de Modelobject vervolgkeuzelijst.

    • Selecteren get van de Service vervolgkeuzelijst. De bladerplan eigenschap, de primaire sleutel voor de tabel met rekeningen, is al beschikbaar in de Argumenten sectie.

      De rekeningen en de objecten van het klantengegevensmodel zijn verbonden gebruikend billplan (rekeningen) en klant (klant) eigenschappen. Creeer een band tussen deze eigenschappen om de plandetails voor om het even welke klant terug te winnen beschikbaar in het gegevensbestand MySQL.

    • Selecteren klant van de Binding aan vervolgkeuzelijst.

    • Selecteren klantplan van de Bindingswaarde vervolgkeuzelijst.

    • Tikken Gereed om een band tussen het billplan en de eigenschappen van het klantplan tot stand te brengen.

    add_association_customer_rekeningen

    In de volgende afbeelding ziet u de koppelingen tussen de gegevensmodelobjecten en de eigenschappen die worden gebruikt om koppelingen tussen deze objecten te maken:

    fdm_verenigingen

Eigenschappen van gegevensmodelobjecten bewerken edit-data-model-object-properties

Nadat het creëren van verbindingen tussen de klant en andere voorwerpen van het gegevensmodel, geef de klanteneigenschappen uit om het bezit te bepalen dat wordt gebaseerd waarop de gegevens van het voorwerp van het gegevensmodel worden teruggewonnen. Gebaseerd op het gebruiksgeval, wordt het mobiele aantal gebruikt als bezit om gegevens van het voorwerp van het klantengegevensmodel terug te winnen.

  1. Schakel het selectievakje boven aan het dialoogvenster klant gegevensmodelobject selecteren en tikken Eigenschappen bewerken. De Eigenschappen bewerken wordt geopend.

  2. Opgeven klant als de Model op hoofdniveau, object.

  3. Selecteren get van de Leesservice vervolgkeuzelijst.

  4. In de Argumenten sectie:

    • Selecteren Aanvraagkenmerk van de Binding aan vervolgkeuzelijst.
    • Opgeven mobilenum als de bindingswaarde.

  5. Selecteren update van de Schrijven Vervolgkeuzelijst Service.

  6. In de Argumenten sectie:

    • Voor mobilenum eigenschap, selecteren klant van de Binding aan vervolgkeuzelijst.
    • Selecteren mobilenum van de Bindingswaarde vervolgkeuzelijst.

  7. Tikken Gereed om de eigenschappen op te slaan.

    configure_services_customer

  8. Schakel het selectievakje boven aan het dialoogvenster oproepen gegevensmodelobject selecteren en tikken Eigenschappen bewerken. De Eigenschappen bewerken wordt geopend.

  9. De opdracht Model op hoofdniveau, object for oproepen gegevensmodelobject.

  10. Tikken Gereed.

    Herhaal stap 8 - 10 om de eigenschappen voor te configureren rekeningen gegevensmodelobject.

Services configureren configure-services

  1. Ga naar de Services tab.

  2. Selecteer get service en tikken Eigenschappen bewerken. De Eigenschappen bewerken wordt geopend.

  3. In de Eigenschappen bewerken deelvenster:

    • Voer een optionele titel en beschrijving in.
    • Selecteren klant van de Uitvoermodelobject vervolgkeuzelijst.
    • Tikken Gereed om de eigenschappen op te slaan.

    edit_properties_get_details

  4. Selecteer update service en tikken Eigenschappen bewerken. De Eigenschappen bewerken wordt geopend.

  5. In de Eigenschappen bewerken deelvenster:

    • Voer een optionele titel en beschrijving in.
    • Selecteren klant van de Invoermodelobject vervolgkeuzelijst.
    • Tikken Gereed.
    • Tikken Opslaan om het formuliergegevensmodel op te slaan.

    update_service_properties

Stap 5: Formuliergegevensmodel en services testen step-test-form-data-model-and-services

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 klant gegevensmodelobject en tik Model-object testen.

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

  3. In de Invoer -sectie, geeft u een waarde op voor de mobilenum bezit dat in het gevormde gegevensbestand MySQL bestaat en tikt Testen.

    De klantgegevens die aan de opgegeven eigenschap mobileEnum zijn gekoppeld, worden opgehaald en weergegeven in de sectie Uitvoer, zoals hieronder wordt weergegeven. Sluit het dialoogvenster.

    test_data_model

  4. Ga naar de Services tab.

  5. Selecteer get service en tikken Testservice.

  6. In de Invoer -sectie, geeft u een waarde op voor de mobilenum bezit dat in het gevormde gegevensbestand MySQL bestaat en tikt Testen.

    De klantgegevens die aan de opgegeven eigenschap mobileEnum zijn gekoppeld, worden opgehaald en weergegeven in de sectie Uitvoer, zoals hieronder wordt weergegeven. Sluit het dialoogvenster.

    test_service

Voorbeeldgegevens bewerken en opslaan edit-and-save-sample-data

Met de formuliergegevensmodeleditor kunt u voorbeeldgegevens genereren voor alle eigenschappen van gegevensmodelobjecten, inclusief berekende eigenschappen, in een formuliergegevensmodel. Het is een reeks willekeurige waarden die met het gegevenstype voldoen dat voor elk bezit wordt gevormd. U kunt ook gegevens bewerken en opslaan. Deze blijven behouden, zelfs als u de voorbeeldgegevens opnieuw genereert.

Voer de volgende handelingen uit om voorbeeldgegevens te genereren, te bewerken en op te slaan:

  1. Tik op de pagina met het formuliergegevensmodel op Voorbeeldgegevens bewerken. De voorbeeldgegevens worden gegenereerd en weergegeven in het venster Voorbeeldgegevens bewerken.

    edit_sample_data

  2. In Voorbeeldgegevens bewerken venster, gegevens naar wens bewerken en tikken Opslaan. Sluit het venster.

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