Zelfstudie: Formuliergegevensmodel maken

Formuliergegevensmodel maken voor interactieve communicatie

Deze zelfstudie is een stap in de serie Maak uw eerste interactieve communicatiemodellen. 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 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:

• De database instellen
• MySQL-database configureren als gegevensbron
• Formuliergegevensmodel maken
• 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 Stel de database in.
• OSGi-bundel voor MySQL JDBC-stuurprogramma, zoals wordt uitgelegd in Bundling the JDBC Database Driver

Stap 1: Database instellen

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:

Gebruik de volgende verklaring DDL om de klant lijst in gegevensbestand tot stand te brengen.

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 de rekeningen lijst in gegevensbestand tot stand te brengen.

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 de call lijst in gegevensbestand tot stand te brengen.

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 call lijst omvat de vraagdetails zoals vraagdatum, vraagtijd, vraagaantal, vraagduur, en vraaglasten. De klant lijst is verbonden met de vraaglijst gebruikend het Mobiele gebied van het Aantal (mobilenum). Voor elk mobiel aantal dat in klant lijst wordt vermeld, zijn er veelvoudige verslagen in vraag lijst. Bijvoorbeeld, kunt u de vraagdetails voor 1457892541 mobiel aantal terugwinnen door naar vraag lijst te verwijzen.

De tabel rekeningen bevat de gegevens van de factuur, zoals de datum van de rekening, de factuurperiode, de maandelijkse kosten en de kosten van de oproep. De tabel customer is gekoppeld aan de tabel rekeningen met behulp van het veld Bill Plan. In de tabel customer is aan elke klant een abonnement gekoppeld. De rekeningen lijst omvat de prijsdetails voor alle bestaande plannen. Bijvoorbeeld, kunt u de plandetails voor Sarah van klant lijst terugwinnen en die details gebruiken om prijsdetails van rekeningen lijst terug te winnen.

Stap 2: MySQL-database configureren als gegevensbron

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 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 MySQL 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-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: 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 klant.
      • 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 3: Formuliergegevensmodel maken

AEM Forms biedt een intuïtieve gebruikersinterface voor het maken van een formuliergegevensmodus🔗l op basis van geconfigureerde 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. Tik Maken > Formuliergegevensmodel.

3. Geef in de wizard Formuliergegevensmodel maken een naam op voor het formuliergegevensmodel. Bijvoorbeeld FDM_Create_First_IC. Tik Volgende.

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

   

5. Klik Done. Het gegevensmodel FDM_Create_First_IC wordt gemaakt.

Stap 4: Formuliergegevensmodel configureren

Het formuliergegevensmodel configureren omvat:

• gegevensmodelobjecten en services toevoegen
• berekende onderliggende eigenschappen maken voor gegevensmodelobject
• koppelingen tussen gegevensmodelobjecten toevoegen
• bewerken van objecteigenschappen van gegevensmodellen
• configureren van services voor gegevensmodelobjecten

Objecten en services voor gegevensmodellen toevoegen

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

2. Het FDM_Create_First_IC model van formuliergegevens dat u eerder hebt gemaakt, wordt hier weergegeven. Selecteer het en tik Edit.

   De geselecteerde gegevensbron MySQL wordt getoond in Gegevensbronnen ruit.

   

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

   • Objecten gegevensmodel:

     • rekeningen
     • oproepen
     • klant

   • Services:

     • get
     • update

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

   

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

   

Berekende onderliggende eigenschappen maken voor gegevensmodelobject

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.

Gebaseerd op het gebruiksgeval, creeer usagelades kind gegevens verwerkte bezit in het rekeningen gegevensmodelvoorwerp gebruikend de volgende wiskundige uitdrukking:

• 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 gebruiksheadingen kind gegevens verwerkte bezit, zie Plan de Interactieve Communicatie.

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

1. Schakel het selectievakje boven aan het gegevensmodelobject rekeningen in om het te selecteren en op Onderliggende eigenschap maken te tikken.

2. In het deelvenster Onderliggende eigenschap maken:

   1. Voer useLages in als de naam van de onderliggende eigenschap.
   2. Berekend inschakelen.
   3. Selecteer Zweven als het type en tik Done om de onderliggende eigenschap toe te voegen aan het rekeningen gegevensmodelobject.

   

3. Tik Regel bewerken om de Regeleditor te openen.

4. Tik Maken. Het Set Value regelvenster wordt geopend.

5. Selecteer Wiskundige expressie in het keuzemenu Optie selecteren.

   

6. Selecteer calllades en confcallloading in de wiskundige expressie als eerste respectievelijk als tweede objecten. Selecteer plus als exploitant. Tik binnen de wiskundige expressie en tik Expression uitbreiden om smaaklijnen, onderlinge koppelingen, roamingnational, roamingintnl en <a vas a 11/>-objecten naar de expressie.

   De volgende afbeelding toont de wiskundige expressie in de regeleditor:

   

7. Tik Done. De regel wordt gecreeerd in de Redacteur van de Regel.

8. Tik Close om het venster van de Redacteur van de Regel te sluiten.

Koppelingen toevoegen tussen gegevensmodelobjecten

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:

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

