Introduktion till utveckling av anpassningsbara formulär introduction-to-authoring-adaptive-forms
Ökning overview
Med adaptiva formulär kan du skapa formulär som är engagerande, responsiva, dynamiska och anpassningsbara. AEM Forms har ett intuitivt användargränssnitt och färdiga komponenter för att skapa och arbeta med anpassningsbara formulär. Du kan välja att skapa ett anpassat formulär baserat på en formulärmodell eller ett schema eller utan en formulärmodell. Det är viktigt att du noga väljer den formulärmodell som inte bara passar dina behov, utan som utökar dina befintliga infrastrukturinvesteringar och resurser. Du kan välja mellan följande alternativ för att skapa ett anpassat formulär:
-
Använda en formulärdatamodell
Med dataintegrering kan du integrera entiteter och tjänster från olika datakällor i en formulärdatamodell som du kan använda för att skapa anpassade formulär. Välj formulärdatamodell om det adaptiva formulär du skapar inbegriper hämtning och skrivning av data från och till flera datakällor. -
Använda en XDP-formulärmall
Det är en idealisk formulärmodell om du har investeringar i XFA- eller XDP-formulär. Det är ett direkt sätt att konvertera XFA-baserade formulär till anpassningsbara formulär. Alla befintliga XFA-regler behålls i de tillhörande adaptiva formulären. De färdiga adaptiva formulären har stöd för XFA-konstruktioner, till exempel valideringar, händelser, egenskaper och mönster. -
Använda en XSD (XML Schema Definition) eller ett JSON-schema
XML- och JSON-scheman representerar den struktur i vilken data produceras eller förbrukas av organisationens serversystem. Du kan koppla schemat till ett anpassat formulär och använda dess element för att lägga till dynamiskt innehåll i det anpassningsbara formuläret. Elementen i schemat kommer att vara tillgängliga för användning på fliken Datamodellobjekt i innehållsläsaren när du redigerar adaptiva formulär. -
Använda ingen eller utan formulärmodell
Anpassningsbara formulär som skapas med det här alternativet använder inte någon formulärmodell. Data-XML som genereras från sådana formulär har en platt struktur med fält och motsvarande värden.
Mer information om hur du skapar ett anpassat formulär finns i Skapa ett anpassat formulär.
Gränssnitt för redigering av anpassningsbara formulär adaptive-form-authoring-ui
Det pekoptimerade användargränssnittet för att skapa anpassningsbara formulär är intuitivt och ger:
- Dra-och-släpp-funktioner
- Standardformulärkomponenter
- Integrerad databas för resurser
När du skapar eller redigerar ett befintligt anpassat formulär använder du följande gränssnittselement:
A. Sidpanelen B. Sidverktygsfältet C. Sidan Adaptivt formulär
Sidebar sidebar
Med sidofältet
- Se formulärinnehåll som paneler, komponenter, fält och layout.
- Redigera komponentegenskaper.
- Sök, visa och använd resurser i din AEM DAM-databas (Digital Asset Management).
- Lägg till komponenter i formuläret.
A. Innehållsläsaren B. Egenskapsläsaren C. Assets-webbläsaren D. Komponentwebbläsaren
Sidlisten innehåller följande webbläsare:
-
Innehållsläsaren
I innehållsläsaren ser du-
Formulärobjekt
Visar objekthierarkin för formuläret. Författaren kan navigera till en viss formulärkomponent genom att trycka på det elementet i formulärobjektträdet. Författaren kan söka efter objekt och ordna om dem från det här trädet. -
Datamodellsobjekt
Här kan du se formulärmodellens hierarki.
Du kan dra och släppa formulärmodellelement i det anpassade formuläret. De tillagda elementen konverteras automatiskt till formulärkomponenter samtidigt som deras ursprungliga egenskaper behålls. Du kan se datamodellsobjekt när formuläret använder XML-schema, JSON-schema eller XDP-mall.
-
-
Egenskapsläsaren
Gör att du kan redigera egenskaperna för en komponent. Egenskaperna ändras enligt en komponent. Så här visar du egenskaper för den adaptiva formulärbehållaren:
Markera en komponent, välj > Adaptive Form Container och välj sedan .
-
Assets webbläsare
Segmenterar olika typer av innehåll som bilder, dokument, sidor, filmer och så vidare.
-
Komponentwebbläsaren
Innehåller komponenter som du kan använda för att skapa ett anpassat formulär. Du kan dra komponenter från till det adaptiva formuläret för att lägga till formulärelement och konfigurera tillagda element enligt kraven. I följande tabell beskrivs komponenterna i komponentwebbläsaren.
Bästa tillvägagångssätt vid arbete med komponenter best-practices
Här följer några tips och viktiga saker du bör komma ihåg när du arbetar med adaptiva formulärkomponenter:
-
Varje komponent har tillhörande egenskaper som styr dess utseende och funktion. Om du vill konfigurera egenskaperna för en komponent markerar du komponenten och väljer för att öppna komponentegenskaperna i egenskapsläsaren.
-
En komponent identifieras med sitt elementnamn. När du väljer kan du ändra komponentens namn genom att ändra fältvärdet Element Name i egenskapsläsaren. Endast bokstäver, siffror, bindestreck (-) och understreck (_) godkänns i fältet Elementnamn. Andra specialtecken tillåts inte och elementnamnet måste börja med en bokstav.
-
Du kan ändra egenskapen Title för en adaptiv formulärkomponent infogad i formulärredigeraren utan att öppna egenskapsgranskaren så länge titeln visas i formuläret. Så här gör du:
-
Välj det här alternativet om du vill markera en komponent som har en Title-egenskap och vars Hide title-egenskap är inaktiverad.
-
Markera om du vill göra titeln redigerbar.
-
Ändra titeln och välj returtangenten eller markera var som helst utanför komponenten för att spara ändringarna. Markera Esc om du vill ignorera ändringarna.
-
-
Vissa adaptiva formulärkomponenter som e-post och telefon innehåller färdiga valideringsmönster. Du kan dock ange anpassad validering genom att uppdatera fältet Validation Pattern under dragspelsfliken Mönster i komponentegenskaperna. Mer information om standardvalideringar finns i komponentbeskrivningarna i tabellen ovan.
-
Anpassningsbara formulärfält, t.ex. Numerisk ruta och E-post, kan konfigureras så att de innehåller speciella indatatyper för HTML5. När de här fälten är i fokus på mobila enheter och surfplattor visas särskilda alfabet, siffror och tecken som används ofta för att mata in information i fälten. Det gör det lättare för användarna att ange information snabbt utan att behöva växla mellan teckenuppsättningar på knappsatsen. Om du vill tillåta specialiserade indata för en komponent aktiverar du kryssrutan Use HTML Type Number i komponentegenskaperna.
-
Du kan aktivera en textrutekomponent för att acceptera RTF. Om du vill aktivera RTF-text för en textruta aktiverar du kryssrutan Allow Rich Text i komponentegenskaperna.
-
Du kan aktivera komponenterna Textruta, E-post och Telefon för att autofylla värden för fält som namn, adress, kreditkort, telefon och e-post från informationen som lagras i webbläsarens autofyllningsinställningar. Om du vill aktivera den här funktionen väljer du Enable Autofill i komponentegenskaperna och väljer en Autofill Attribute. När en användare fyller i ett anpassat formulär föreslås värdena från profilen för automatisk ifyllning i webbläsaren eller baserat på de värden som användaren tidigare fyllt i. Observera att Autofyll fungerar om autofyllningsinställningarna i användarens webbläsare är aktiverade.
-
Ange värden för alternativknappar och kryssruteobjekt i formatet
{value}={text}
i komponentegenskaperna. -
Komponenten för bifogad fil tillåter som standard endast användare att bifoga en fil. Du kan dock konfigurera komponentegenskaperna så att de stöder flera bifogade filer. Om en användare dessutom bifogar flera filer med samma filnamn kan de bifogade filerna orsaka problem. Därför rekommenderar vi att du kopplar en unik identifierare till varje bifogad fil när formuläret skickas. Så här gör du:
- På din AEM Forms-server går du till Adobe Experience Manager > Tools > Operations > Web Console.
- Sök efter och välj Adaptive Forms Configuration Service.
- Aktivera Make File Names Unique i dialogrutan Adaptiv Forms Configuration Service. Som standard är den inaktiverad.
-
Om du vill att användare ska kunna koppla ett PDF med Safari-webbläsaren måste du se till att application/pdf läggs till i egenskapen Filtyper som stöds i den bifogade filkomponenten. Anpassningsbara formulär som har skapats med en tidigare version av AEM Forms kan innehålla .pdf i stället för application/pdf i egenskapen Filtyper som stöds.
Mer information om adaptiva formulär finns i Bästa tillvägagångssätt för att arbeta med adaptiva formulär.
Verktygsfältet Sida page-toolbar
Verktygsfältet längst upp på sidan innehåller alternativ som gör att du kan förhandsgranska formuläret, ändra formuläregenskaper och redigera formulärlayouten. Du kan förhandsgranska formuläret när du redigerar det och göra ändringar i det. I verktygsfältet visas:
-
Växla sidopanel : Här kan du visa eller dölja sidopanel.
-
Sidinformation : Här kan du visa sidegenskaper, publicera/avpublicera ett formulär, starta ett formulärarbetsflöde och öppna formuläret i klassiskt gränssnitt.
-
Emulator : Gör att du kan emulera formulärutseendet för olika visningsstorlekar som surfplattor och telefoner.
-
Redigera: Gör att du kan välja andra lägen, till exempel: Edit, Style, Developer och Design.
-
Redigera: Gör att du kan redigera egenskaperna för formuläret och dess komponenter. Du kan till exempel lägga till en komponent, släppa en bild och ange obligatoriska fält.
-
Stil: Gör att du kan formatera utseendet på komponenter i formuläret. I stilläge kan du till exempel markera en panel och ange dess bakgrundsfärg.
-
Utvecklare: Låter en utvecklare:
- Upptäck vad formulären består av.
- Felsök vad som händer var och när, vilket i sin tur hjälper till att lösa problem.
-
Design. Gör att du kan aktivera eller inaktivera anpassade komponenter eller komponenter som inte finns med i sidofältet.
-
-
Förhandsgranska: Du kan förhandsgranska hur formuläret ser ut när du publicerar det.
Komponentverktygsfältet component-toolbar
När du markerar en komponent visas ett verktygsfält där du kan arbeta med den. Du får alternativ för att klippa ut, klistra in, flytta och ange egenskaper för komponenterna. Dina alternativ är:
S.Konfigurera: När du väljer Configure visas komponentegenskaperna i sidofältet. Om du konfigurerar dessa egenskaper kan du anpassa datainhämtningen. Du kan ändra komponentens elementnamn och ange etikettexten i komponentens rubrikfält. Med elementnamnet kan du hämta värden som användarna anger med komponenten. I komponentegenskaperna anger du komponentens beteende och hanterar användarindata. Konfigurera egenskaperna i sidofältet för att hämta användardata och använda dem för vidare bearbetning. Med egenskaper för adaptiv formulärbehållare kan du ange klientbibliotek, layouter, teman, inställningar för dokumentdokument, inställningar för att spara, inställningar för överföring och metadatainställningar.
B.Kopiera: Du kan använda kopieringsalternativet för att kopiera en komponent och klistra in den på andra platser i formuläret. När du klistrar in en komponent får den inklistrade komponenten ett nytt elementnamn men behåller den kopierade komponentens egenskaper.
C.Klipp ut: Du kan använda alternativet Klipp ut för att flytta en komponent från en plats till en annan i det adaptiva formuläret.
D. Ta bort: Du kan ta bort komponenten från formuläret.
E. Infoga: Gör att du kan infoga en komponent ovanför den markerade komponenten.
F. Klistra in: Gör att du kan klistra in komponenten som du klippt ut eller kopierat med alternativen som beskrivs ovan.
G. Redigera regler: Du kan öppna regelredigeraren. Mer information finns i Regelredigeraren.
H. Grupp: Gör att du kan markera flera komponenter om du vill klippa ut, kopiera eller klistra in mer än en komponent tillsammans.
I. Överordnad: Gör att du kan välja överordnad för en komponent. Ett textfält ligger till exempel i ett underavsnitt som finns i ett avsnitt. Avsnittet finns i stödlinjens rotpanel och den adaptiva formulärbehållaren är överordnad en stödlinjens rotpanel. För en komponent kan du se alla alternativ med hierarkin sorterad längst ned.
Om du till exempel väljer Parent för en textruta kan du se:
- Underavsnitt
- Avsnitt
- guideRootPanel
- Adaptiv formulärbehållare
J. Övriga: Tillhandahåller fler alternativ för att arbeta med den markerade komponenten.
- Visa SOM-uttryck
- Spara en panel som fragment (endast för paneler)
- Lägg till underordnad panel (endast för paneler)
- Verktygsfältet Lägg till panel (endast för paneler)
- Ersätt (inte för paneler)
Adaptiv formulärsida af-page
Den anpassningsbara formulärsidan är det faktiska formuläret. Det är som alla andra WCM-sidor som modelleras som WCM cq:Page
-komponenten. Följande bild visar innehållsstrukturen i ett typiskt anpassat formulär.
Innehållsstrukturen innehåller vanligtvis följande primära komponenter:
-
guideContainer: Roten för ett adaptivt formulär, som markeras som Start of adaptive form i gränssnittet för det adaptiva formuläret. I den här komponenten kan du ange:
- Mobil layout för det adaptiva formuläret: Definierar formulärets utseende på mobila enheter.
- Tack!: Definierar sidan där användaren omdirigeras efter att formuläret har skickats.
- Skicka åtgärd: Definierar hur formuläret bearbetas på servern när användaren skickar formuläret.
- Format: Anger sökvägen till CSS-filen som används för att anpassa formulärets utseende.
-
rootPanel: Rotpanelen i ett adaptivt formulär. Den kan innehålla underpaneler under objektnoden. Varje panel, inklusive rotpanelen, kan ha en tillhörande layout. Panelens layout bestämmer hur formuläret placeras. I dragspelslayouten placeras till exempel objekten som dragspelssteg.
-
verktygsfält: En adaptiv formulärbehållare har ett associerat globalt verktygsfält som är globalt för formuläret. Det här verktygsfältet kan läggas till med åtgärden Add Toolbar i redigeringsfältet, som gör att författare kan lägga till åtgärder som Skicka, Spara, Återställ och så vidare.
-
resurser: Den här noden innehåller ytterligare information som används för formulärredigering. Exempel: formulärmodellinformation, lokaliseringsinformation osv.).