Använd formulärdatamodell use-form-data-model
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
- Skapa interaktiv kommunikation och byggstenar som text, listor och villkorsfragment
- Förgranska interaktiv kommunikation med exempeldata
- Förifyll anpassningsbara formulär och interaktiv kommunikation
- Skriv in data från anpassningsbara formulär i datakällor
- Anropa tjänster med anpassningsbara formulärregler
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:
-
På fliken Formulärmodell på skärmen Lägg till egenskaper väljer du Form Data Model i listrutan Select From.
-
Välj att expandera Select Form Data Model. Alla tillgängliga formulärdatamodeller visas.
Välj en från datamodell.
-
(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.
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.
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.
Fliken Allmänt i dialogrutan Skapa interaktiv kommunikation
Mer information finns i:
Skapa interaktiv kommunikation
Text i interaktiv kommunikation
Villkor i interaktiv kommunikation
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:
- Navigera AEM författarinstansen till Forms > Forms & Documents.
- 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.
- 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.
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.
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.
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.
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:
-
Lägg till ett datamodellsobjekt som innehåller en binär egenskap i formulärdatamodellen.
-
I det adaptiva formuläret drar och släpper du komponenten File Attachment från komponentwebbläsaren till det adaptiva formuläret.
-
Markera den tillagda komponenten och välj för att öppna egenskapsgranskaren för komponenten.
-
I fältet Bindningsreferens väljer du och navigerar till den binära egenskap som du har lagt till i formulärdatamodellen. Konfigurera andra egenskaper efter behov.
Välj om du vill spara egenskaperna. Bilagefältet är nu bundet till den binära egenskapen för formulärdatamodellen.
-
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.
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.