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

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

gegeven-integratie

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 een lid van zowel fdm-auteur en vormen-gebruiker groepen zijn om met het model van vormgegevens te kunnen tot stand brengen en 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. 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 selecteer Add Selected .

    geselecteerd-voorwerpen

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

    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.

    diensten-lusje

    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. Voor meer informatie, zie Werkend met navigatie eigenschappen van de diensten OData.
  4. Selecteer Save om het formuliermodelobject op te slaan.

    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 Vastgestelde Waarde van regels in regelredacteur.

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

    nieuw-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. 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. Voor meer informatie, zie eigenschappenuitgeven.

  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 het gegevensmodel, selecteert u het bladerpictogram naast het veld Bind Reference . In het dialoogvenster 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. Selecteer Done om de onderliggende eigenschap op te slaan en selecteer 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. Voor meer informatie over het creëren van adaptieve vormen en interactieve mededelingen die het model van vormgegevens gebruiken, zie het model van vormgegevens van het Gebruik.

Objecten en eigenschappen van gegevensmodellen binden bind-data-model-objects-and-properties

Wanneer de gegevensbronnen u met het model van vormgegevens wilt integreren beschikbaar zijn, kunt u hen aan het model van vormgegevens toevoegen zoals die in worden beschreven de gegevensbronnen van de Update. 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. Selecteer Edit Properties .

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

    selecteren-voorwerp

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

  5. Selecteer Done om de eigenschappen op te slaan en selecteer vervolgens Save om het gegevensmodel van het formulier op te slaan. Het gegevensmodelobject is nu gebonden aan een gegevensbron. Het gegevensmodelobject is niet meer gemarkeerd als Niet geconsolideerd.

    verbindend-model-voorwerp

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

    geef-eigenschappen uit

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

    Het dialoogvenster Eigenschappen bewerken wordt geopend.

    geef-eigenschappen-2 uit

    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 Werkend met navigatieeigenschappen van de diensten OData.
  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.

    read-write-services

    Lees en schrijf de diensten die voor werknemersgegevensbron worden gevormd

  4. Selecteer aem_6_3_edit voor het gelezen de dienstargument het argument aan een Attribuut van het Profiel van de Gebruiker, een Attribuut van het Verzoek, of Letterlijke waardebinden en de bindende waarde specificeren.

  5. Selecteer Done om het argument op te slaan, Done om de eigenschappen op te slaan en 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

Selecteer Literal in de vervolgkeuzelijst Binding To en voer een waarde in het veld Binding Value in. 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 verbonden aan 4367655678, als waarde voor het mobilenum argument, teruggewonnen 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

Selecteer User Profile Attribute in de vervolgkeuzelijst Binding To en voer in het veld Binding Value de naam van het kenmerk in. 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 in het veld Binding Value wordt opgegeven, moet het volledige bindingspad bevatten 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/

Profiel van de Gebruiker

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

geef Argument uit

Het argument id neemt de waarde van het kenmerk empid van het gebruikersprofiel en geeft dit als een argument door aan de service Read. Het leest en keert waarden van bijbehorende eigenschappen van het voorwerp van het werknemersgegevensmodel voor empid verbonden aan de het programma geopende gebruiker terug.

Aanvraagkenmerk request-attribute

Gebruik het verzoekattribuut om de bijbehorende eigenschappen van de gegevensbron terug te winnen.

  1. Selecteer Request Attribute in de vervolgkeuzelijst Binding To en voer in het veld Binding Value de naam van het kenmerk in.

  2. Creeer een bekledingvoor head.jsp. Als u de overlay wilt maken, opent u CRX DE en kopieert u het bestand https://<server-name>:<port number>/crx/de/index.jsp#/libs/fd/af/components/page2/afStaticTemplatePage/head.jsp 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. Stel paramMap in 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 die aan de kenmerkwaarde zijn gekoppeld, opgehaald uit 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. Deze wordt een-op-een-koppeling genoemd en wordt door 1:n weergegeven 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 Add Association . Het dialoogvenster Koppeling toevoegen wordt geopend.

    toe:voegen-vereniging

    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. Voor meer informatie, zie Werkend met navigatie eigenschappen van de diensten OData.

    Het dialoogvenster Koppeling toevoegen wordt geopend.

    toe:voegen-vereniging-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 dependentid het standaardargument voor de leesservice van het gegevensmodelobject Afhankelijke elementen.

    toe:voegen-vereniging-voorbeeld

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

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

    toe:voegen-vereniging-voorbeeld-2

    Bijgewerkt argument en binding

    Selecteer Done om het argument op te slaan.

  3. Selecteer Done om de koppeling op te slaan en Save om het gegevensmodel van het formulier 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 te selecteren.

