Werken met formuliergegevensmodel work-with-form-data-model

Versie
Artikelkoppeling
AEM as a Cloud Service
Klik hier
AEM 6,5
Dit artikel

gegevensintegratie

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 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.

NOTE
U moet lid zijn van beide fdm-auteur en formuliergebruiker groepen die in staat zijn om een formuliergegevensmodel te maken en ermee te werken. Neem contact op met de AEM beheerder om lid te worden van de groepen.

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

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. Log in de AEM auteur instantie, navigeer naar Forms > Data Integrations en opent u 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 selecteer Add Selected.

    selected-objects

    Geselecteerde gegevensmodelobjecten en services

    note note
    NOTE
    Als uw Forms-gegevensmodel een object bevat dat een gereserveerd trefwoord is voor uw relationele database, kan dit leiden tot problemen met het toevoegen, bijwerken of ophalen van gegevens. Vermijd dus het gebruik van dergelijke objecten in uw formuliergegevensmodel.

    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.

    model-tab

    Tabblad Model geeft toegevoegde gegevensmodelobjecten weer

    note note
    NOTE
    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.

    services-tab

    Op het tabblad Services worden services voor gegevensmodellen weergegeven

    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.
  4. 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 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 ReeksWaarde 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:

  1. Log in de AEM auteur instantie, navigeer naar Forms > Data Integrations en opent u het formuliergegevensmodel waarin u een gegevensmodelobject of -entiteit wilt maken.

  2. Selecteren Create Entity.

  3. Geef in het dialoogvenster Gegevensmodel maken een naam op voor het gegevensmodelobject en selecteer 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.

    nieuwe entiteit

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:

  1. Selecteer in een formuliergegevensmodel een gegevensmodelobject en selecteer Create Child Property.

  2. 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.

  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 voor meer informatie Eigenschappen bewerken.

  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.

    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. Merk op dat u slechts een bezit van het zelfde gegevenstype zoals het kindbezit kunt selecteren.

  5. 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 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 voor meer informatie over het maken van adaptieve formulieren en interactieve communicatie met behulp van het formuliergegevensmodel 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:

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

  2. Selecteren Edit Properties.

  3. 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.

    select-object

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

  5. 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.

    bound-model-object

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:

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

    bewerken-eigenschappen

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

    Het dialoogvenster Eigenschappen bewerken wordt geopend.

    edit-properties-2

    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 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.
    Voor meer informatie die de dienst gebruikt, zie Werken met navigatie-eigenschappen van OData-diensten.
  2. 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 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.

    read-write-services

    Lees en schrijf de diensten die voor werknemersgegevensbron worden gevormd

  4. Selecteren aem_6_3_edit 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.

  5. 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.

Letterlijke waarde

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 details van de gebruiker die aan de AEM instantie het programma wordt geopend worden teruggewonnen uit de gegevensbron die op de attributennaam wordt gebaseerd.

De kenmerknaam die is opgegeven in het dialoogvenster Binding Value in het veld moet het volledige bindingspad zijn opgenomen totdat de kenmerknaam voor de gebruiker wordt ingevuld. Open de volgende URL om tot de gebruikersdetails op CRXDE toegang te hebben:

https://[server-name]:[port]/crx/de/index.jsp#/home/users/

Gebruikersprofiel

In dit voorbeeld geeft u profile.empid in de Binding Value veld voor de grios gebruiker.

Argument bewerken

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.

  1. Selecteren Request Attribute van de Binding To drop-down menu en ga de attributennaam in in Binding Value veld.

  2. 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 naar https://<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
  3. 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.

NOTE
Vooraf gedefinieerde koppelingen in een JDBC-gegevensbron blijven niet behouden in het formuliergegevensmodel. Maak ze handmatig.

Een koppeling toevoegen:

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

    add-association

    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.

    Het dialoogvenster Koppeling toevoegen wordt geopend.

    add-association-2

    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 Afhankelijkheden dependentid.

    add-association-example

    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. Daarom Employeeid argument moet gebonden zijn aan de id bezit van het de gegevensmodelvoorwerp van de Werknemer om de bijbehorende gebiedsdeeldetails van het het modelvoorwerp van Afhankelijke gegevens te halen.

    addAssociation-example-2

    Bijgewerkt argument en binding

    Selecteren Done het argument opslaan.

  3. Selecteren Done om de vereniging te bewaren en dan Save om het formuliergegevensmodel op te slaan.

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

NOTE
De toegevoegde koppeling wordt in het vak met gegevensmodelobjecten weergegeven met de opgegeven titel en een regel die de bijbehorende gegevensmodelobjecten verbindt.
U kunt een koppeling bewerken door het desbetreffende selectievakje in te schakelen en Edit Association.

associatie met toegevoegde waarde

Eigenschappen bewerken properties

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. Selecteer Edit Properties. De Edit Properties wordt het deelvenster voor het geselecteerde modelobject, de geselecteerde eigenschap of de geselecteerde service geopend.

    • Object gegevensmodel: Geef de lees- en schrijfservices op en bewerk argumenten.
    • Eigenschap: 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.

    edit-properties-service

    Dialoogvenster Eigenschappen bewerken voor een get-service

  3. 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:

  1. Een eigenschap met de naam maken FullName waarvan het gegevenstype String is.

  2. Inschakelen Computed en selecteert u Done om de eigenschap te maken.

    berekend

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

    berekend-pro

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

  4. 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.

  5. 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.

    regel

  6. 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.