1. Schakel het selectievakje boven aan het gegevensmodelobject customer in om het te selecteren en op Add Association te tikken. Het Add de bezitsruit van de Vereniging opent.

2. In voeg Vereniging ruit toe:

   • Geef een titel op voor de koppeling. Het is een optioneel veld.
   • Selecteer Een tot veel in de vervolgkeuzelijst Type.
   • Selecteer vraag van ModelVoorwerp drop-down lijst.
   • Selecteer get in de vervolgkeuzelijst Service.
   • Tik Add om het gegevensmodelobject customer te koppelen aan call gegevensmodelobject met behulp van een eigenschap. Gebaseerd op het gebruiksgeval, moet het modelvoorwerp van vraaggegevens met het mobiele aantalbezit in het modelvoorwerp van klantengegevens worden verbonden. Het dialoogvenster Argument toevoegen wordt geopend.

   

3. In het dialoogvenster Argument toevoegen:

   • Selecteer mobilenum in de vervolgkeuzelijst Naam. 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.

   • Selecteer klant in de vervolgkeuzelijst Binding aan.

   • Selecteer mobilenum in de vervolgkeuzelijst Bindingswaarde.

   • Tik Toevoegen.

   

   De eigenschap mobilenum wordt weergegeven in de sectie Argumenten.

   

4. Tik Done om een koppeling van 1:n tussen klant en aanroepende gegevensmodelobjecten te maken.

   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 gegevensmodelobject customer in om het te selecteren en op Add Association te tikken. Het Add de bezitsruit van de Vereniging opent.

6. In voeg Vereniging ruit toe:

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

   • Selecteer Een naar een in de vervolgkeuzelijst Type.

   • Selecteer facturen in de vervolgkeuzelijst Model Object.

   • Selecteer get in de vervolgkeuzelijst Service. De eigenschap billplan, de primaire sleutel voor de tabel met facturen, is al beschikbaar in de sectie Argumenten.

     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.

   • Selecteer klant in de vervolgkeuzelijst Binding aan.

   • Selecteer customerplan in de vervolgkeuzelijst Binding Value.

   • Tik Done om een binding te maken tussen de eigenschappen billplan en customerplan.

   

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

   

Eigenschappen van gegevensmodelobjecten bewerken

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 gegevensmodelobject customer in om het te selecteren en op Eigenschappen bewerken te tikken. Het deelvenster Eigenschappen bewerken wordt geopend.

2. Geef klant op als het Model op hoofdniveau.

3. Selecteer get in de vervolgkeuzelijst Leesservice.

4. In de sectie Argumenten:

   • Selecteer Kenmerk aanvragen in de vervolgkeuzelijst Binding aan.
   • Geef mobilenum op als bindingswaarde.

5. Selecteer update in de vervolgkeuzelijst Write Service.

6. In de sectie Argumenten:

   • Selecteer klant in de vervolgkeuzelijst Binding aan voor de eigenschap Mobenum.
   • Selecteer mobilenum in de vervolgkeuzelijst Bindingswaarde.

7. Tik Done om de eigenschappen op te slaan.

   

8. Schakel het selectievakje boven aan het gegevensmodelobject call in om het te selecteren en op Eigenschappen bewerken te tikken. Het deelvenster Eigenschappen bewerken wordt geopend.

9. Schakel het Model op hoogste niveau voor oproepen gegevensmodelobject uit.

10. Tik Done.

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

Services configureren

1. Ga naar Services tabel.

2. Selecteer de get service en tik Eigenschappen bewerken. Het deelvenster Eigenschappen bewerken wordt geopend.

3. In Eigenschappen bewerken deelvenster:

   • Voer een optionele titel en beschrijving in.
   • Selecteer klant in de vervolgkeuzelijst Uitvoermodelobject.
   • Tik Done om de eigenschappen op te slaan.

   

4. Selecteer de update-service en tik Eigenschappen bewerken. Het deelvenster Eigenschappen bewerken wordt geopend.

5. In Eigenschappen bewerken deelvenster:

   • Voer een optionele titel en beschrijving in.
   • Selecteer klant in de vervolgkeuzelijst Invoermodelobject.
   • Tik Done.
   • Tik Opslaan om het model met formuliergegevens op te slaan.

   

Stap 5: Model en services voor formuliergegevens 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 het klant gegevensmodelobject en tik Testmodelobject.

2. Selecteer Modelobject lezen in de vervolgkeuzelijst Model/service selecteren in het venster Formuliergegevensmodel testen.

3. Geef in de sectie Invoer een waarde op voor de eigenschap mobilenum die bestaat in de geconfigureerde MySQL-database en tik Test.

   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.

   

4. Ga naar Services tabel.

5. Selecteer de get service en tik Testservice.

6. Geef in de sectie Invoer een waarde op voor de eigenschap mobilenum die bestaat in de geconfigureerde MySQL-database en tik Test.

   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.

   

Voorbeeldgegevens bewerken en opslaan

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 van het formuliergegevensmodel op Voorbeeldgegevens bewerken. De voorbeeldgegevens worden gegenereerd en weergegeven in het venster Voorbeeldgegevens bewerken.

   

2. Bewerk in het venster Voorbeeldgegevens bewerken de vereiste gegevens en tik Opslaan. Sluit het venster.

Business.Adobe.com-bronnen