toegevoegde-vereniging

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

    • modelvoorwerp van Gegevens: Specificeer de gelezen en schrijf diensten en geef argumenten uit.
    • Bezit: Specificeer het type, sub-type, en formaat voor het bezit. U kunt ook opgeven of de geselecteerde eigenschap de primaire sleutel voor het gegevensmodelobject is.
    • Dienst: Specificeer het voorwerp van het inputmodel, outputtype, en argumenten voor de dienst. Voor de Get dienst, kunt u specificeren als het wordt verwacht om een serie terug te keren.

    geef-eigenschappen-dienst uit

    Dialoogvenster Eigenschappen bewerken voor een get-service

  3. Selecteer Done om eigenschappen op te slaan en Save om het gegevensmodel van het formulier 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.

Bijvoorbeeld, kunt u een gegevens verwerkt bezit FullName tot stand brengen de waarvan waarde een resultaat van aaneenschakeling is de bestaande FirstName en LastName eigenschappen. Daartoe:

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

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

    gegevens verwerkt

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

    gegevens verwerken-pro

  3. Selecteer de eigenschap FullName en selecteer Edit Rule . Er wordt een regeleditorvenster geopend.

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

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

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

    Selecteer Done en selecteer vervolgens Close om het venster voor de regeleditor te sluiten. De regel ziet er ongeveer als volgt uit.

    regel

  6. Selecteer Save in het formuliergegevensmodel. 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 de steekproef TripPinOData steekproefdiensten, bevat de persoonentiteit drie navigatie-eigenschappen - Vrienden, BestFriend, en Reizen.

Voor meer informatie over navigatie eigenschappen, zie {documentatie 0} OData 🔗.

<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 één GET LINK -service in het Formuliergegevensmodel.

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

nav-prop-dienst

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.

geef-prop-nav-prop uit

NOTE
De waarden beschikbaar op het Standaardgebied van de Waarde van de Waarde NavigationPropertyName argument hangen van de staat van de serie van de Terugkeer af? schakelknop. Als deze optie is ingeschakeld, worden navigatie-eigenschappen van het type Verzameling weergegeven.

In dit voorbeeld, kunt u het voorwerp van het outputmodel als Persoon en het argument van het navigatie bezit als Vrienden of BestFriend (afhankelijk van of serie van de Terugkeer? is in- of uitgeschakeld).

uitgeven-prop-nav-prop2

Op dezelfde manier kunt u een GET LINK -service kiezen en de navigatie-eigenschappen configureren wanneer u koppelingen toevoegt aan het formuliergegevensmodel. Nochtans, om een navigatiebezit te kunnen selecteren, zorg ervoor dat Binding To field aan Letterlijk wordt geplaatst.

toe:voegen-vereniging-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.

    produceer de Gegevens van de Steekproef

  2. Bewerk in het Edit Sample Data -venster de vereiste gegevens en selecteer 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. Voor meer informatie, zie het model van vormgegevens van het Gebruik.

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

    Het venster Formuliergegevensmodel testen wordt geopend.

    test-gegeven-model

  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.

    Resultaten van de Test

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 markering ValidationOptions die is 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:

  • ONGELDIG: FDM voert de bevestiging uit die op alle beperkingen wordt gebaseerd
  • VAN: Geen bevestiging
  • BASIC: FDM voert de bevestiging uit die op "vereist"en "nullable"beperkingen wordt gebaseerd

Als geen waarde voor de ValidationOptions vlag wordt geplaatst, BASIC bevestiging wordt uitgevoerd op de inputgegevens.

Het volgende is een voorbeeld om de bevestigingsvlag aan VOLLEDIG te plaatsen:

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 in de DermisBridge-API een uitzondering weergegeven, ongeacht de waarde van de markering ValidationOptions . Als het logboekniveau wordt geplaatst om te zuiveren, wordt een fout geregistreerd aan het {dossier 0} error.log.

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 logboekniveau aan wordt geplaatst zuiveren, wordt een fout geregistreerd aan het {dossier 2} error.log. 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. Voor meer informatie, zie het model van vormgegevens van het Gebruik.

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