Använd formulärdatamodell (FDM) use-form-data-model

Version
Artikellänk
AEM 6.5
Klicka här
AEM as a Cloud Service
Den här artikeln

data-integration

Med dataintegrationen i Experience Manager Forms kan du använda olika backend-datakällor för att skapa en formulärdatamodell (FDM) som du kan använda som schema i olika adaptiva Forms -arbetsflöden. Det kräver att du konfigurerar datakällor och skapar FDM (Form Data Model) baserat på datamodellsobjekt och tjänster som är tillgängliga i datakällor. Mer information finns i följande:

En formulärdatamodell (FDM) är ett tillägg till JSON-schema som du kan använda för att:

Skapa adaptiva Forms och fragment create-af

Du kan skapa anpassningsbara Forms- och adaptiva formulärfragment baserat på en formulärdatamodell (FDM). Så här använder du en FDM (Form Data Model) när du skapar ett adaptivt formulär eller adaptivt formulärfragment:

  1. På fliken Formulärmodell på skärmen Lägg till egenskaper väljer du Form Data Model i listrutan Select From.

    create-af-1-1

  2. Välj att expandera Select Form Data Model. Alla tillgängliga formulärdatamodeller (FDM) visas.

    Välj en från datamodell.

    create-af-2-1

  3. (Endast adaptiva formulärfragment) Du kan skapa ett adaptivt formulärfragment baserat på endast ett datamodellsobjekt i en formulärdatamodell (FDM). Visa listrutan Form Data Model Definitions. Den visar alla datamodellsobjekt i den angivna formulärdatamodellen (FDM). Markera ett datamodellsobjekt i listan.

    create-af-3

    När det adaptiva formuläret eller adaptiva formulärfragment som baseras på en formulärdatamodell (FDM) har skapats visas formulärdatamodellsobjekt på fliken Data Sources i innehållsläsaren i den adaptiva formulärredigeraren.

    note note
    NOTE
    För ett adaptivt formulärfragment visas endast datamodellsobjektet som valts vid redigeringen och tillhörande datamodellsobjekt på fliken Datakällor.

    data-model-objects-tab

    Du kan dra och släppa datamodellsobjekt till det adaptiva formuläret eller fragmentet för att lägga till formulärfält. De tillagda formulärfälten behåller metadataegenskaperna och bindningen med datamodellens objektegenskaper. Bindningen ser till att fältvärdena uppdateras i motsvarande datakällor när formuläret skickas och förifylls när formuläret återges.

Förhandsgranska med exempeldata preview-ic

Med formulärdatamodellsredigeraren kan du generera och redigera exempeldata för datamodellsobjekt i formulärdatamodellen (FDM). Du kan använda dessa data för att förhandsgranska och testa Adaptiv Forms. Du måste generera exempeldata innan du förhandsgranskar enligt beskrivningen i Arbeta med formulärdatamodellen.

Om du vill förhandsgranska ett adaptivt formulär med exempeldata öppnar du det adaptiva formuläret i redigeringsläge och väljer Preview.

Förifyll med tjänsten Formulärdatamodell prefill

Experience Manager Forms tillhandahåller en färdig tjänst för förifyllning av formulärdatamodell som du kan aktivera för Adaptiv Forms baserat på formulärdatamodell (FDM). Förifyllningstjänsten frågar efter datakällor för datamodellobjekt i det adaptiva formuläret och fyller i data i förväg när formuläret eller kommunikationen återges.

Om du vill aktivera förifyllningstjänsten för formulärdatamodell för ett adaptivt formulär öppnar du egenskaperna för den adaptiva formulärbehållaren och väljer Form Data Model Prefill service i listrutan Prefill Service i dragspelsfliken Grundläggande. Spara sedan egenskaperna.

prefill-service

Skriv data i anpassat formulär till datakällor write-af

När en användare skickar ett formulär baserat på en formulärdatamodell (FDM) kan du konfigurera formuläret så att det skriver skickade data för ett datamodellsobjekt till sina datakällor. Experience Manager Forms tillhandahåller åtgärd för att skicka formulärdatamodell, som bara är tillgänglig för Adaptiv Forms baserat på en formulärdatamodell (FDM), för att uppnå det här användningsexemplet. Den skriver skickade data för ett datamodellsobjekt i sin datakälla.

Så här konfigurerar du åtgärden Skicka i formulärdatamodell:

  1. Öppna innehållsläsaren och markera komponenten Guide Container i det adaptiva formuläret.

  2. Klicka på ikonen för egenskaper för stödlinjebehållaren Egenskaper för stödlinje . Dialogrutan Adaptiv formulärbehållare öppnas.

  3. Klicka på fliken Submission.

  4. I listrutan Submit Action väljer du Submit using Form Data Model.

    Åtgärdskonfiguration

  5. Ange Data model to submit.

  6. Klicka på Done

