Lägga till datamodellsobjekt och -tjänster

Om du har skapat en formulärdatamodell (FDM) 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 (FDM) och -tjänsterna.

Du kan lägga till datamodellsobjekt och -tjänster från tillgängliga datakällor i formulärdatamodellen (FDM). 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å Experience Manager-författarinstansen, navigera till Forms > Data Integrations och öppna den formulärdatamodell där 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 (FDM) och välj Add Selected.

    selected-objects

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

    model-tab

    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.

    services-tab

    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.
  4. Välj Save om du vill spara formulärmodellobjektet.

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

Skapa datamodellsobjekt och underordnade egenskaper

Skapa datamodellsobjekt

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

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

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

  2. Välj Create Entity.

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

    new-entity

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

Lägg till underordnade egenskaper

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:

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

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

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

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

När du har skapat datamodellsobjekt och -egenskaper kan du fortsätta att skapa Adaptiv Forms baserat på formulärdatamodellen (FDM). När du har datakällor tillgängliga och konfigurerade kan du senare binda formulärdatamodellen (FDM) till datakällor. Bindningen uppdateras automatiskt i associerad adaptiv Forms . Mer information om hur du skapar adaptiv Forms med hjälp av formulärdatamodell (FDM) finns i Använd formulärdatamodell.

Binda datamodellsobjekt och egenskaper

När datakällorna som du vill integrera med formulärdatamodellen (FDM) är tillgängliga kan du lägga till dem i formulärdatamodellen (FDM) 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. Välj Edit Properties.

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

    select-object

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

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

    bound-model-object

Konfigurera tjänster

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 välj Edit Properties.

    edit-properties

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

    Dialogrutan Edit Properties öppnas.

    edit-properties-2

    Dialogrutan Redigera egenskaper

    OBSERVERA
    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.
  2. 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.

  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. Välj aem_6_3_edit som lästjänstargument om du vill binda argumentet till ett användarprofilattribut, begärandeattribut eller litteralvärde och ange bindningsvärdet.

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

Bind Läs tjänsteargument

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

Välj Literal i listrutan Binding To och ange ett värde i fältet Binding Value. 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 hämtas informationen som är associerad med 436765678 som värde för argumentet mobilenum 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.

Litteralt värde

Attribut för användarprofil

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

Attributnamnet som anges i fältet Binding Value 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/

Användarprofil

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

Redigera argument

Argumentet id tar värdet för attributet empid för användarprofilen och skickar det som ett argument till lästjänsten. Den läser och returnerar värden för associerade egenskaper från medarbetardatamodellobjektet för empid som är associerad med den inloggade användaren.