Werken met formuliergegevensmodel

De Integratie van gegevens verstrekt de modelredacteur van vormgegevens om met de modellen van vormgegevens te vormen en te werken.

De formuliergegevensmodeleditor biedt een intuïtieve gebruikersinterface en hulpmiddelen voor het bewerken en configureren van een formuliergegevensmodel. Met behulp van de editor kunt u gegevensmodelobjecten, eigenschappen en services toevoegen en configureren vanuit gekoppelde gegevensbronnen in het formuliergegevensmodel. Daarnaast kunt u gegevensmodelobjecten en -eigenschappen maken zonder gegevensbronnen en deze later binden met de respectievelijke gegevensmodelobjecten en -eigenschappen. U kunt ook voorbeeldgegevens genereren en bewerken voor objecteigenschappen van gegevensmodellen die u kunt gebruiken om aangepaste formulieren en interactieve communicatie vooraf in te vullen tijdens het weergeven van een voorbeeld. U kunt gegevensmodelvoorwerpen en de diensten testen die in een model van vormgegevens worden gevormd om ervoor te zorgen het behoorlijk met gegevensbronnen wordt geïntegreerd.

Zie de volgende onderwerpen als u nog niet bekend bent met de Forms-gegevensintegratie en geen gegevensbron hebt geconfigureerd of een formuliergegevensmodel hebt gemaakt:

• AEM Forms-gegevensintegratie
• Gegevensbronnen configureren
• Formuliergegevensmodel maken

Lees verder voor meer informatie over verschillende taken en configuraties die u kunt uitvoeren met de formuliergegevensmodeleditor.

Objecten en services voor gegevensmodellen toevoegen

Als u een formuliergegevensmodel met gegevensbronnen hebt gemaakt, kunt u de formuliergegevensmodeleditor gebruiken om gegevensmodelobjecten en -services toe te voegen, de eigenschappen ervan te configureren, koppelingen tussen gegevensmodelobjecten te maken en het gegevensmodel en de services van het formulier te testen.

U kunt gegevensmodelvoorwerpen en de diensten van beschikbare gegevensbronnen in het model van vormgegevens toevoegen. Terwijl de toegevoegde voorwerpen van het gegevensmodel op het Modellusje verschijnen, verschijnen de toegevoegde diensten op het lusje van de Diensten.

Objecten en services voor gegevensmodellen toevoegen:

1. Meld u aan bij de AEM auteur, navigeer naar Forms > Data Integrations en open het formuliergegevensmodel waarin u gegevensmodelobjecten wilt toevoegen.

2. In de ruit van Gegevensbronnen, breid gegevensbronnen uit om beschikbare voorwerpen en de diensten van het gegevensmodel te bekijken.

3. Selecteer gegevensmodelobjecten en -services die u wilt toevoegen aan het formuliergegevensmodel en tik op Add Selected.

   

   Op het tabblad Model wordt een grafische weergave weergegeven van alle gegevensmodelobjecten en de bijbehorende eigenschappen die aan het formuliergegevensmodel zijn toegevoegd. Elk gegevensmodelobject wordt vertegenwoordigd door een vak in het formuliergegevensmodel.

   

   OPMERKING

   U kunt gegevensmodelobjectvakken vastzetten en slepen om ze in het inhoudsgebied te ordenen. Alle gegevensmodelobjecten die in het formuliergegevensmodel worden toegevoegd, worden grijs weergegeven in het deelvenster Gegevensbronnen.

   Het tabblad Services bevat toegevoegde services.

   

   OPMERKING

   Naast gegevensmodelvoorwerpen en de diensten, omvat het document van de de dienstmeta-gegevens OData navigatie eigenschappen die vereniging tussen twee voorwerpen van het gegevensmodel bepalen. Zie Werken met navigatie-eigenschappen van OData-services voor meer informatie.

