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

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

hjältebild

Med AEM Forms dataintegrering kan ni använda olika backend-datakällor för att skapa en formulärdatamodell som du kan använda som schema i olika adaptiva formulär och interaktiva kommunikationsarbetsflöden. Det kräver att du konfigurerar datakällor och skapar formulärdatamodell som baseras 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 anpassningsbara formulär och fragment create-af

Du kan skapa anpassningsbara formulär och anpassningsbara formulärfragment baserat på en formulärdatamodell. Gör så här om du vill använda 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 listrutan Select From.

    create-af-1-1

  2. Välj 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. Visa listrutan Form Data Model Definitions. 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ärdatamodellsobjekt på fliken Data Model Objects i innehållsläsaren i en adaptiv formulärredigerare.

NOTE
För ett adaptivt formulärfragment visas endast det datamodellsobjekt som valts vid redigeringen och tillhörande datamodellsobjekt på fliken Datamodellsobjekt.

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.

Skapa interaktiv kommunikation create-ic

Du kan skapa en interaktiv kommunikation baserad på en formulärdatamodell som du kan använda för att förifylla interaktiv kommunikation med data från konfigurerade datakällor. Dessutom kan byggstenarna i en interaktiv kommunikation, som text, lista och villkorsdokumentfragment, baseras på en formulärdatamodell.

Du kan välja en formulärdatamodell när du skapar en interaktiv kommunikation eller ett dokumentfragment. Följande bild visar fliken Allmänt i dialogrutan Skapa interaktiv kommunikation.

create-ic

Fliken Allmänt i dialogrutan Skapa interaktiv kommunikation

Mer information finns i:

Skapa interaktiv kommunikation

Text i interaktiv kommunikation

Villkor i interaktiv kommunikation

Listfragment

Förhandsgranska med exempeldata preview-ic

Med formulärdatamodellens redigerare 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 interaktiv kommunikation och anpassningsbara formulär. Generera exempeldata innan du förhandsgranskar enligt beskrivningen i Arbeta med formulärdatamodellen.

Så här förhandsgranskar du en interaktiv kommunikation med exempelformulärdata:

  1. Navigera AEM författarinstansen till Forms > Forms & Documents.
  2. Välj en interaktiv kommunikation och välj Preview i verktygsfältet för att välja Web Channel, Print Channel eller Both Channels för att förhandsgranska den interaktiva kommunikationen.
  3. Kontrollera att Test Data of Form Data Model är markerat och välj Preview i dialogrutan Förhandsgranska [kanal].

Den interaktiva kommunikationen öppnas med förfyllda exempeldata.

webbförhandsvisning

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

Förifyll med formulärdatamodelltjänst prefill

AEM Forms tillhandahåller förifyllningstjänsten för formulärdatamodell som är färdig att användas och som du kan aktivera för adaptiva formulär och interaktiv kommunikation baserat på formulärdatamodell. förifyllningstjänsten frågar efter datakällor för datamodellobjekt i det adaptiva formuläret och interaktiv kommunikation 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 dragspelet Grundläggande. Spara sedan egenskaperna.

prefill-service

Om du vill konfigurera förifyllningstjänsten för formulärdatamodell i en interaktiv kommunikation kan du välja förifyllningstjänst för formulärdatamodell i listrutan Förifyll tjänst när du skapar den eller senare genom att ändra egenskaperna.

edit-ic-props

Dialogrutan Redigera egenskaper för en interaktiv kommunikation

Skriv data från anpassade 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å det här användningsexemplet tillhandahåller AEM Forms skicka-åtgärden för formulärdatamodellen, som bara är tillgänglig utan uppdatering för adaptiva formulär baserade på en formulärdatamodell. Den skriver skickade data för ett datamodellsobjekt i sin datakälla.

Om du vill konfigurera skickaåtgärden för formulärdatamodellen öppnar du egenskaper för adaptiv formulärbehållare och väljer Submit using Form Data Model i listrutan Skicka åtgärd under dragspelsfliken. Bläddra och välj sedan ett datamodellsobjekt i listrutan Name of the data model object to submit. Spara egenskaperna.

När formuläret skickas skrivs data för det konfigurerade datamodellobjektet till respektive datakälla.

skicka data

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

  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 anpassningsbara formulär med hjälp av regler invoke-services

I ett anpassat formulär som baseras på en formulärdatamodell kan du skapa regler för att anropa tjänster som konfigurerats i formulärdatamodellen. Åtgärden Invoke Services i en regel visar alla tillgängliga tjänster i formulärdatamodellen 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 ställa 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

Du kan dessutom använda API:t guidelib.dataIntegrationUtils.executeOperation för att skriva en JavaScript i kodredigeraren för regelredigeraren. API-information finns i API för att anropa formulärdatamodelltjänsten.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2