Arbeta med formulärdatamodell work-with-form-data-model

Formulärdatamodellredigeraren har ett intuitivt användargränssnitt och verktyg för att redigera och konfigurera en formulärdatamodell. Med redigeraren kan du lägga till och konfigurera datamodellsobjekt, egenskaper och tjänster från associerade datakällor i formulärdatamodellen. Dessutom kan du skapa datamodellsobjekt och -egenskaper utan datakällor och binda dem till respektive datamodellsobjekt och egenskaper senare. Du kan också generera och redigera exempeldata för datamodellsobjektegenskaper som du kan använda för att fylla i adaptiv Forms vid förhandsgranskning. Du kan testa datamodellsobjekt och tjänster som konfigurerats i en formulärdatamodell för att se till att den är korrekt integrerad med datakällor.

Om du inte har använt dataintegrering med Forms tidigare och inte har konfigurerat någon datakälla eller skapat en formulärdatamodell kan du läsa följande avsnitt:

Läs vidare om du vill ha mer information om olika åtgärder och konfigurationer som du kan utföra med formulärdatamodellredigeraren.

Lägga till datamodellsobjekt och -tjänster add-data-model-objects-and-services

Om du har skapat en formulärdatamodell med datakällor kan du använda redigeraren för formulärdatamodellen för att lägga till datamodellsobjekt och -tjänster, konfigurera deras egenskaper, skapa associationer mellan datamodellsobjekt och testa formulärdatamodellen och -tjänsterna.

Du kan lägga till datamodellsobjekt och datatjänster från tillgängliga datakällor i formulärdatamodellen. När nya datamodellsobjekt visas på fliken Modell visas tillagda tjänster på fliken Tjänster.

Så här lägger du till datamodellsobjekt och -tjänster:

Skapa datamodellsobjekt och underordnade egenskaper create-data-model-objects-and-child-properties

Skapa datamodellsobjekt create-data-model-objects

Du kan lägga till datamodellsobjekt från konfigurerade datakällor, men du kan även skapa datamodellsobjekt eller -enheter utan datakällor. Det är särskilt användbart om du inte har konfigurerat datakällor i formulärdatamodellen.

Så här skapar du ett datamodellsobjekt utan datakällor:

Därefter kan du lägga till underordnade egenskaper i obundna datamodellsobjekt.

Lägg till underordnade egenskaper child-properties

Med formulärdatamodellsredigeraren kan du skapa underordnade egenskaper i ett datamodellsobjekt. Egenskapen när den skapas är inte bunden till någon egenskap i en datakälla. Du kan senare binda den underordnade egenskapen med en annan egenskap i det innehållande datamodellobjektet.

Så här skapar du en underordnad egenskap:

När du har skapat datamodellsobjekt och -egenskaper kan du fortsätta skapa Adaptiv Forms baserat på formulärdatamodellen. När du har datakällor tillgängliga och konfigurerade kan du senare binda formulärdatamodellen till datakällor. Bindningen uppdateras automatiskt i tillhörande adaptiva Forms . Mer information om hur du skapar Adaptive Forms använda formulärdatamodell, se Använd formulärdatamodell.

Binda datamodellsobjekt och egenskaper bind-data-model-objects-and-properties

När datakällorna som du vill integrera med formulärdatamodellen är tillgängliga kan du lägga till dem i formulärdatamodellen enligt beskrivningen i Uppdatera datakällor. Gör sedan följande för att binda obundna datamodellsobjekt och egenskaper:

Konfigurera tjänster configure-services

Så här konfigurerar du läs- och skrivtjänster för att läsa och skriva data för ett datamodellsobjekt:

Bind Läs tjänsteargument bindargument

Bind lästjänstargumentet till ett användarprofilattribut, begärandeattribut eller litteralvärde baserat på ett bindningsvärde. Värdet skickas till tjänsten som ett argument för att hämta information som är associerad med det angivna värdet från datakällan.

Litteralt värde literal-value

Välj Literal från Binding To och ange ett värde i listrutan Binding Value fält. Information som är associerad med värdet hämtas från datakällan. Använd det här alternativet om du vill hämta information som är kopplad till ett statiskt värde.

I det här exemplet är informationen som är kopplad till 4367655678, som värdet för mobilenum -argument hämtas från datakällan. Den associerade informationen om du skickar värdet för ett mobilnummerargument kan innehålla egenskaper som kundnamn, kundadress och ort.

Attribut för användarprofil user-profile-attribute

Välj User Profile Attribute från Binding To nedrullningsbar meny och ange attributnamnet i Binding Value fält. Information om användaren som är inloggad på Experience Manager -instansen hämtas från datakällan baserat på attributnamnet.

Attributnamnet som anges i Binding Value fältet måste innehålla den fullständiga bindningssökvägen till användarens attributnamn. Öppna följande URL för att komma åt användarinformationen på CRXDE:

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

I det här exemplet anger du profile.empid i Binding Value fält för grios användare.

The id argumentet har värdet för empid användarprofilens attribut och skicka det som ett argument till tjänsten Read. Den läser och returnerar värden för associerade egenskaper från medarbetardatamodellobjektet för empid associeras med den inloggade användaren.

Begär attribut request-attribute

Använd attributet request för att hämta associerade egenskaper från datakällan.

Informationen hämtas från datakällan baserat på attributnamnet som anges i begäran.

Ange till exempel attribut som petid=100 i begäran hämtar egenskaper som är associerade med attributvärdet från datakällan.

Lägg till associationer add-associations