4. Tik Save om het formuliermodelobject op te slaan.

   OPMERKING

   U kunt services die u hebt geconfigureerd op het tabblad Services van een formuliergegevensmodel, aanroepen met behulp van de adaptieve formulierregels. De gevormde diensten zijn beschikbaar in de Invoke de dienstenactie van de regelredacteur voor meer informatie over het gebruiken van deze diensten in adaptieve vormregels, zie de Diensten van de Invoke en Reeks Waarde van regels in regelredacteur.

Gegevensmodelobjecten en onderliggende eigenschappen maken

Gegevensmodelobjecten maken

Terwijl u gegevensmodelvoorwerpen van gevormde gegevensbronnen kunt toevoegen, kunt u voorwerpen of entiteiten van het gegevensmodel zonder gegevensbronnen ook tot stand brengen. Dit is vooral handig als u geen gegevensbronnen hebt geconfigureerd in het formuliergegevensmodel.

Een gegevensmodelobject maken zonder gegevensbronnen:

1. Meld u aan bij de AEM auteur, navigeer naar Forms > Data Integrations en open het formuliergegevensmodel waarin u een gegevensmodelobject of -entiteit wilt maken.

2. Tik op Create Entity.

3. Geef in het dialoogvenster Gegevensmodel maken een naam op voor het gegevensmodelobject en tik Add. Er wordt een gegevensmodelobject toegevoegd aan het formuliergegevensmodel. Het nieuwe gegevensmodelobject is niet gebonden aan een gegevensbron en heeft geen eigenschappen zoals in de volgende afbeelding wordt getoond.

   

Vervolgens kunt u onderliggende eigenschappen toevoegen aan niet-gebonden gegevensmodelobjecten.

Onderliggende eigenschappen toevoegen

Met de formuliergegevensmodeleditor kunt u onderliggende eigenschappen in een gegevensmodelobject maken. De eigenschap bij het maken is niet gebonden aan een eigenschap in een gegevensbron. U kunt de eigenschap child later binden met een andere eigenschap in het omvattende gegevensmodelobject.

Een onderliggende eigenschap maken:

1. Selecteer een gegevensmodelobject in een formuliergegevensmodel en tik op Create Child Property.

2. Geef in het dialoogvenster Create Child Property een naam en gegevenstype op voor de eigenschap in respectievelijk de velden Name en Type. U kunt desgewenst een titel en beschrijving voor de eigenschap opgeven.

3. Schakel Berekend in als de eigenschap een berekende eigenschap is. De waarde van een berekende eigenschap wordt berekend op basis van een regel of expressie. Zie Eigenschappen bewerken voor meer informatie.

4. Als het gegevensmodelobject aan een gegevensbron is gebonden, wordt de toegevoegde onderliggende eigenschap automatisch gebonden aan de eigenschap van het bovenliggende gegevensmodelobject met dezelfde naam en hetzelfde gegevenstype.

   Tik op het bladerpictogram naast het veld Bind Reference om een onderliggende eigenschap handmatig te binden met een objecteigenschap van het gegevensmodel. In het dialoogvenster Select Object worden alle eigenschappen van het bovenliggende gegevensmodelobject weergegeven. Selecteer een eigenschap die u wilt binden en tik op het verdeelstreeppictogram. Merk op dat u slechts een bezit van het zelfde gegevenstype zoals het kindbezit kunt selecteren.

5. Tik Done om de eigenschap child op te slaan en tik Save om het formuliergegevensmodel op te slaan. De eigenschap child wordt nu toegevoegd aan het gegevensmodelobject.

Nadat u gegevensmodelobjecten en -eigenschappen hebt gemaakt, kunt u doorgaan met het maken van adaptieve formulieren en interactieve communicatie op basis van het formuliergegevensmodel. Als u later gegevensbronnen beschikbaar en geconfigureerd hebt, kunt u het gegevensmodel van het formulier binden met gegevensbronnen. De binding wordt automatisch bijgewerkt in de bijbehorende adaptieve formulieren en interactieve communicatie. Zie Formuliergegevensmodel gebruiken voor meer informatie over het maken van adaptieve formulieren en interactieve communicatie met behulp van het formuliergegevensmodel.

