Använd formulärdatamodell use-form-data-model

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

dataintegrering

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

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

Skapa adaptiva Forms och fragment create-af

Du kan Adaptiv Forms och adaptiva formulärfragment baserat på en formulärdatamodell. Så här använder du en formulärdatamodell 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 Select From listruta.

    create-af-1-1

  2. Markera för att expandera Select Form Data Model. Alla tillgängliga formulärdatamodeller 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. Expandera Form Data Model Definitions nedrullningsbar meny. Den visar alla datamodellsobjekt i den angivna formulärdatamodellen. Markera ett datamodellsobjekt i listan.

    create-af-3

    När det adaptiva formuläret eller adaptiva formulärfragment som baseras på en formulärdatamodell har skapats visas formulärdatamodellsobjekten i dialogrutan Data Sources i Content Browser i Adaptive Form Editor.

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

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 har en färdig förifyllningstjänst för formulärdatamodell som du kan aktivera för Adaptiv Forms baserat på formulärdatamodell. 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ärdatamodellen för ett adaptivt formulär öppnar du egenskaperna för den adaptiva formulärbehållaren och väljer Form Data Model Prefill service från Prefill Service nedrullningsbar meny 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 kan du konfigurera formuläret så att det skriver skickade data för ett datamodellsobjekt till sina datakällor. För att uppnå detta Experience Manager Forms tillhandahålla Skicka åtgärd för formulärdatamodell, finns endast i körklart läge för Adaptive Forms baserat på en formulärdatamodell. 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 välj Guide Container som ingår i det adaptiva formuläret.

  2. Klicka på egenskaperna för stödlinjebehållaren Stödlinjeegenskaper -ikon. Dialogrutan Adaptiv formulärbehållare öppnas.

  3. Klicka på Submission -fliken.

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

    Åtgärdskonfiguration

  5. Ange Data model to submit.

  6. Klicka 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 formulärdatamodell och en DoR-fil (Document of Record) till datakällan. Mer information om formulärdatamodell finns i AEM Forms Dataintegrering.

NOTE
AEM as a Cloud Service erbjuder olika åtgärder för att skicka in formulär. Du kan läsa mer om de här alternativen i Inlämningsåtgärd för anpassat formulär artikel.

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.

  2. Dra och släpp File Attachment från komponentwebbläsaren till det adaptiva formuläret.

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

  4. I fältet Bindningsreferens väljer du foldersearch_18 och navigera till den binära egenskap som du lade till i formulärdatamodellen. Konfigurera andra egenskaper efter behov.

    Välj check-button för att spara egenskaperna. Bilagefältet är nu bundet till den binära egenskapen för formulärdatamodellen.

  5. Aktivera i delen Skicka i egenskaperna för den adaptiva formulärbehållaren Submit Form Attachments. 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 kan du skapa regler för att anropa tjänster som konfigurerats i formulärdatamodellen. The Invoke Services -åtgärden i en regel listar alla tillgängliga tjänster i formulärdatamodellen och låter dig välja in- och utdatafält för tjänsten. Du kan också använda Set Value regeltyp som anropar en formulärdatamodelltjänst och ställer in värdet för ett fält på 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

Dessutom kan du använda guidelib.dataIntegrationUtils.executeOperation API för att skriva ett JavaScript i kodredigeraren för regelredigeraren.

Anropa en formulärdatamodell 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 lägger du till en formulärdatamodell i 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 Adaptive Form-Level Whitelisting of Form Data Model for Service Invocation - Configuration Factory.
  3. Klicka plus-ikon -ikon för att lägga till konfigurationen.
  4. Lägg till Content path pattern för att ange var din adaptiva Forms finns. 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. Som standard är värdet /content/dams/formsanddocuments-fdm/(.*) som innehåller alla formulärdatamodeller. Du kan också ange sökvägen för en viss formulärdatamodell.
  6. Spara inställningarna.

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

NOTE
Så här anropar du en formulärdatamodell från regelredigeraren med anpassade funktioner via ett AEM-projekt:
  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