Werken met formuliergegevensmodel work-with-form-data-model
De formuliergegevensmodeleditor biedt een intuïtieve gebruikersinterface en gereedschappen 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 de adaptieve Forms vooraf in te vullen tijdens voorvertonen. U kunt gegevensmodelvoorwerpen en de diensten testen die in een Model van de Gegevens van het Vorm worden gevormd om het behoorlijk met gegevensbronnen te verzekeren.
Zie de volgende onderwerpen als u nog niet bekend bent met de Forms-gegevensintegratie en geen gegevensbron hebt geconfigureerd of een formuliergegevensmodel hebt gemaakt:
Lees verder voor meer informatie over verschillende taken en configuraties die u kunt uitvoeren met de formuliergegevensmodeleditor.
Objecten en services voor gegevensmodellen toevoegen add-data-model-objects-and-services
Als u een Model van de Gegevens van de Vorm met gegevensbronnen creeerde, kunt u de Redacteur van het Model van de Gegevens van de Vorm gebruiken om gegevensmodelvoorwerpen en de diensten toe te voegen, hun eigenschappen te vormen, verenigingen tussen de voorwerpen van het gegevensmodel te bouwen, en het Model en de diensten van de Gegevens van de Vorm 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:
-
Aanmelden bij Experience Manager auteurinstantie, navigeren aan Forms > Data Integrations en opent u het formuliergegevensmodel waaraan u gegevensmodelobjecten wilt toevoegen.
-
In de ruit van Gegevensbronnen, breid gegevensbronnen uit om beschikbare voorwerpen en de diensten van het gegevensmodel te bekijken.
-
Selecteer gegevensmodelobjecten en -services die u wilt toevoegen aan het formuliergegevensmodel en selecteer Add Selected.
Geselecteerde gegevensmodelobjecten en services
De 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.
Model tab geeft toegevoegde gegevensmodelobjecten weer
note note NOTE U kunt gegevensmodelobjectvakken vastzetten en slepen om ze in het inhoudsgebied te ordenen. Alle gegevensmodelvoorwerpen die in het Model van de Gegevens van de Vorm worden toegevoegd worden grijs uit in de ruit van Gegevensbronnen. De Services bevat een lijst met toegevoegde services.
Services tab geeft gegevensmodelservices weer
note note NOTE 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 voor meer informatie Werken met navigatie-eigenschappen van OData-diensten. -
Selecteren Save het formuliermodelobject opslaan.
note note NOTE U kunt services die u hebt geconfigureerd op het tabblad Services van een formuliergegevensmodel, aanroepen met behulp van de regels voor adaptieve formulieren. De gevormde diensten zijn beschikbaar in de Invoke de dienstenactie van de regelredacteur voor meer informatie over het gebruiken van deze diensten in de Aangepaste regels van de Vorm, zie de Diensten van de Invoke en Reeks Waarde van regels in regeleditor.
Gegevensmodelobjecten en onderliggende eigenschappen maken create-data-model-objects-and-child-properties
Gegevensmodelobjecten maken create-data-model-objects
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:
-
Aanmelden bij Experience Manager auteurinstantie, navigeren aan Forms > Data Integrations en opent u het formuliergegevensmodel waarin u een gegevensmodelobject of -entiteit wilt maken.
-
Selecteren Create Entity.
-
In de Create data Model geeft u een naam op voor het gegevensmodelobject en selecteert u 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 child-properties
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:
-
Selecteer in een formuliergegevensmodel een gegevensmodelobject en selecteer Create Child Property.
-
In de Create Child Property een naam en gegevenstype voor de eigenschap op in het dialoogvenster Name en Type respectievelijk velden. U kunt desgewenst een titel en beschrijving voor de eigenschap opgeven.
-
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 voor meer informatie Eigenschappen bewerken.
-
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.
Als u een onderliggende eigenschap handmatig wilt binden met een objecteigenschap van een gegevensmodel, selecteert u het bladerpictogram naast de knop Bind Reference veld. De Select Object worden alle eigenschappen van het bovenliggende gegevensmodelobject weergegeven. Selecteer een eigenschap waarmee u wilt binden en selecteer het verdeelstreeppictogram. U kunt alleen een eigenschap van hetzelfde gegevenstype selecteren als de eigenschap child.
-
Selecteren Done om het kindbezit te bewaren en te selecteren 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 Adaptief Forms blijven maken op basis van het formuliergegevensmodel. Later, wanneer u gegevensbronnen beschikbaar en gevormd hebt, kunt u het Model van de Gegevens van het Vorm met gegevensbronnen binden. De binding wordt automatisch bijgewerkt in gekoppelde Adaptive Forms . Voor meer informatie over het maken van Adaptive Forms formuliergegevensmodel gebruiken, zie Formuliergegevensmodel gebruiken.
Objecten en eigenschappen van gegevensmodellen binden bind-data-model-objects-and-properties
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:
-
Selecteer in het formuliergegevensmodel de niet-gebonden gegevensbron die u met een gegevensbron wilt binden.
-
Selecteren Edit Properties.
-
In de Edit Properties selecteert u het bladerpictogram naast het dialoogvenster Binding veld. Het opent de Select Object dialoogvenster met een lijst met gegevensbronnen die zijn toegevoegd aan het formuliergegevensmodel.
-
Vouw de gegevensbronstructuur uit en selecteer een gegevensmodelobject om mee te binden en selecteer het verdeelstreeppictogram.
-
Selecteren Done om de eigenschappen op te slaan en selecteer vervolgens 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 configure-services
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:
-
Schakel het selectievakje boven aan een gegevensmodelobject in om het te selecteren en selecteer het Edit Properties.
Eigenschappen bewerken om lees- en schrijfservices voor een gegevensmodelobject te configureren
De Edit Properties wordt geopend.
Eigenschappen bewerken, dialoogvenster
note note NOTE 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 OData-servicegegevensbron toevoegt aan een formuliergegevensmodel, is er een service beschikbaar in het formuliergegevensmodel voor alle navigatie-eigenschappen in een gegevensmodelobject. U kunt deze service gebruiken om de navigatie-eigenschappen van het overeenkomende gegevensmodelobject te lezen. Voor meer informatie die de dienst gebruikt, zie Werken met navigatie-eigenschappen van OData-diensten. -
Schakelen Top Level Object 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 in het Data Model Objects tab. Als het geneste gegevensmodel een object op hoofdniveau is, wordt het ook afzonderlijk weergegeven in het dialoogvenster Data Model Objects tab. 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.
-
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
-
Selecteren voor het read-service argument aan bindt het argument aan een Attribuut van het Profiel van de Gebruiker, een Attribuut van het Verzoek, of Letterlijke waarde en geeft u de bindingswaarde op.
-
Selecteren Done om het argument op te slaan, Done om de eigenschappen op te slaan, en vervolgens Save om het formuliergegevensmodel op te slaan.
Bind Read de dienstargumenten bindargument
Bind Gelezen de dienstargument aan een Attribuut van het Profiel van de Gebruiker, een Attribuut van het Verzoek, of Letterlijke waarde die op een bindende waarde wordt gebaseerd. De waarde wordt overgegaan tot de dienst als argument om details te halen verbonden aan de gespecificeerde waarde uit de gegevensbron.
Letterlijke waarde literal-value
Selecteren Literal van de Binding To vervolgkeuzelijst en voer een waarde in in het dialoogvenster Binding Value veld. De details die aan de waarde zijn gekoppeld, worden opgehaald uit de gegevensbron. Gebruik deze optie om details terug te winnen verbonden aan een statische waarde.
In dit voorbeeld worden de details gekoppeld aan 4367655678, als de waarde voor de mobilenum
worden opgehaald uit de gegevensbron. De bijbehorende details als u de waarde voor een mobiel aantalargument overgaat kunnen eigenschappen zoals klantennaam, klantenadres, en stad omvatten.
Kenmerk gebruikersprofiel user-profile-attribute
Selecteren User Profile Attribute van de Binding To drop-down menu en ga de attributennaam in in Binding Value veld. De gegevens van de gebruiker die zich bij de Experience Manager -instantie worden opgehaald uit de gegevensbron op basis van de kenmerknaam.
De kenmerknaam die is opgegeven in het dialoogvenster Binding Value in het veld moet het volledige bindingspad staan tot de kenmerknaam voor de gebruiker. Open de volgende URL om tot de gebruikersdetails op CRXDE toegang te hebben:
https://[server-name]:[port]/crx/de/index.jsp#/home/users/
In dit voorbeeld geeft u profile.empid
in de Binding Value veld voor de grios
gebruiker.
De id
argument neemt de waarde van empid
-kenmerk van het gebruikersprofiel en geef dit als een argument door aan de Leesservice. Het leest en keert waarden van bijbehorende eigenschappen van het voorwerp van het werknemersgegevensmodel voor terug empid
gekoppeld aan de aangemelde gebruiker.
Aanvraagkenmerk request-attribute
Gebruik het verzoekattribuut om de bijbehorende eigenschappen van de gegevensbron terug te winnen.
-
Selecteren Request Attribute van de Binding To drop-down menu en ga de attributennaam in in Binding Value veld.
-
Een bedekking voor head.jsp. Als u de bedekking wilt maken, opent u CRX DE en kopieert u de
https://<server-name>:<port number>/crx/de/index.jsp#/libs/fd/af/components/page2/afStaticTemplatePage/head.jsp
bestand naarhttps://<server-name>:<port number>/crx/de/index.jsp#/apps/fd/af/components/page2/afStaticTemplatePage/head.jsp
note note NOTE - Als u een statische sjabloon gebruikt, bedekt u head.jsp bij:
/libs/fd/af/components/page2/afStaticTemplatePage/head.jsp
- Als u een bewerkbare sjabloon gebruikt, bedekt u de aftemplatedpage.jsp op:
/libs/fd/af/components/page2/aftemplatedpage/aftemplatedpage.jsp
- Als u een statische sjabloon gebruikt, bedekt u head.jsp bij:
-
Set paramMap voor het aanvraagkenmerk. Neem bijvoorbeeld de volgende code op in het .jsp-bestand in de map apps:
code language-javascript <%Map paraMap = new HashMap(); paraMap.put("<request_attribute>",request.getParameter("<request_attribute>")); request.setAttribute("paramMap",paraMap);
Gebruik bijvoorbeeld de onderstaande code om de waarde van petid op te halen uit de gegevensbron:
code language-javascript <%Map paraMap = new HashMap(); paraMap.put("petId",request.getParameter("petId")); request.setAttribute("paramMap",paraMap);%>
De details worden teruggewonnen uit de gegevensbron die op de attributennaam wordt gebaseerd in het verzoek wordt gespecificeerd.
Als u bijvoorbeeld kenmerk opgeeft als petid=100
in de aanvraag worden eigenschappen opgehaald die aan de kenmerkwaarde zijn gekoppeld vanuit de gegevensbron.
Koppelingen toevoegen add-associations
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-op-vele vereniging en afgebeeld door 1:n
op de regel die gekoppelde gegevensmodelobjecten 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:
-
Schakel het selectievakje boven aan een gegevensmodelobject in om het te selecteren en selecteer het Add Association. Het dialoogvenster Koppeling toevoegen wordt geopend.
note note NOTE 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 voor meer informatie Werken met navigatie-eigenschappen van OData-diensten. De Add Association wordt geopend.
Dialoogvenster Koppeling toevoegen
-
In de Add ruit van de Vereniging:
- Geef een titel op voor de koppeling.
- Selecteer het associatietype — One to One of One to Many.
- 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 Afhankelijkheden
dependentid
.Het standaardargument voor de dienst van het lezen van Afhankelijkheden is afhankelijk
Het argument moet echter een gemeenschappelijke eigenschap zijn tussen het gekoppelde gegevensmodelobject, die in dit voorbeeld
Employeeid
. DaaromEmployeeid
argument moet gebonden zijn aan deid
bezit van het de gegevensmodelvoorwerp van de Werknemer om de bijbehorende gebiedsdeeldetails van het het modelvoorwerp van Afhankelijke gegevens te halen.Bijgewerkt argument en binding
Selecteren Done het argument opslaan.
-
Selecteren Done om de vereniging te bewaren en dan Save om het formuliergegevensmodel op te slaan.
-
Herhaal de stappen om desgewenst meer koppelingen te maken.
Eigenschappen bewerken properties
U kunt eigenschappen van gegevensmodelobjecten bewerken, de eigenschappen ervan en de services die zijn toegevoegd aan het formuliergegevensmodel.
Eigenschappen bewerken:
-
Schakel het selectievakje in naast een gegevensmodelobject, een eigenschap of een service in het formuliergegevensmodel.
-
Selecteer Edit Properties. De Edit Properties wordt het deelvenster voor het geselecteerde modelobject, de geselecteerde eigenschap of de geselecteerde service geopend.
-
Data model object: Geef de lees- en schrijfservices op en bewerk argumenten.
-
Property: Geef het type, het 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
-
-
Selecteren Done om eigenschappen op te slaan en vervolgens Save om het formuliergegevensmodel op te slaan.
Berekende eigenschappen maken computed
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 maken FullName waarvan de waarde het resultaat is van samenvoegen van de bestaande FirstName en LastName eigenschappen. Daartoe:
-
Een nieuwe eigenschap met de naam maken
FullName
waarvan het gegevenstype String is. -
Inschakelen Computed en selecteert u 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.
-
Selecteer het bezit FullName en selecteer Edit Rule. Er wordt een regeleditorvenster geopend.
-
Selecteer in het venster van de regeleditor de optie Create. A Set Value regelvenster wordt geopend.
Selecteer in het keuzemenu Optie selecteren de optie Mathematical Expression. Andere beschikbare opties zijn Form Data Model Object en String.
-
Selecteer in de wiskundige expressie de optie FirstName en LastName in respectievelijk eerste en tweede object. Selecteren plus als de operator.
Selecteren Done en selecteer vervolgens Close om het venster van de regelredacteur te sluiten. De regel ziet er ongeveer als volgt uit.
-
Selecteer in het formuliergegevensmodel de optie Save. Het gegevens verwerkte bezit wordt gevormd.
Werken met navigatie-eigenschappen van OData-diensten work-with-navigation-properties-of-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. Bijvoorbeeld in het volgende uittreksel van het meta-gegevensdossier van het steekproef TripPin OData-voorbeeldservices bevat de personenentiteit drie navigatie-eigenschappen: Vrienden, BestFriend en Trips.
Zie voor meer informatie over navigatie-eigenschappen OData-documentatie.
<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 worden de drie navigatie-eigenschappen in de Person
entiteitscontainer kan worden gelezen gebruikend één GET LINK
in het formuliergegevensmodel.
Het volgende benadrukt GET LINK of Person /People
-service in het formuliergegevensmodel. Dit is een gecombineerde service voor de drie navigatie-eigenschappen in het dialoogvenster Person
entiteit van de TripPin OData-dienst.
Wanneer u het GET LINK
De dienst aan het lusje van de Diensten in het Model van de Gegevens van de Vorm, kunt u de eigenschappen uitgeven om het voorwerp van het outputmodel en het navigatie bezit te kiezen in de dienst te gebruiken. Het volgende wordt bijvoorbeeld GET LINK of Person /People
In het volgende voorbeeld wordt Trip gebruikt 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 als BesteVriend (afhankelijk van of Return array? is in- of uitgeschakeld).
Op dezelfde manier kunt u een GET LINK
de dienst en vormt zijn navigatieeigenschappen wanneer het toevoegen van verenigingen in het Model van de Gegevens van de Vorm. Als u echter een navigatie-eigenschap wilt selecteren, moet u ervoor zorgen dat de Binding To field is ingesteld op Literal.
Voorbeeldgegevens genereren en bewerken sample
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:
-
Open een formuliergegevensmodel en selecteer Edit Sample Data. De voorbeeldgegevens worden gegenereerd en weergegeven in het venster Voorbeeldgegevens bewerken.
-
In Edit Sample Data venster, gegevens naar wens bewerken en Save.
Objecten en services van gegevensmodellen testen test-data-model-objects-and-services
Uw model van de Gegevens van het Vorm wordt gevormd maar alvorens het in gebruik te zetten, kunt u willen testen als de gevormde voorwerpen en de diensten van het gegevensmodel zoals verwacht werken. Objecten en services van gegevensmodellen testen:
-
Selecteer een gegevensmodelobject of een service in het formuliergegevensmodel en selecteer Test Model Object of Test Service, respectievelijk.
Het venster Formuliergegevensmodel testen wordt geopend.
-
In de Test Form Data Model Selecteer in het deelvenster Invoer het gegevensmodelobject of de gegevensservice die u wilt testen.
-
Geef een argumentwaarde op in de testcode en selecteer Test. Een geslaagde test retourneert de uitvoer in het deelvenster Uitvoer.
U kunt ook andere gegevensmodelobjecten en -services testen in het formuliergegevensmodel.
Geautomatiseerde validatie van invoergegevens automated-validation-of-input-data
Het formuliergegevensmodel valideert ontvangen gegevens als invoer terwijl de DermisBridge-API wordt aangeroepen (op basis van validatiecriteria die beschikbaar zijn in het formuliergegevensmodel). De validatie is gebaseerd op de ValidationOptions
markering ingesteld in het queryobject dat wordt gebruikt om de API aan te roepen.
De markering kan op om het even welke volgende waarden worden geplaatst:
- VOLLEDIG: FDM voert de validatie uit op basis van alle beperkingen
- UIT: Geen validatie
- BASIC: FDM voert de validatie uit op basis van 'required' en 'nullable' beperkingen
Als er geen waarde is ingesteld voor de ValidationOptions
vlag, BASIC De validatie wordt uitgevoerd op de invoergegevens.
Hier volgt een voorbeeld van het instellen van de validatiemarkering op VOLLEDIG:
operationOptions.setValidationOptions(ValidationOptions.FULL);
Als de waarde niet overeenkomt met het gegevenstype dat voor het kenmerk is gedefinieerd, wordt een uitzondering weergegeven in de DermisBridge-API, ongeacht de waarde van het
ValidationOptions
markering. Als het logboekniveau aan Debug wordt geplaatst, wordt een fout geregistreerd aan error.log bestand.Het formuliergegevensmodel valideert invoergegevens op basis van een lijst met beperkingen voor gegevenstypen. De lijst met beperkingen voor invoergegevens kan variëren op basis van de gegevensbron.
In de volgende tabel worden de beperkingen voor invoergegevens weergegeven die zijn gebaseerd op de gegevensbron:
In dit voorbeeld worden de invoergegevens gevalideerd op basis van maximum-, minimum- en vereiste beperkingen die zijn gedefinieerd in het Swagger-bestand. De invoergegevens voldoen alleen aan de validatiecriteria als Order-id aanwezig is en de waarde 1-10 is.
parameters: [
{
name: "orderId",
in: "path",
description: "ID of pet that must be fetched",
required: true,
type: "integer",
maximum: 10,
minimum: 1,
format: "int64"
}
]
Er wordt een uitzondering weergegeven als de invoergegevens niet voldoen aan de validatiecriteria. Als het logniveau is ingesteld op Foutopsporing, wordt een fout aangemeld bij de error.log bestand. Bijvoorbeeld:
21.01.2019 17:26:37.411 *ERROR* com.adobe.aem.dermis.core.validation.JsonSchemaValidator {"errorCode":"AEM-FDM-001-044","errorMessage":"Input validations failed during operation execution.","violations":{"/orderId":["numeric instance is greater than the required maximum (maximum: 10, found: 16)"]}}
Volgende stappen next-steps
U hebt een werkformuliergegevensmodel dat nu klaar is voor gebruik in Adaptive Forms workflows. Zie voor meer informatie Formuliergegevensmodel gebruiken.