Objecten en eigenschappen van gegevensmodellen binden

Wanneer de gegevensbronnen die u wilt integreren met het formuliergegevensmodel beschikbaar zijn, kunt u deze toevoegen aan het formuliergegevensmodel zoals beschreven in Gegevensbronnen bijwerken. Voer vervolgens de volgende handelingen uit om de niet-gebonden gegevensmodelobjecten en -eigenschappen te binden:

1. Selecteer in het formuliergegevensmodel de niet-gebonden gegevensbron die u met een gegevensbron wilt binden.

2. Tik op Edit Properties.

3. Tik in het deelvenster Edit Properties op het bladerpictogram naast het veld Binding. Hiermee wordt het dialoogvenster Select Object geopend waarin de gegevensbronnen worden weergegeven die in het formuliergegevensmodel zijn toegevoegd.

   

4. Vouw de gegevensbronstructuur uit en selecteer een gegevensmodelobject om mee te binden en tik op het verdeelstreeppictogram.

5. Tik op Done om de eigenschappen op te slaan en tik vervolgens op Save om het formuliergegevensmodel op te slaan. Het gegevensmodelobject is nu gebonden aan een gegevensbron. Het gegevensmodelobject is niet meer gemarkeerd als Niet geconsolideerd.

   

Services configureren

Om gegevens voor een voorwerp van het gegevensmodel te lezen en te schrijven, doe het volgende om gelezen te vormen en de diensten te schrijven:

1. Schakel het selectievakje boven aan een gegevensmodelobject in om het te selecteren en op Edit Properties te tikken.

   

   Eigenschappen bewerken om lees- en schrijfservices voor een gegevensmodelobject te configureren

   Het dialoogvenster Eigenschappen bewerken wordt geopend.

   

   Eigenschappen bewerken, dialoogvenster

   OPMERKING

   Naast gegevensmodelvoorwerpen en de diensten, omvat het document van de de dienstmeta-gegevens OData navigatie eigenschappen die vereniging tussen twee voorwerpen van het gegevensmodel bepalen. Wanneer u een de dienstgegevensbron van OData aan een Model van de Gegevens van de Vorm toevoegt, is er de dienst beschikbaar in het Model van de Gegevens van de Vorm voor alle navigatie eigenschappen in een voorwerp van het gegevensmodel. U kunt deze service gebruiken om de navigatie-eigenschappen van het overeenkomende gegevensmodelobject te lezen.

   Zie Werken met navigatie-eigenschappen van OData-services voor meer informatie over de service.

2. Schakel Top Level Object in om op te geven of het gegevensmodelobject een modelobject op het hoogste niveau is.

   Gegevensmodelobjecten die zijn geconfigureerd in een formuliergegevensmodel, zijn beschikbaar voor gebruik op het tabblad Gegevensmodelobjecten in de inhoudbrowser van een adaptief formulier op basis van het formuliergegevensmodel. Wanneer u een koppeling toevoegt tussen twee gegevensmodelobjecten, wordt het gegevensmodelobject dat u koppelt, genest onder het gegevensmodelobject dat u koppelt op het tabblad Gegevensmodelobjecten. Als het geneste gegevensmodel een object op hoofdniveau is, wordt het ook afzonderlijk weergegeven op het tabblad Objecten gegevensmodel. Daarom ziet u twee items ervan, een binnen en een buiten de geneste hiërarchie, die verwarring kunnen veroorzaken bij auteurs van formulieren. Als u het gekoppelde gegevensmodelobject alleen in de geneste hiërarchie wilt weergeven, schakelt u de eigenschap Object op hoogste niveau uit.

3. Selecteer de Lezen en schrijven diensten voor de geselecteerde voorwerpen van het gegevensmodel. De argumenten voor de services worden weergegeven.

   

   Lees en schrijf de diensten die voor werknemersgegevensbron worden gevormd

4. Tik voor het argument van de leesservice om het argument aan een Attribuut van het Profiel van de Gebruiker, een Attribuut van het Verzoek, of Letterlijke waarde te binden en de bindende waarde te specificeren. Het bindt het de dienstargument aan de gespecificeerde bindende attributen of letterlijke waarde, die tot de dienst als argument wordt overgegaan om details te halen verbonden aan de gespecificeerde waarde uit de gegevensbron.

   In dit voorbeeld neemt het argument id de waarde van het kenmerk empid van het gebruikersprofiel en geeft het als een argument door aan de leesservice. De methode leest en retourneert waarden van gekoppelde eigenschappen van het employee gegevensmodelobject voor het opgegeven empid. Dus als u 00250 opgeeft in het veld empid in het formulier, leest de leesserservice details van de werknemer met 00250 werknemer-id.

   Daarnaast kunt u een argument verplicht of optioneel maken.

   

   Het id-argument binden om kenmerk van AEM gebruikersprofiel leeg te maken

5. Tik Done om het argument op te slaan, Done om de eigenschappen op te slaan en Save om het formuliergegevensmodel op te slaan.

Koppelingen toevoegen

Er zijn doorgaans koppelingen tussen gegevensmodelobjecten in een gegevensbron. 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 die door 1:n op de lijn wordt getoond 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. In een formuliergegevensmodel kunt u koppelingen toevoegen tussen gegevensmodelobjecten in verschillende gegevensbronnen.

Een koppeling toevoegen:

1. Schakel het selectievakje boven aan een gegevensmodelobject in om het te selecteren en op Add Association te tikken. Het dialoogvenster Koppeling toevoegen wordt geopend.

   

   OPMERKING

   Naast gegevensmodelvoorwerpen en de diensten, omvat het document van de de dienstmeta-gegevens OData navigatie eigenschappen die vereniging tussen twee voorwerpen van het gegevensmodel bepalen. U kunt deze navigatie-eigenschappen gebruiken wanneer u koppelingen toevoegt aan het formuliergegevensmodel. Zie Werken met navigatie-eigenschappen van OData-services voor meer informatie.

   Het dialoogvenster Koppeling toevoegen wordt geopend.

   

   Dialoogvenster Koppeling toevoegen

2. In de Add ruit van de Vereniging:

   • Geef een titel op voor de koppeling.
   • Selecteer het associatietype — Een-op-een of een-op-een.
   • Selecteer het gegevensmodelobject dat u wilt koppelen.
   • Selecteer de leesservice om gegevens van het geselecteerde modelobject te lezen. Het argument van de leesservice wordt weergegeven. Bewerk het argument om het indien nodig te wijzigen en koppel het aan de eigenschap van het gegevensmodelobject dat u wilt koppelen.

   In het volgende voorbeeld is het standaardargument voor de leesservice van het gegevensmodelobject Afhankelijke elementen dependentid.

   

   Het standaardargument voor de dienst van het lezen van Afhankelijkheden is afhankelijk

   Het argument moet echter een algemene eigenschap zijn tussen het gekoppelde gegevensmodelobject, die in dit voorbeeld Employeeid is. Daarom moet het Employeeid argument aan het id bezit van het de gegevensmodelvoorwerp van de Werknemer worden gebonden om de bijbehorende gebiedsdeeldetails van het het modelvoorwerp van Afhankelijke gegevens te halen.

   

   Bijgewerkt argument en binding

   Tik Done om het argument op te slaan.

3. Tik Done om de koppeling op te slaan en Save om het formuliergegevensmodel op te slaan.

4. Herhaal de stappen om desgewenst meer koppelingen te maken.

Eigenschappen bewerken

