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

hero-image

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 anpassningsbara formulär och adaptiva 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 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ärdatamodellsobjekt i Data Model Objects i Content Browser i adaptive form editor.

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

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 markera Web Channel, Print Channel, eller Both Channels för att förhandsgranska interaktiv kommunikation.
  3. I förhandsgranskningen [kanal] se till att Test Data of Form Data Model är markerat och markerat Preview.

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

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. AEM Forms tillhandahåller Skicka-åtgärd för formulärdatamodell, som finns att tillgå direkt för anpassningsbara 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 från listrutan Skicka åtgärd under dragspelsfliken. Bläddra och välj sedan ett datamodellsobjekt på Name of the data model object to submit nedrullningsbar meny. Spara egenskaperna.

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

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

I ett anpassningsbart 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 Ange värde regeltyp som anropar en datamodelltjänst för formulär 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. API-information finns i API för att anropa datamodelltjänst för formulär.

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