nav-prop-service

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.

edit-prop-nav-prop

NOTE
De waarden die beschikbaar zijn in de Standaardwaarde van het NavigationPropertyName het argument hangt af van de toestand van de Array retourneren? schakelknop. Als deze optie is ingeschakeld, worden navigatie-eigenschappen van het type Verzameling weergegeven.

In dit voorbeeld kunt u het uitvoermodelobject ook kiezen als argument voor personen- en navigatie-eigenschappen als Vrienden of als BesteVriend (afhankelijk van of Array retourneren? is in- of uitgeschakeld).

edit-prop-nav-prop2

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 Letterlijk.

add-association-nav-prop

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:

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

    Voorbeeldgegevens genereren

  2. In Edit Sample Data venster, gegevens naar wens bewerken en 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 voor meer informatie Formuliergegevensmodel gebruiken.

Objecten en services van gegevensmodellen testen test-data-model-objects-and-services

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 selecteer Test Model Object of Test Service, respectievelijk.

    Het venster Formuliergegevensmodel testen wordt geopend.

    testgegevensmodel

  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 selecteer Test. Een geslaagde test retourneert de uitvoer in het deelvenster Uitvoer.

    Testresultaten

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

Geautomatiseerde validatie van invoergegevens automated-validation-of-input-data

Het formuliergegevensmodel valideert de gegevens die zijn ontvangen 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 ValidationOptionsvlag, BASIC De validatie wordt uitgevoerd op de invoergegevens.

Hier volgt een voorbeeld van het instellen van de validatiemarkering op VOLLEDIG:

operationOptions.setValidationOptions(ValidationOptions.FULL);
NOTE
De waarde die u opgeeft voor een kenmerk in de invoergegevens, moet overeenkomen met het gegevenstype dat is gedefinieerd voor het kenmerk in het metagegevensdocument.
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:

Restricties
Beschrijving
Invoergegevensbron
vereist
Indien waar (true), moet de parameter in de invoergegevens worden opgenomen.
Swagger, WSDL en database
nullable
Indien true, kan de waarde voor de parameter op Null worden ingesteld in de invoergegevens.
WSDL, Odata en database
maximum
Geeft de bovengrens voor numerieke waarden aan. De maximumwaarde die als bovengrens wordt opgegeven, kan ook worden toegewezen aan de parameter in de invoergegevens.
Tagger en WSDL
minimum
Hiermee geeft u de ondergrens voor numerieke waarden op. De minimumwaarde die als ondergrens wordt opgegeven, kan ook worden toegewezen aan de parameter in de invoergegevens.
Tagger en WSDL
ExclusiveMaximum
Geeft de bovengrens voor numerieke waarden aan. De maximumwaarde die als bovengrens wordt opgegeven, mag niet worden toegewezen aan de parameter in de invoergegevens.
Tagger en WSDL
alleenstaandeMinimum
Hiermee geeft u de ondergrens voor numerieke waarden op. De minimumwaarde die als ondergrens wordt opgegeven, mag niet worden toegewezen aan de parameter in de invoergegevens.
Tagger en WSDL
minLength
Geeft de ondergrens op voor het aantal tekens dat in een tekenreeks wordt opgenomen. De minimumwaarde die als ondergrens wordt opgegeven, kan ook worden toegewezen aan de parameter in de invoergegevens.
Tagger en WSDL
maxLength
Geeft de bovengrens op voor het aantal tekens dat in een tekenreeks wordt opgenomen. De maximumwaarde die als bovengrens wordt opgegeven, kan ook worden toegewezen aan de parameter in de invoergegevens.
Swagger, WSDL, Odata en database
patroon
Geeft een vaste reeks tekens aan. De invoertekenreeks wordt alleen gevalideerd als de tekens voldoen aan het opgegeven patroon.
Swagger
minItems
Geeft het minimale aantal items in een array op. De minimumwaarde die als ondergrens wordt opgegeven, kan ook worden toegewezen aan de parameter in de invoergegevens.
Tagger en WSDL
maxItems
Geeft het maximale aantal items in een array op. De maximumwaarde die als bovengrens wordt opgegeven, kan ook worden toegewezen aan de parameter in de invoergegevens.
Tagger en WSDL
uniqueItems
Indien waar (true), moeten alle elementen van de array uniek zijn in de invoergegevens.
Swagger
enum (tekenreeks)
Beperkt de waarde van een parameter in de invoergegevens tot een vaste set tekenreekswaarden. Het moet een array zijn met ten minste één element, waarbij elk element uniek is.
WSDL en Odata
enum (getal)
Hiermee wordt de waarde van een parameter in de invoergegevens beperkt tot een vaste set numerieke waarden. Het moet een array zijn met ten minste één element, waarbij elk element uniek is.
WSDL

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 tussen 1 en 10 ligt.

   parameters: [
   {
   name: "orderId",
   in: "path",
   description: "ID of pet that needs to 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 adaptieve formulieren en interactieve communicatieworkflows. Zie voor meer informatie Formuliergegevensmodel gebruiken.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2