U kunt eigenschappen van gegevensmodelobjecten bewerken, de eigenschappen ervan en de services die zijn toegevoegd aan het formuliergegevensmodel.

Eigenschappen bewerken:

1. Schakel het selectievakje in naast een gegevensmodelobject, een eigenschap of een service in het formuliergegevensmodel.

2. Tik op Edit Properties. Het deelvenster Edit Properties voor het geselecteerde modelobject, de geselecteerde eigenschap of service wordt geopend.

   • Gegevensmodelobject: Geef de lees- en schrijfservices op en bewerk argumenten.
   • Eigenschap: Geef het type, subtype en de indeling voor de eigenschap op. U kunt ook opgeven of de geselecteerde eigenschap de primaire sleutel voor het gegevensmodelobject is.
   • Service: Geef het invoermodelobject, het uitvoertype en de argumenten voor de service op. Voor de Get dienst, kunt u specificeren als het wordt verwacht om een serie terug te keren.

   

   Dialoogvenster Eigenschappen bewerken voor een get-service

3. Tik Done om eigenschappen op te slaan en Save om het formuliergegevensmodel op te slaan.

Berekende eigenschappen maken

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.

U kunt bijvoorbeeld een berekende eigenschap FullName maken waarvan de waarde het resultaat is van een samenvoeging van de bestaande eigenschappen FirstName en LastName. Daartoe:

1. Maak een nieuwe eigenschap met de naam FullName waarvan het gegevenstype String is.

2. Schakel Computed in en tik Done om de eigenschap te maken.

   

   De berekende eigenschap FullName wordt gemaakt. Let op het pictogram naast de eigenschap om een berekende eigenschap weer te geven.

   

3. Selecteer het bezit FullName en tik Edit Rule. Er wordt een regeleditorvenster geopend.

4. Tik in het venster van de regeleditor op Create. Er wordt een Set Value-regelvenster geopend.

   Selecteer Mathematical Expression in het keuzemenu Optie selecteren. Andere beschikbare opties zijn Form Data Model Object en String.

5. Selecteer FirstName en LastName in respectievelijk eerste en tweede object in de wiskundige expressie. Selecteer plus als exploitant.

   Tik Done en tik Close om het venster van de regeleditor te sluiten. De regel ziet er ongeveer als volgt uit.

   

6. Tik op Save in het formuliergegevensmodel. Het gegevens verwerkte bezit wordt gevormd.

Werken met navigatie-eigenschappen van OData-services

In de diensten van OData, navigatie worden de eigenschappen gebruikt om verenigingen tussen twee voorwerpen van het gegevensmodel te bepalen. Deze eigenschappen worden gedefinieerd op een entiteitstype of een complex type. In het volgende extract uit het metagegevensbestand van het voorbeeld TripPin OData voorbeeldservices bevat de personenentiteit bijvoorbeeld drie navigatie-eigenschappen: Vrienden, BestFriend en Trips.

Zie OData-documentatie voor meer informatie over navigatie-eigenschappen.

<edmx:Edmx xmlns:edmx="https://docs.oasis-open.org/odata/ns/edmx" Version="4.0">
<script/>
<edmx:DataServices>
<Schema xmlns="https://docs.oasis-open.org/odata/ns/edm" Namespace="Microsoft.OData.Service.Sample.TrippinInMemory.Models">
<EntityType Name="Person">
<Key>
<PropertyRef Name="UserName"/>
</Key>
<Property Name="UserName" Type="Edm.String" Nullable="false"/>
<Property Name="FirstName" Type="Edm.String" Nullable="false"/>
<Property Name="LastName" Type="Edm.String"/>
<Property Name="MiddleName" Type="Edm.String"/>
<Property Name="Gender" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.PersonGender" Nullable="false"/>
<Property Name="Age" Type="Edm.Int64"/>
<Property Name="Emails" Type="Collection(Edm.String)"/>
<Property Name="AddressInfo" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location)"/>
<Property Name="HomeAddress" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location"/>
<Property Name="FavoriteFeature" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Feature" Nullable="false"/>
<Property Name="Features" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Feature)" Nullable="false"/>
<NavigationProperty Name="Friends" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person)"/>
<NavigationProperty Name="BestFriend" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person"/>
<NavigationProperty Name="Trips" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Trip)"/>
</EntityType>

