Introduktion till utveckling av anpassningsbara formulär introduction-to-authoring-adaptive-forms
Översikt 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
Dataintegrering Med kan du integrera enheter 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 en 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 ett nytt eller redigerar ett befintligt anpassat formulär använder du följande gränssnittselement:
S. Sidebar B. Verktygsfältet Sida C. Adaptiv formulärsida
Sidebar sidebar
Med sidofältet kan du
-
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.
S. Innehållsläsare B. Egenskapswebbläsaren C. Resursläsaren D. Komponentwebbläsare
Sidlisten innehåller följande webbläsare:
-
Innehållsläsare
I innehållsläsaren kan du se
-
Formulärobjekt
Visar formulärets objekthierarki. 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.
Det gör att 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.
-
-
Egenskapswebblä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 och tryck sedan på
-
Resursläsaren
Segmenterar olika typer av innehåll, t.ex. bilder, dokument, sidor, filmer och så vidare.
-
Komponentwebbläsare
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 att komma ihåg när du arbetar med adaptiva formulärkomponenter:
-
Varje komponent har tillhörande egenskaper som styr dess utseende och funktion. Konfigurera egenskaperna för en komponent genom att trycka på komponenten och trycka på
-
En komponent identifieras med sitt elementnamn. När du trycker
-
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:
- Tryck för att markera en komponent som har en Title egenskap och vars Hide title egenskapen är inaktiverad.
- Tryck
- Ändra titeln och tryck på Retur-tangenten eller var som helst utanför komponenten för att spara ändringarna. Tryck på Esc för att 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 Validation Pattern under mönsterdragspelet 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 är vanliga för inmatningsinformation 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 specialindata för en komponent aktiverar du Use HTML Type Number i komponentegenskaperna.
-
Du kan aktivera en textrutekomponent för att acceptera RTF. Aktivera alternativet 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 markera 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
{value}={text}format i komponentegenskaper. -
Komponenten för bifogad fil tillåter som standard att användaren bara kan 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öka och trycka Adaptive Forms Configuration Service.
- Aktivera Make File Names Unique. Som standard är den inaktiverad.
-
Om du vill att användare ska kunna bifoga ett PDF i webbläsaren Safari 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 skapats med tidigare AEM Forms-version kan innehålla .pdf i stället för application/pdf i egenskapen Filtyper som stöds.
Mer tips om anpassningsbara formulär finns i Bästa tillvägagångssätt för arbete med anpassningsbara 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:
-
Toggle Side Panel
-
Page information
-
Emulator
-
Edit: Här kan du välja andra lägen, till exempel: Redigera, Formatera, Utvecklare, och Design.
-
Edit: Här kan du 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.
-
Style: 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.
-
Developer: 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.
-
-
Preview: Gör att 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.Configure: När du trycker Configure visas komponentegenskaperna i sidlisten. 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.Copy: 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.Cut: 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. Delete: Gör att du kan ta bort komponenten från formuläret.
E. Insert: Gör att du kan infoga en komponent ovanför den markerade komponenten.
F. Paste: Gör att du kan klistra in komponenten som du klipper ut eller kopierar med alternativen som beskrivs ovan.
G. Edit rules: Gör att 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.
Jag. Parent: Gör att du kan välja en komponents överordnade. 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 trycker Parent för en textruta ser du:
- Underavsnitt
- Avsnitt
- guideRootPanel
- Adaptiv formulärbehållare
J. Övriga: Innehå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 vilken annan WCM-sida som helst som är WCM-baserad 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 i ett adaptivt formulär, som markerats som Början på anpassat formulär i det adaptiva användargränssnittet. I den här komponenten kan du ange:
- Mobil layout för det anpassade 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 ska bearbetas på servern när användaren skickar formuläret.
- Stilar: 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 till exempel dragspelslayouten* placeras *objekten som dragspelssteg.
-
toolbar: 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 Lägg till verktygsfält i redigeringsfältet där författare kan lägga till åtgärder som Skicka, Spara, Återställ och så vidare.
-
assets: Den här noden innehåller ytterligare information som används för formulärredigering. Exempel: formulärmodellinformation, lokaliseringsinformation osv.).