DokumentationAEM 6.4Användarhandbok om Forms

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

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • User
CAUTION
AEM 6.4 har nått slutet på den utökade supporten och denna dokumentation är inte längre uppdaterad. Mer information finns i teknisk supportperiod. Hitta de versioner som stöds här.

Med dataintegrering kan du konfigurera och arbeta med formulärdatamodeller.

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 datamodellsobjektsegenskaper som du kan använda för att förifylla adaptiva formulär och interaktiv kommunikation när du förhandsgranskar. Du kan testa datamodellsobjekt och tjänster som konfigurerats i en formulärdatamodell för att säkerställa 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 för mer information om olika åtgärder och konfigurationer som du kan utföra med formulärdatamodellens redigerare.

NOTE
Du måste vara medlem i båda fdm-author och formuläranvändare grupper för att kunna skapa och arbeta med formulärdatamodell. Kontakta AEM om du vill bli medlem i grupperna.

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 datatjä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:

  1. Logga in på AEM författarinstans, navigera till Forms > Data Integrations och öppna den formulärdatamodell i vilken du vill lägga till datamodellsobjekt.

  2. Expandera datakällor i rutan Datakällor för att visa tillgängliga datamodellsobjekt och tjänster.

  3. Markera datamodellsobjekt och tjänster som du vill lägga till i formulärdatamodellen och tryck Add Selected.

    selected-objects

    På fliken Modell visas en grafisk representation av alla datamodellsobjekt och deras egenskaper som lagts till i formulärdatamodellen. Varje datamodellobjekt representeras av en ruta i formulärdatamodellen.

    model-tab

    note note
    NOTE
    Du kan hålla kvar och dra runt datamodellsobjektrutor för att ordna dem i innehållsområdet. Alla datamodellsobjekt som läggs till i formulärdatamodellen är nedtonade i rutan Datakällor.

    Fliken Tjänster visar tillagda tjänster.

    services-tab

    note note
    NOTE
    Förutom datamodellsobjekt och -tjänster innehåller OData-tjänstens metadatadokument navigeringsegenskaper som definierar associationen mellan två datamodellsobjekt. Mer information finns i Arbeta med navigeringsegenskaper för OData-tjänster.

  4. Tryck Save för att spara formulärmodellobjektet.

    note note
    NOTE
    Du kan anropa tjänster som du har konfigurerat på fliken Tjänster i en formulärdatamodell med hjälp av adaptiva formulärregler. De konfigurerade tjänsterna är tillgängliga i åtgärden Anropa tjänster i regelredigeraren Mer information om hur du använder dessa tjänster i adaptiva formulärregler finns i Anropa tjänster och Ange värdet för regler i regelredigerare.

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 också 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:

  1. Logga in på AEM författarinstans, navigera till Forms > Data Integrations och öppna den formulärdatamodell i vilken du vill skapa ett datamodellsobjekt eller en datamodell.

  2. Tryck på Create Entity.

  3. I dialogrutan Skapa datamodell anger du ett namn för datamodellobjektet och trycker på Add. Ett datamodellsobjekt läggs till i formulärdatamodellen. Observera att det nya datamodellsobjektet inte är bundet till en datakälla och inte har några egenskaper som visas i följande bild.

    new-entity

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

Lägg till underordnade egenskaper child-properties

Med formulärdatamodellredigeraren 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:

  1. Markera ett datamodellsobjekt i en formulärdatamodell och tryck på Create Child Property.

  2. I Create Child Property anger du ett namn och en datatyp för egenskapen i dialogrutan Name och Type fält. Du kan också ange en titel och en beskrivning för egenskapen.

  3. Aktivera beräknad om egenskapen är en beräknad egenskap. Värdet för en beräknad egenskap utvärderas baserat på en regel eller ett uttryck. Mer information finns i Redigera egenskaper.

  4. Om datamodellobjektet är bundet till en datakälla, binds den tillagda underordnade egenskapen automatiskt till egenskapen för det överordnade datamodellobjektet med samma namn och datatyp.

    Om du vill binda en underordnad egenskap manuellt med en datamodellsobjektegenskap trycker du på bläddringsikonen bredvid Bind Reference fält. The Select Object visas alla egenskaper från det överordnade datamodellobjektet. Välj en egenskap som du vill binda med och tryck på bockikonen. Observera att du bara kan välja en egenskap av samma datatyp som den underordnade egenskapen.

  5. Tryck Done för att spara egenskapen child och trycka Save för att spara formulärdatamodellen… Egenskapen child läggs nu till i datamodellsobjektet.

När du har skapat datamodellsobjekt och egenskaper kan du fortsätta att skapa anpassningsbara formulär och interaktiv kommunikation 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 formulär och interaktiv kommunikation. Mer information om hur du skapar adaptiva formulär och interaktiv kommunikation med hjälp av formulärdatamodell finns i 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:

  1. Välj den obundna datakälla som du vill binda till en datakälla i formulärdatamodellen.

  2. Tryck på Edit Properties.

  3. I Edit Properties trycker du på bläddringsikonen bredvid Binding fält. Den öppnar Select Object som visar datakällor som lagts till i formulärdatamodellen.

    select-object

  4. Expandera trädet för datakällor och markera ett datamodellsobjekt som du vill binda med och tryck på ikonen för att kryssa.

  5. Tryck Done för att spara egenskaperna och sedan trycka Save för att spara formulärdatamodellen. Datamodellobjektet är nu bundet till en datakälla. Observera att datamodellobjektet inte längre är markerat som Obundet.

    bound-model-object

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:

  1. Markera kryssrutan högst upp i ett datamodellsobjekt för att markera det och trycka på Edit Properties.

    edit-properties

    Redigera egenskaper för att konfigurera läs- och skrivtjänster för ett datamodellsobjekt

    Dialogrutan Redigera egenskaper öppnas.

    edit-properties-2

    Dialogrutan Redigera egenskaper

    note note
    NOTE
    Förutom datamodellsobjekt och -tjänster innehåller OData-tjänstens metadatadokument navigeringsegenskaper som definierar associationen mellan två datamodellsobjekt. När du lägger till en OData-tjänstdatakälla i en formulärdatamodell finns det en tjänst tillgänglig i formulärdatamodellen för alla navigeringsegenskaper i ett datamodellsobjekt. Du kan använda den här tjänsten för att läsa navigeringsegenskaperna för motsvarande datamodellsobjekt.
    Mer information om hur du använder tjänsten finns i Arbeta med navigeringsegenskaper för OData-tjänster.

  2. Växla Top Level Object för att ange om datamodellobjektet är ett modellobjekt på den översta nivån.

    Datamodellsobjekt som har konfigurerats i en formulärdatamodell är tillgängliga för användning på fliken Datamodellsobjekt i innehållsläsaren för ett adaptivt formulär baserat på formulärdatamodellen. När du lägger till en association mellan två datamodellsobjekt kapslas datamodellsobjektet som du associerar med under datamodellsobjektet på fliken Datamodellsobjekt. Om den kapslade datamodellen är ett objekt på den översta nivån visas den också separat på fliken Datamodellsobjekt. Därför kommer du att se två poster i den, en inuti och en utanför den kapslade hierarkin, vilket kan förvirra formulärförfattarna. Om du vill att det associerade datamodellsobjektet bara ska visas i den kapslade hierarkin inaktiverar du egenskapen Objekt på översta nivån.

  3. Välj Läs- och skrivtjänster för de markerade datamodellsobjekten. Argumenten för tjänsterna visas.

    read-write-services

    Läs- och skrivtjänster har konfigurerats för personaldatakälla

  4. Tryck aem_6_3_edit för lästjänstargumentet för att binda argumentet till ett användarprofilattribut, begärandeattribut eller litteralvärde och ange bindningsvärdet. Det binder tjänstargumentet till det angivna bindningsattributet eller det literala värdet, som 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.

    I det här exemplet id argumentet får värdet av empid användarprofilens attribut och skicka det som ett argument till lästjänsten. Det läser och returnerar värden för associerade egenskaper från employee datamodellobjekt för den angivna empid. Om du anger 00250 i dialogrutan empid i formuläret kommer lästjänsten att läsa information om medarbetaren med 00250 employee id.

    Du kan dessutom göra ett argument obligatoriskt eller valfritt.

    edit-argument

    Binda id-argumentet till empid-attributet för AEM användarprofil

  5. Tryck Done för att spara argumentet, Done för att spara egenskaperna och sedan Save för att spara formulärdatamodellen.

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.

