Arbeta med FDM (Form Data Model)

Logga in på Experience Manager-författarinstansen, navigera till Forms > Data Integrations och öppna den formulärdatamodell där du vill lägga till datamodellsobjekt.

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

Markera datamodellsobjekt och -tjänster som du vill lägga till i formulärdatamodellen (FDM) och välj Add Selected.

Markerade datamodellsobjekt och datatjänster

Fliken Model visar en grafisk representation av alla datamodellsobjekt och deras egenskaper som har lagts till i formulärdatamodellen (FDM). Varje datamodellobjekt representeras av en ruta i formulärdatamodellen (FDM).

Fliken Model visar nya datamodellsobjekt

OBSERVERA

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 (FDM) är nedtonade i rutan Datakällor.

Fliken Services visar tillagda tjänster.

Fliken Services visar datamodelltjänster

OBSERVERA

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.

Välj Save om du vill spara formulärmodellobjektet.

NOTE

Du kan anropa tjänster som du har konfigurerat på fliken Tjänster i en formulärdatamodell (FDM) med hjälp av reglerna för adaptiva formulär. 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 regler för adaptiva formulär finns i Anropa tjänster och Ange värdet för regler i regelredigeraren.

Logga in på Experience Manager-författarinstansen, navigera till Forms > Data Integrations och öppna den formulärdatamodell (FDM) i vilken du vill skapa ett datamodellsobjekt eller en datamodell.

Välj Create Entity.

I dialogrutan Create data Model anger du ett namn för datamodellobjektet och väljer Add. Ett datamodellsobjekt läggs till i formulärdatamodellen (FDM). Det nya datamodellsobjektet är inte bundet till en datakälla och har inga egenskaper som visas i följande bild.

Markera ett datamodellsobjekt i en formulärdatamodell och välj Create Child Property.

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

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.

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 väljer du bläddringsikonen bredvid fältet Bind Reference. I dialogrutan Select Object visas alla egenskaper från det överordnade datamodellobjektet. Välj en egenskap som du vill binda med och markera kryssruteikonen. Du kan bara välja en egenskap av samma datatyp som den underordnade egenskapen.

Välj Done för att spara den underordnade egenskapen och välj Save för att spara formulärdatamodellen (FDM). Egenskapen child läggs nu till i datamodellsobjektet.

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

Välj Edit Properties.

I rutan Edit Properties väljer du bläddringsikonen bredvid fältet Binding. Den öppnar dialogrutan Select Object med en lista över datakällor som lagts till i formulärdatamodellen (FDM).

Expandera trädet för datakällor och markera ett datamodellsobjekt som du vill binda med, och markera kryssruteikonen.

Välj Done för att spara egenskaperna och välj sedan 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.

Markera kryssrutan högst upp i ett datamodellsobjekt för att markera det och välj Edit Properties.

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

Dialogrutan Edit Properties öppnas.

Dialogrutan Redigera egenskaper

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 (FDM) finns det en tjänst tillgänglig i formulärdatamodellen (FDM) 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.

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

Datamodellsobjekt som konfigurerats i en formulärdatamodell (FDM) är tillgängliga för användning på fliken Datamodellsobjekt i innehållsläsaren för ett anpassat formulär baserat på formulärdatamodellen (FDM). När du lägger till en association mellan två datamodellsobjekt kapslas datamodellsobjektet som du associerar med under datamodellsobjektet på fliken Data Model Objects. Om den kapslade datamodellen är ett objekt på den översta nivån visas den också separat på fliken Data Model Objects. Därför ser du 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.

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

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

Välj som lästjänstargument om du vill binda argumentet till ett användarprofilattribut, begärandeattribut eller litteralvärde och ange bindningsvärdet.

Välj Done om du vill spara argumentet, Done om du vill spara egenskaperna och sedan Save om du vill spara formulärdatamodellen (FDM).

Välj Request Attribute i listrutan Binding To och ange attributnamnet i fältet Binding Value.

Skapa en övertäckning för head.jsp. Om du vill skapa övertäckningen öppnar du CRX DE och kopierar filen https://<server-name>:<port number>/crx/de/index.jsp#/libs/fd/af/components/page2/afStaticTemplatePage/head.jsp till https://<server-name>:<port number>/crx/de/index.jsp#/apps/fd/af/components/page2/afStaticTemplatePage/head.jsp

NOTE

• Om du använder en statisk mall ska du täcka över head.jsp på:
  /libs/fd/af/components/page2/afStaticTemplatePage/head.jsp
• Om du använder en redigerbar mall ska du täcka över den eftermalledpage.jsp som:
  /libs/fd/af/components/page2/aftemplatedpage/aftemplatedpage.jsp

Ange paramMap för attributet request. Ta till exempel med följande kod i .jsp-filen i mappen apps:

<%Map paraMap = new HashMap();
 paraMap.put("<request_attribute>",request.getParameter("<request_attribute>"));
 request.setAttribute("paramMap",paraMap);

Använd till exempel följande kod för att hämta värdet för petid från datakällan:

<%Map paraMap = new HashMap();
paraMap.put("petId",request.getParameter("petId"));
request.setAttribute("paramMap",paraMap);%>

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

Välj Edit Properties. Edit Properties-rutan för det valda modellobjektet, egenskapen eller tjänsten öppnas.

• Data model object: Ange läs- och skrivtjänster och redigeringsargument.

• Property: Ange typ, undertyp och format för egenskapen. Du kan också ange om den valda egenskapen är primärnyckeln för datamodellobjektet.

• Service: Ange tjänstens indatamodell, utdatatyp och argument. För en Get-tjänst kan du ange om den förväntas returnera en array.

  

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

Välj Done om du vill spara egenskaper och sedan Save om du vill spara formulärdatamodellen (FDM).

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

Aktivera Computed och välj Done för att skapa egenskapen.

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

Markera egenskapen FullName och välj Edit Rule. Ett regelredigeringsfönster öppnas.

Välj Create i regelredigeringsfönstret. Ett Set Value-regelfönster öppnas.

Välj Mathematical Expression i listrutan Välj alternativ. Andra tillgängliga alternativ är Form Data Model Object och String.

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

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

Välj Save i formulärdatamodellen (FDM). Den beräknade egenskapen är konfigurerad.

Öppna en formulärdatamodell (FDM) och välj Edit Sample Data. Den genererar och visar exempeldata i fönstret Redigera exempeldata.

I fönstret Edit Sample Data redigerar du data efter behov och väljer Save.

Markera ett datamodellsobjekt eller en tjänst i formulärdatamodellen (FDM) och välj Test Model Object respektive Test Service.

Fönstret Testa formulärdatamodell öppnas.

I fönstret Test Form Data Model väljer du datamodellsobjektet eller datatjänsten som ska testas från indatapanelen.

Ange ett argumentvärde i testkoden och välj Test. Ett lyckat test returnerar utdata i utdatapanelen.