När formuläret skickas skrivs data för det konfigurerade datamodellobjektet till respektive datakälla. Dessutom kan du skicka en bifogad fil med en FDM (Form Data Model) och ett DoR-dokument (Document of Record) till datakällan. Mer information om formulärdatamodell (FDM) finns i AEM Forms Dataintegrering.

NOTE
AEM as a Cloud Service erbjuder olika inskickningsåtgärder för att hantera inskickade formulär. Du kan läsa mer om de här alternativen i artikeln Åtgärd för att skicka anpassade formulär.

Du kan också skicka formulärbilagor till en datakälla med hjälp av objektegenskapen för binär datamodell. Gör följande för att skicka bilagor till en JDBC-datakälla:

  1. Lägg till ett datamodellsobjekt som innehåller en binär egenskap i formulärdatamodellen (FDM).

  2. I det adaptiva formuläret drar och släpper du komponenten File Attachment från komponentwebbläsaren till det adaptiva formuläret.

  3. Markera den tillagda komponenten och välj settings_icon för att öppna egenskapsgranskaren för komponenten.

  4. I fältet Bindningsreferens väljer du foldersearch_18 och navigerar till den binära egenskap som du har lagt till i formulärdatamodellen (FDM). Konfigurera andra egenskaper efter behov.

    Välj bockknapp om du vill spara egenskaperna. Bilagefältet är nu bundet till den binära egenskapen för formulärdatamodellen (FDM).

  5. Aktivera Submit Form Attachments i avsnittet Överföring i egenskaperna för den anpassade formulärbehållaren. Den bifogade filen i fältet för binära egenskaper skickas till datakällan när formuläret skickas.

Anropa tjänster i Adaptive Forms med hjälp av regler invoke-services

I ett adaptivt formulär baserat på en formulärdatamodell (FDM) kan du skapa regler för att anropa tjänster som konfigurerats i formulärdatamodellen (FDM). Åtgärden Invoke Services i en regel visar alla tillgängliga tjänster i FDM (Form Data Model) och gör att du kan välja in- och utdatafält för tjänsten. Du kan också använda regeltypen Set Value för att anropa en formulärdatamodelltjänst och ange värdet för ett fält till utdata som returneras av tjänsten.

I följande regel anropas till exempel en get-tjänst som tar Employee Id som indata och de returnerade värdena fylls i i motsvarande fält för beroende ID, efternamn, förnamn och kön i formuläret.

invoke-service

Du kan dessutom använda API:t guidelib.dataIntegrationUtils.executeOperation för att skriva en JavaScript i kodredigeraren för regelredigeraren.

Anropa en formulärdatamodell (FDM) med anpassade funktioner invoke-form-data-model-using-custom-functions

Du kan anropa en formulärdatamodell från regelredigeraren med anpassade funktioner. Om du vill anropa formulärdatamodellen (FDM) lägger du till en formulärdatamodell till tillåtelselista. Så här lägger du till en formulärdatamodell i en lista över tillåtna:

  1. Gå till webbkonsolen Experience Manager på https://server:host/system/console/configMgr.
  2. Sök efter Adaptive Form-Level Whitelisting of Form Data Model for Service Invocation - Configuration Factory.
  3. Klicka på ikonen plus för att lägga till konfigurationen.
  4. Lägg till Content path pattern för att ange platsen för din adaptiva Forms. Som standard är värdet /content/forms/af/(.*), som innehåller alla adaptiva Forms. Du kan också ange sökvägen för ett visst anpassat formulär.
  5. Lägg till Form Data Model path pattern för att ange platsen för formulärdatamodellen (FDM). Som standard är värdet /content/dams/formsanddocuments-fdm/(.*), som innehåller alla formulärdatamodeller (FDM). Du kan också ange sökvägen för en viss formulärdatamodell (FDM).
  6. Spara inställningarna.

Den tillagda konfigurationen sparas under alternativet Adaptive Form-Level Whitelisting of Form Data Model for Service Invocation - Configuration Factory.

NOTE
Så här anropar du en formulärdatamodell (FDM) från regelredigeraren med anpassade funktioner via ett AEM arkivtypsprojekt:
  1. Skapa en konfigurationsfil.
  2. Ange egenskaper för getContentPathPattern och getFormDataModelPathPattern.
  3. Distribuera projektet.

Relaterade artiklar

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab