Dokumentation AEM as a Cloud Service Användarhandbok

Skapa formulärfragment i Universal Editor

Last update: Wed Sep 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Gäller:
Experience Manager as a Cloud Service

Ämnen:
Edge-leveranstjänster

Skapat för:

Administratör
Användare
Utvecklare

Formulärfragment är återanvändbara komponenter som eliminerar repetitivt utvecklingsarbete och säkerställer konsekvens i alla era formulär. I stället för att återskapa vanliga avsnitt som kontaktinformation, adressinformation eller godkännandeavtal för varje formulär kan du skapa dessa element en gång som fragment och återanvända dem i flera formulär.

Vad du ska göra i den här artikeln:

Förstå affärsvärdet och de tekniska funktionerna i formulärfragment
Skapa återanvändbara formulärfragment med Universal Editor
Integrera fragment i befintliga blanketter med rätt konfiguration
Hantera fragmentets livscykel och bevara enhetlighet i alla formulär

Affärsfördelar:

Minskad utvecklingstid: Bygg gemensamma formuläravsnitt en gång, återanvänd överallt
Förbättrad konsekvens: Standardiserade layouter och innehåll i alla formulär
Förenklat underhåll: Uppdatera ett fragment en gång för att återspegla ändringar i alla formulär som använder det
Förbättrad efterlevnad: Se till att regelsektionerna är konsekventa och uppdaterade

Formulärfragment i Edge Delivery Services har stöd för avancerade funktioner som kapslade fragment, flera instanser i ett och samma formulär samt smidig integrering med datakällor.

Förstå formulärfragment

Formulärfragment i Edge Delivery Services har kraftfulla funktioner för modulär formulärutveckling:

Kärnfunktioner:

Konsekvenshantering: Fragment behåller identiska layouter och innehåll i flera formulär. Med metoden"ändra en gång, spegla överallt" tillämpas uppdateringar av ett fragment automatiskt på alla formulär i förhandsgranskningsläget.
Flera användningsområden: Lägg till samma fragment flera gånger i ett enda formulär, var och en med oberoende databindning till olika datakällor eller schemaelement.
Kapslade strukturer: Skapa komplexa hierarkier genom att bädda in fragment i andra fragment för avancerade formulärarkitekturer.

Tekniska krav:

GitHub URL-konsekvens: Både fragmentet och alla formulär som använder det måste ange samma GitHub-databas-URL
Fristående redigering: Fragment kan bara ändras i sin fristående form; ändringar kan inte göras i värdformuläret

Publiceringsbeteende:

IMPORTANT

I förhandsgranskningsläget återspeglas fragmentändringarna omedelbart i alla formulär. I publiceringsläget måste du publicera om både fragmentet och alla formulär som använder det för att se uppdateringar.

CAUTION

Undvik rekursiva fragmentreferenser (kapsling av ett fragment i sig) eftersom detta orsakar återgivningsfel och oväntat beteende.

Förutsättningar

Tekniska installationskrav:

GitHub-databasen har konfigurerats med en anslutning upprättad mellan din AEM-miljö och GitHub-databasen
Det senaste adaptiva Forms-blocket har lagts till i GitHub-databasen (för befintliga Edge Delivery Services-projekt)
Instans av AEM Forms Author med Edge Delivery Services-mall tillgänglig
Åtkomst till URL:en för AEM Forms as a Cloud Service-författarinstansen och URL:en för GitHub-databasen

Nödvändig kunskap och behörigheter:

Grundläggande förståelse för formulärdesignkoncept och komponenthierarki
Välbekant med gränssnittet i den universella redigeraren och arbetsflöden för att skapa formulär
Behörigheter på författarnivå i AEM Forms för att skapa och hantera formulärresurser
Förstå organisationens formulärstandarder och krav på återanvändbara komponenter

Arbeta med Edge Delivery Services-formulärfragment

Du kan skapa Edge Delivery Services-formulärfragment i den universella redigeraren och lägga till de skapade fragmenten i Edge Delivery Services-formulär. Du kan utföra följande åtgärder med Edge Delivery Services-formulärfragment:

Skapa formulärfragment i Universal Editor

Skapa formulärfragment

Så här skapar du ett formulärfragment i den universella redigeraren:

Logga in på din AEM Forms as a Cloud Service-författarinstans.
Välj Adobe Experience Manager > Forms > Forms & Documents.
Klicka på Skapa > Adaptivt formulärfragment.

Guiden Skapa adaptivt formulärfragment visas.
Välj den Edge Delivery Services-baserade mallen på fliken Välj mall och klicka på Next.
Ange rubrik, namn, beskrivning och taggar för fragmentet. Se till att du anger ett unikt namn för fragmentet. Om det finns ett annat fragment med samma namn kan fragmentet inte skapas.
Ange GitHub-URL. Om din GitHub-databas till exempel har namnet edsforms, finns den under kontot wkndforms, är URL:en https://github.com/wkndforms/edsforms.

(Valfritt) Klicka för att öppna fliken Formulärmodell och välj en av följande modeller för fragmentet på den nedrullningsbara menyn Välj från:

Visar modelltyp på fliken Formulärmodell

Formulärdatamodell (FDM): Integrera datamodellsobjekt och datatjänster från datakällor i fragmentet. Välj FDM (Form Data Model) om formuläret kräver att du läser och skriver data från flera källor.
JSON-schema: Integrera formuläret med ett serverdelssystem genom att associera ett JSON-schema som definierar datastrukturen. Det gör att du kan lägga till dynamiskt innehåll med schemaelementen.
Inget: Anger att fragmentet ska skapas från grunden utan att någon formulärmodell används.

note note
NOTE
Mer information om hur du integrerar formulär eller fragment med en formulärdatamodell (FDM) i den universella redigeraren för att använda olika backend-datakällor finns i Integrera formulär med formulärdatamodellen i den universella redigeraren.

(Valfritt) Ange Publiceringsdatum eller Avpubliceringsdatum för fragmentet på fliken Avancerat.
Klicka på Skapa för att generera fragmentet. En dialogruta med redigeringsalternativ visas.
Klicka på Redigera för att öppna fragmentet i Universal Editor med standardmallen använd.
Designa fragmentinnehåll: Lägg till formulärkomponenter (textfält, listrutor, kryssrutor) för att skapa det återanvändbara avsnittet. Detaljerad vägledning om komponenter finns i Komma igång med Edge Delivery Services för AEM Forms med Universal Editor.
Konfigurera komponentegenskaper: Ange fältnamn, verifieringsregler och standardvärden efter behov för ditt användningsfall.
Spara och förhandsgranska: Spara fragmentet och använd förhandsgranskningsläget för att verifiera layout och funktion.

Kontrollpunkt för validering:

Fragmentinläsningar utan fel i Universal Editor
Alla formulärkomponenter återges korrekt
Fältegenskaper och valideringsregler fungerar som förväntat
Fragmentet sparas och är tillgängligt i Forms & Documents Console

När fragmentet är klart kan du integrera det i alla Edge Delivery Services-formulär.

Lägga till formulärfragment i ett formulär

I det här exemplet visas hur du skapar ett Employee Details-formulär som använder Contact Details-fragmentet för både den anställdes- och arbetsledarens informationsavsnitt. Detta tillvägagångssätt garanterar enhetlig datainsamling samtidigt som utvecklingsinsatsen minskas.

Så här integrerar du ett formulärfragment i formuläret:

Öppna formuläret i redigeringsläge.
Lägg till komponenten Formulärfragment i formuläret.
Öppna innehållsläsaren och navigera till komponenten Adaptive Form i innehållsträdet.
Navigera till avsnittet där du vill lägga till ett fragment. Navigera till exempel till panelen Information om medarbetare.
Klicka på ikonen Add och lägg till komponenten Form Fragment från listan Adaptiva formulärkomponenter.

När du väljer komponenten Form Fragment läggs fragmentet till i formuläret. Du kan konfigurera egenskaperna för det tillagda fragmentet genom att öppna dess Egenskaper. Dölj till exempel fragmentets namn från dess egenskaper.
Markera fragmentreferensen på fliken Grundläggande. Alla fragment som är tillgängliga för formuläret, beroende på formulärmodellen, visas.

Navigera till exempel till /content/forms/af och markera fragmentet Contact Details.

Klicka på Select.

Formulärfragmentet läggs till med referens till formuläret och förblir synkroniserat med det fristående formulärfragmentet.

Skärmbild som visar kontaktinformationsfragmentet som har integrerats i ett medarbetarformulär i den universella redigeraren och som visar hur fragment behåller sin struktur när de återanvänds

note note
NOTE
Med knappen Redigera fragment kan användare navigera direkt till formulärfragmentet för redigering.

Du kan förhandsgranska formuläret för att se hur det ser ut i förhandsgranskningsläget.

Förhandsgranska

På samma sätt kan du upprepa steg 3 till 7 för att infoga Contact Details-fragmentet för panelen Supervisor Details.

Formulär för personalinformation

Hantera formulärfragment

Du kan utföra flera åtgärder på formulärfragment med AEM Forms användargränssnitt.

Logga in på din AEM Forms as a Cloud Service-författarinstans.
Välj Adobe Experience Manager > Forms > Forms & Documents.

Markera ett formulärfragment och i verktygsfältet visas följande åtgärder som du kan utföra på det markerade fragmentet.

Hantera fragment

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 html-authored no-header
Åtgärd	Beskrivning
Redigera	Öppnar formulärfragmentet i redigeringsläge.
Egenskaper	Tillhandahåller alternativ för att ändra egenskaperna för formulärfragmentet.
Kopiera	Innehåller alternativ för att kopiera formulärfragmentet och klistra in det på önskad plats.
Förhandsgranska	Tillhandahåller alternativ för att förhandsgranska fragmentet som HTML eller utföra en anpassad förhandsgranskning genom att sammanfoga data från en XML-fil med fragmentet.
Ladda ned	Hämtar det markerade fragmentet.
Starta granskning/hantera granskning	Tillåter initiering och hantering av en granskning av det valda fragmentet.
Publicera/avpublicera	Publicerar/återpublicerar det valda fragmentet.
Ta bort	Tar bort det markerade fragmentet.
Jämför	Jämför två olika formulärfragment för förhandsgranskning.

Bästa praxis

Fragmentdesign och namn:

Använd beskrivande, unika namn: Välj namn som tydligt anger fragmentets syfte (t.ex. "contact-details-with-validation" i stället för "fragment1")
Planera för återanvändbarhet: Designa fragment så att de blir sammanhangsberoende och fungerar på olika formulärtyper
Håll fragmenten fokuserade: Skapa engångs-fragment i stället för komplexa flerfunktionskomponenter

Utvecklingsarbetsflöde:

Testa fragment oberoende: Verifiera fragmentfunktioner innan du integrerar i formulär
Behåll konsekventa GitHub-URL:er: Se till att samma databas-URL används för alla relaterade fragment och formulär
Syftet med dokumentfragment: Inkludera tydliga beskrivningar och taggar som hjälper teammedlemmarna att förstå när de ska använda varje fragment

Publikation och underhåll:

Koordinera publikation: När du uppdaterar fragment bör du planera att publicera om alla beroende formulär samtidigt
Versionskontroll: Använd meningsfulla implementeringsmeddelanden när du uppdaterar fragment för att spåra ändringar över tid
Övervaka beroenden: Håll reda på vilka formulär som använder varje fragment för att utvärdera uppdateringseffekten

TIP

Fragmentformat, skript och uttryck bevaras när de bäddas in, så design med detta arv i åtanke.

Sammanfattning

Du har nu lärt dig att utnyttja formulärfragment i Edge Delivery Services för att förbättra utvecklingseffektiviteten och upprätthålla enhetligheten i hela organisationens formulär.

Viktiga resultat:

Förstå: Utnyttja affärsvärdet och de tekniska funktionerna i formulärfragment
Skapande: Skapar återanvändbara formulärfragment med den universella redigeraren med rätt konfiguration
Integrering: Fragment har lagts till i formulär med korrekt referenskonfiguration och egenskapskonfiguration
Hantering: Utforskade livscykeloperationer och underhållsarbetsflöden för fragment

Nästa steg:

Skapa ett bibliotek med ofta använda fragment för din organisation.
Upprätta namnkonventioner och styrningsprinciper för fragmentanvändning.
Utforska avancerad integrering med Form Data Models för dynamiska datadrivna fragment
Implementera fragmentbaserade blankettmallar för enhetliga användarupplevelser.

Era formulär har nu en modulär, underhållningsbar arkitektur som kan skalas effektivt mellan olika projekt samtidigt som de ger en enhetlig användarupplevelse.

recommendation-more-help

fbcff2a9-b6fe-4574-b04a-21e75df764ab