Wanneer u een OData-service in een formuliergegevensmodel configureert, worden alle navigatie-eigenschappen in een entiteitcontainer beschikbaar gesteld via een service in het formuliergegevensmodel. In dit voorbeeld van de TripPin OData-service kunnen de drie navigatie-eigenschappen in de Person-entiteitcontainer worden gelezen met behulp van een GET LINK-service in het formuliergegevensmodel.

Hieronder wordt de GET LINK of Person /People-service in het formuliergegevensmodel gemarkeerd. Dit is een gecombineerde service voor de drie navigatie-eigenschappen in de Person-entiteit van de TripPin OData-service.

Nadat u de service GET LINK hebt toegevoegd aan het tabblad Services in het formuliergegevensmodel, kunt u de eigenschappen bewerken en het uitvoermodelobject en de navigatie-eigenschap kiezen die u in de service wilt gebruiken. De volgende GET LINK of Person /People-service in het volgende voorbeeld gebruikt bijvoorbeeld Trip als het uitvoermodelobject en de navigatie-eigenschap als Trips.

In dit voorbeeld kunt u het uitvoermodelobject ook kiezen als argument voor personen- en navigatie-eigenschappen als Vrienden of BestFriend (afhankelijk van of Return array? is ingeschakeld of uitgeschakeld).

Op dezelfde manier kunt u een GET LINK dienst kiezen en zijn navigatie eigenschappen vormen wanneer het toevoegen van verenigingen in het Model van de Gegevens van de Vorm. Als u echter een navigatie-eigenschap wilt kunnen selecteren, moet u ervoor zorgen dat Binding To field is ingesteld op Literal.

Voorbeeldgegevens genereren en bewerken

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.

Ga als volgt te werk om voorbeeldgegevens te genereren en te bewerken:

1. Open een formuliergegevensmodel en tik op Edit Sample Data. De voorbeeldgegevens worden gegenereerd en weergegeven in het venster Voorbeeldgegevens bewerken.

   

2. Bewerk in het venster Edit Sample Data de vereiste gegevens en tik Save.

Vervolgens kunt u de voorbeeldgegevens gebruiken om interactieve communicatie vooraf in te vullen en te testen op basis van het gegevensmodel van het formulier. Zie Formuliergegevensmodel gebruiken voor meer informatie.

Objecten en services van gegevensmodellen testen

Uw formuliergegevensmodel is geconfigureerd, maar voordat u het in gebruik neemt, wilt u wellicht testen of de geconfigureerde gegevensmodelobjecten en -services naar behoren werken. Objecten en services van gegevensmodellen testen:

1. Selecteer een gegevensmodelobject of een service in het formuliergegevensmodel en tik op Test Model Object of Test Service.

   Het venster Formuliergegevensmodel testen wordt geopend.

   

2. Selecteer in het venster Testformuliergegevensmodel het gegevensmodelobject of de gegevensservice die u wilt testen in het deelvenster Invoer.

3. Geef een argumentwaarde op in de testcode en tik Test. Een geslaagde test retourneert de uitvoer in het deelvenster Uitvoer.

   

U kunt ook andere gegevensmodelobjecten en -services testen in het formuliergegevensmodel.

Volgende stappen

U hebt een werkformuliergegevensmodel dat nu klaar is voor gebruik in adaptieve formulieren en interactieve communicatieworkflows. Zie Formuliergegevensmodel gebruiken voor meer informatie.

Business.Adobe.com-bronnen

Multichannel Communication Auto Form Fill Personalized Experiences Embedded Charts Content As A Service Customer Experience Management