Werken met FDM (Form Data Model) work-with-form-data-model

De redacteur van het Model van de Gegevens van de vorm (FDM) verstrekt een intuïtieve gebruikersinterface en hulpmiddelen om een model van vormgegevens (FDM) uit te geven en te vormen. Met behulp van de editor kunt u gegevensmodelobjecten, eigenschappen en services toevoegen en configureren vanuit gekoppelde gegevensbronnen in het formuliergegevensmodel (FDM). 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 eigenschappen van gegevensmodelobjecten die u kunt gebruiken om adaptieve Forms vooraf in te vullen tijdens het weergeven van een voorbeeld. U kunt gegevensmodelvoorwerpen en de diensten testen die in een Model van de Gegevens van de Vorm (FDM) worden gevormd om ervoor te zorgen het behoorlijk met gegevensbronnen wordt geïntegreerd.

Als u voor de gegevensintegratie van Forms nieuw bent en geen gegevensbron hebt gevormd of een model van vormgegevens (FDM) gecreeerd, zie de volgende onderwerpen:

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 (FDM) met gegevensbronnen creeerde, kunt u de Modelredacteur 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 van de Gegevens van de Vorm (FDM) en de diensten te testen.

U kunt gegevensmodelvoorwerpen en de diensten van beschikbare gegevensbronnen in het model van vormgegevens (FDM) 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:

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. Het is vooral nuttig als u geen gegevensbronnen in het model van vormgegevens (FDM) hebt gevormd.

Een gegevensmodelobject maken zonder gegevensbronnen:

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:

Nadat u gegevensmodelobjecten en -eigenschappen hebt gemaakt, kunt u blijven werken aan het maken van adaptieve Forms op basis van het formuliergegevensmodel (FDM). Later, wanneer u gegevensbronnen beschikbaar en gevormd hebt, kunt u het Model van de Gegevens van de Vorm (FDM) met gegevensbronnen binden. De binding wordt automatisch bijgewerkt in gekoppelde Adaptive Forms . Voor meer informatie over het creëren van Adaptieve Forms gebruikend het model van vormgegevens (FDM), 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 de Gegevens van de Vorm (FDM) wilt integreren beschikbaar zijn, kunt u hen aan het Model van de Gegevens van de Vorm (FDM) 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:

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:

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.

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 bij de Experience Manager instantie is aangemeld, worden opgehaald uit de gegevensbron op basis van de kenmerknaam.

De kenmerknaam die in het veld Binding Value wordt opgegeven, moet het volledige bindpad 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/

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

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.

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 (FDM), blijven de koppelingen behouden en worden ze weergegeven als verbonden door pijllijnen. U kunt koppelingen tussen gegevensmodelobjecten op verschillende gegevensbronnen toevoegen in een formuliergegevensmodel (FDM).

Een koppeling toevoegen:

Eigenschappen bewerken properties

U kunt eigenschappen van gegevensmodelvoorwerpen, hun eigenschappen, en de diensten uitgeven die in het model van vormgegevens (FDM) worden toegevoegd.

Eigenschappen bewerken:

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 (FDM).

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:

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 dienst OData in een Model van de Gegevens van de Vorm (FDM) vormt, worden alle navigatie eigenschappen in een entiteitcontainer beschikbaar door de dienst in het Model van de Gegevens van de Vorm (FDM). 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 Form Data Model (FDM).

In het volgende voorbeeld wordt de service GET LINK of Person /People in het Form Data Model (FDM) gemarkeerd. Dit is een gecombineerde service voor de drie navigatie-eigenschappen in de Person -entiteit van de TripPin OData-service.

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

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

Op dezelfde manier kunt u een GET LINK -service kiezen en de navigatie-eigenschappen configureren wanneer u koppelingen toevoegt aan het FDM (Form Data Model). Als u echter een navigatie-eigenschap wilt selecteren, moet u ervoor zorgen dat de waarde Binding To field is ingesteld op Literal .

Voorbeeldgegevens genereren en bewerken sample

Met de FDM-editor (Form Data Model) kunt u voorbeeldgegevens genereren voor alle eigenschappen van gegevensmodelobjecten, inclusief berekende eigenschappen, in een formuliergegevensmodel (FDM). 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:

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

Uw Model van de Gegevens van de Vorm (FDM) 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:

Op dezelfde manier kunt u andere gegevensmodelvoorwerpen en de diensten in het model van vormgegevens (FDM) testen.

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

Het formuliergegevensmodel (FDM) 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 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:

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);

Het model van de Gegevens van de Vorm (FDM) bevestigt inputgegevens die op een lijst van gegevenstypebeperkingen worden gebaseerd. 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 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 tijdelijk formuliergegevensmodel (FDM) dat nu klaar is voor gebruik in Adaptive Forms -workflows. Voor meer informatie, zie het model van vormgegevens van het Gebruik (FDM).