Vanligtvis finns det kopplingar mellan datamodellsobjekt i en datakälla. Associationen kan vara en-till-en eller en-till-många. Det kan till exempel finnas flera beroenden som är kopplade till en medarbetare. Det kallas en-till-många-association och framställs av 1:n på den linje som förbinder associerade datamodellsobjekt. Om en association returnerar ett unikt medarbetarnamn för ett givet medarbetar-ID kallas den en-till-en-association.

När du lägger till associerade datamodellobjekt i en datakälla i en formulärdatamodell behålls deras associationer och visas som kopplade med pilrader. Du kan lägga till associationer mellan datamodellsobjekt över olika datakällor i en formulärdatamodell.

Så här lägger du till en association:

Redigera egenskaper properties

Du kan redigera egenskaper för datamodellsobjekt, deras egenskaper och tjänster som lagts till i formulärdatamodellen.

Så här redigerar du egenskaper:

Skapa beräknade egenskaper computed

En beräknad egenskap är den vars värde beräknas baserat på en regel eller ett uttryck. Med hjälp av en regel kan du ange värdet för en beräknad egenskap till en litteral sträng, ett tal, resultatet av ett matematiskt uttryck eller värdet för en annan egenskap i formulärdatamodellen.

Du kan till exempel skapa en beräknad egenskap FullName vars värde är ett resultat av sammanfogning av den befintliga FirstName och LastName egenskaper. Så här gör du:

Arbeta med navigeringsegenskaper för OData-tjänster work-with-navigation-properties-of-odata-services

I OData-tjänster används navigeringsegenskaper för att definiera associationer mellan två datamodellsobjekt. Dessa egenskaper definieras för en entitetstyp eller en komplex typ. I följande utdrag från metadatafilen för exemplet TripPin Exempeltjänster för OData, personenheten innehåller tre navigeringsegenskaper - Vänner, BestFriend och Resor.

Mer information om navigeringsegenskaper finns i OData-dokumentation.

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

När du konfigurerar en OData-tjänst i en formulärdatamodell blir alla navigeringsegenskaper i en entitetsbehållare tillgängliga via en tjänst i formulärdatamodellen. I det här exemplet på tjänsten TripPin OData finns tre navigeringsegenskaper i Person enhetsbehållaren kan läsas med en GET LINK i formulärdatamodellen.

Följande visar GET LINK of Person /People i formulärdatamodellen, som är en kombinerad tjänst för de tre navigeringsegenskaperna i Person enhet för TripPin OData-tjänsten.

När du har lagt till GET LINK på fliken Tjänster i formulärdatamodellen kan du redigera egenskaperna för att välja utdatamodellsobjektet och navigeringsegenskapen som ska användas i tjänsten. Till exempel följande GET LINK of Person /People i följande exempel används Trip som utdatamodell och navigeringsegenskapen som Trips.

I det här exemplet kan du även välja utdatamodellsobjektet som Person och navigeringsegenskapsargument som Friends eller BestFriend (beroende på om Return array? är aktiverat eller inaktiverat).

På samma sätt kan du välja en GET LINK och konfigurera navigeringsegenskaperna när du lägger till associationer i formulärdatamodellen. För att kunna välja en navigeringsegenskap måste du dock se till att Binding To field är inställd på Literal.

Generera och redigera exempeldata sample

Med formulärdatamodellsredigeraren kan du generera exempeldata för alla datamodellsobjektsegenskaper, inklusive beräknade egenskaper, i en formulärdatamodell. Det är en uppsättning slumpmässiga värden som överensstämmer med den datatyp som konfigurerats för varje egenskap. Du kan också redigera och spara data, som behålls även om du genererar om exempeldata.

Så här genererar och redigerar du exempeldata:

Testa datamodellsobjekt och -tjänster test-data-model-objects-and-services

Din formulärdatamodell är konfigurerad, men innan den används kanske du vill testa om de konfigurerade datamodellsobjekten och -tjänsterna fungerar som förväntat. Så här testar du datamodellsobjekt och -tjänster:

På samma sätt kan du testa andra datamodellsobjekt och -tjänster i formulärdatamodellen.

Automatisk validering av indata automated-validation-of-input-data

Formulärdatamodellen validerar data som tas emot som indata när DermisBridge API anropas (baserat på de valideringskriterier som finns i formulärdatamodellen). Valideringen baseras på ValidationOptions flaggan som angetts i frågeobjektet som används för att anropa API:t.

Flaggan kan anges med något av följande värden:

Om inget värde har angetts för ValidationOptionsflagga, GRUNDLÄGGANDE validering utförs på indata.

Följande är ett exempel på hur du ställer in valideringsflaggan på HELT:

operationOptions.setValidationOptions(ValidationOptions.FULL);

Formulärdatamodellen validerar indata baserat på en lista över datatypsbegränsningar. Listan med begränsningar för indata kan variera beroende på datakällan.

I följande tabell visas begränsningarna för indata baserat på datakällan:

I det här exemplet valideras indata baserat på maximala, minimala och obligatoriska begränsningar som definieras i Swagger-filen. Indata uppfyller bara valideringskriterierna om Order Id finns och dess värde är mellan 1 och 10.

   parameters: [
   {
   name: "orderId",
   in: "path",
   description: "ID of pet that must be fetched",
   required: true,
   type: "integer",
   maximum: 10,
   minimum: 1,
   format: "int64"
   }
   ]

Ett undantag visas om indata inte uppfyller valideringskriterierna. Om loggnivån är inställd på Felsök, loggas ett fel på error.log -fil. Exempel:

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)"]}}

Nästa steg next-steps

Du har en fungerande formulärdatamodell som nu kan användas i Adaptiv Forms arbetsflöden. Mer information finns i Använd formulärdatamodell.