NOTE
Fördefinierade associationer i en JDBC-datakälla sparas inte i formulärdatamodellen. Du måste skapa dem manuellt.

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

  1. Markera kryssrutan högst upp i ett datamodellsobjekt för att markera det och trycka på Add Association. Dialogrutan Lägg till association öppnas.

    add-association

    note note
    NOTE
    Förutom datamodellsobjekt och -tjänster innehåller OData-tjänstens metadatadokument navigeringsegenskaper som definierar associationen mellan två datamodellsobjekt. Du kan använda de här navigeringsegenskaperna när du lägger till associationer i formulärdatamodellen. Mer information finns i Arbeta med navigeringsegenskaper för OData-tjänster.

    Dialogrutan Lägg till association öppnas.

    add-association-2

    Dialogrutan Lägg till association

  2. I rutan Lägg till association:

    • Ange en titel för associationen.
    • Välj associationstyp - en till en eller en till många.
    • Markera datamodellsobjektet som du vill associera med.
    • Markera lästjänsten för att läsa data från det markerade modellobjektet. Lästjänstargumentet visas. Redigera om du vill ändra argumentet, om det behövs, och binda det till egenskapen för datamodellobjektet som ska associeras.

    I följande exempel är standardargumentet för läsningstjänsten för datamodellobjektet Beroende dependentid.

    add-association-example

    Standardargumentet för tjänsten för läsning av beroenden är beroendestyrt

    Argumentet måste dock vara en vanlig egenskap mellan det associerade datamodellobjektet, vilket i det här exemplet är Employeeid. Därför är Employeeid argument måste bindas till id egenskapen för Employee-datamodellobjektet för att hämta associerade beroendedetaljer från datamodellobjektet Dependents.

    add-association-example-2

    Uppdaterat argument och bindning

    Tryck Done för att spara argumentet.

  3. Tryck Done för att spara associationen och sedan Save för att spara formulärdatamodellen.

  4. Upprepa stegen för att skapa fler associationer efter behov.

NOTE
Den tillagda kopplingen visas i datamodellens objektruta med den angivna titeln och en linje som förbinder de associerade datamodellsobjekten.
Du kan redigera en association genom att markera kryssrutan mot den och trycka på Edit Association.

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

  1. Markera kryssrutan bredvid ett datamodellsobjekt, en egenskap eller en tjänst i formulärdatamodellen.

  2. Tryck på Edit Properties. The Edit Properties för det valda modellobjektet, egenskapen eller tjänsten öppnas.

    • Datamodellsobjekt: Ange läs- och skrivtjänster och redigeringsargument.
    • Egenskap: Ange typ, undertyp och format för egenskapen. Du kan också ange om den valda egenskapen är primärnyckeln för datamodellobjektet.
    • Tjänst: Ange tjänstens indatamodell, utdatatyp och argument. För en Get-tjänst kan du ange om den förväntas returnera en array.

    edit-properties-service

    Dialogrutan Redigera egenskaper för en get-tjänst

  3. Tryck Done för att spara egenskaper och sedan Save för att spara formulärdatamodellen.

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:

  1. Skapa en ny egenskap med namnet FullName vars datatyp är String.

  2. Aktivera Computed och trycka Done för att skapa egenskapen.

    beräknad

    Den beräknade egenskapen FullName skapas. Lägg märke till ikonen bredvid egenskapen för att avbilda en beräknad egenskap.

    computed-prop

  3. Välj egenskapen FullName och tryck på Edit Rule. Ett regelredigeringsfönster öppnas.

  4. I regelredigeringsfönstret trycker du på Create. A Set Value regelfönstret öppnas.

    I listrutan Välj alternativ väljer du Mathematical Expression. Andra tillgängliga alternativ är Form Data Model Object och String.

  5. I det matematiska uttrycket väljer du FirstName och LastName i första och andra objektet. Välj plus som -operatorn.

    Tryck Done och sedan trycka Close för att stänga regelredigeringsfönstret. Regeln ser ut ungefär så här.

    regel

  6. Tryck på Save. Den beräknade egenskapen är konfigurerad.

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.

nav-prop-service

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.

edit-prop-nav-prop

NOTE
De värden som finns i Default Value fält för NavigationPropertyName -argumentet beror på läget för Return array? växlingsknapp. När den är aktiverad visas navigeringsegenskaper av samlingstyp.

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

edit-prop-nav-prop2

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.

add-association-nav-prop

Generera och redigera exempeldata sample

Med formulärdatamodellredigeraren 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:

  1. Öppna en formulärdatamodell och tryck Edit Sample Data. Den genererar och visar exempeldata i fönstret Redigera exempeldata.

    sample-data

  2. I Edit Sample Data fönster, redigera data efter behov och trycka Save.

Därefter kan du använda exempeldata för att fylla i och testa interaktiv kommunikation i förväg baserat på formulärdatamodellen. Mer information finns i Använd formulärdatamodell.

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:

  1. Markera ett datamodellsobjekt eller en tjänst i formulärdatamodellen och tryck Test Model Object eller Test Service, respektive.

    Fönstret Testa formulärdatamodell öppnas.

    test-data-model

  2. I fönstret Testa formulärdatamodell väljer du datamodellsobjektet eller datatjänsten som ska testas i rutan Indata.

  3. Ange ett argumentvärde i testkoden och tryck på Test. Ett lyckat test returnerar utdata i utdatapanelen.

    test-data-model-2

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

Nästa steg next-steps

Du har en arbetsmodell för formulärdata som nu är klar att användas i anpassningsbara formulär och arbetsflöden för interaktiv kommunikation. Mer information finns i Använd formulärdatamodell.

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da