Synkronisera adaptiv Forms med XFA-formulärmallar synchronizing-adaptive-forms-with-xfa-form-templates
Introduktion introduction
Du kan skapa ett anpassat formulär baserat på en XFA-formulärmall ( *.XDP
fil). Tack vare detta återanvändning kan du bevara din investering i befintliga XFA-formulär. Information om hur du använder en XFA-formulärmall för att skapa ett anpassat formulär finns i Skapa ett anpassat formulär baserat på en mall.
Du kan återanvända fält från XDP-filen i ditt adaptiva formulär. Dessa fält kallas för binda fält. Egenskaperna för de bindade fälten (till exempel skript, etiketter och visningsformat) kopieras från XDP-filen. Du kan också välja att åsidosätta värdet för vissa av dessa egenskaper.
Med AEM Forms kan du synkronisera fälten i de adaptiva formulären med eventuella ändringar som senare görs i motsvarande fält i XDP-filen. I den här artikeln beskrivs hur du kan aktivera synkroniseringen.
I AEM Forms redigeringsmiljö kan du dra fält från ett XFA-formulär (vänster) till ett anpassat formulär (höger)
Förutsättningar prerequisites
Om du vill använda informationen i den här artikeln bör du känna till följande områden:
-
XFA (XML Forms Architecture)
Om du vill använda resurserna som innehåller exemplet i artikeln hämtar du exempelpaketet enligt beskrivningen i nästa avsnitt, Exempelpaket.
Exempelpaket sample-package
I artikeln används ett exempel som visar hur du synkroniserar det adaptiva formuläret med en uppdaterad XFA-formulärmall. Resurserna som används i exemplet finns i ett paket som kan hämtas från Nedladdningar i den här artikeln.
När du har överfört paketet kan du visa de här resurserna i användargränssnittet för AEM Forms.
Installera paketet med hjälp av pakethanteraren: https://<server>:<port>/crx/packmgr/index.jsp
Paketet innehåller följande resurser:
-
sample-form.xdp
: XFA-formulärmallen används som exempel -
sample-xfa-af
: Det adaptiva formuläret som baseras på filen sample-form.xdp. Det här anpassningsbara formuläret innehåller dock inga fält. I nästa steg ska vi lägga till innehåll i det här anpassade formuläret.
Lägg till innehåll i anpassningsbara formulär add-content-to-adaptive-form-br
- Navigera till https://<server>:<port>/aem/forms.html. Ange dina autentiseringsuppgifter om du tillfrågas.
- Öppna exemplet-af-xfa för redigering i redigeringsläge.
- Välj fliken Datamodellobjekt i innehållsläsaren i sidlisten. Dra NumericField1 och TextField1 till det adaptiva formuläret.
- Ändra titeln för NumericField1 från Numeriskt fält till Numeriskt AF-fält.
Identifiera ändringar i XDP-fil detecting-changes-in-xdp-file
När en XDP-fil eller ett fragment ändras flaggas alla adaptiva formulär som är baserade på XDP-filen eller fragmentet av AEM Forms UI.
När du har uppdaterat en XDP-fil måste du överföra den igen i AEM Forms-gränssnittet för att ändringarna ska flaggas.
Låt oss till exempel uppdatera sample-form.xdp
i följande steg:
-
Navigera till
https://<server>:<port>/projects.html.
Ange dina inloggningsuppgifter om du uppmanas att göra det. -
Klicka på fliken Forms till vänster.
-
Ladda ned
sample-form.xdp
på din lokala dator. XDP-filen hämtas som.zip
som kan extraheras med valfritt fildekomprimeringsverktyg. -
Öppna
sample-form.xdp
och ändra titeln för fältet TextField1 från Textfält till Mitt textfält. -
Överför
sample-form.xdp
tillbaka till AEM Forms UI.
Om en XDP-fil uppdateras visas en ikon i redigeraren när du redigerar de adaptiva formulären baserat på XDP-filen. Den här ikonen anger att det adaptiva formuläret inte är synkroniserat med XDP-filen. I följande bild ser du ikonen bredvid i sidlisten.
Synkronisera adaptiva formulär med den senaste XDP-filen synchronizing-adaptive-forms-with-the-latest-xdp-file
När ett adaptivt formulär som inte är synkroniserat med XDP-filen öppnas för redigering nästa gång visas följande meddelande:
Schema/formulärmall för det anpassade formuläret har uppdaterats. Click Here
för att basera den på den nya versionen.
När du klickar på meddelandet synkroniseras fälten i det adaptiva formuläret med motsvarande fält i XDP-filen.
Öppna det exempel som används i den här artikeln sample-xfa-af
i redigeringsläge. Meddelandet visas längst ned i det anpassade formuläret.
Egenskaperna uppdateras updating-the-properties
Alla egenskaper som kopierades från XDP-filen till det adaptiva formuläret uppdateras, förutom de egenskaper som explicit åsidosatts i det adaptiva formuläret (från komponentdialogrutan) av författaren. Listan över egenskaper som har uppdaterats är tillgänglig i serverloggarna.
Om du vill uppdatera egenskaperna i det adaptiva formuläret klickar du på länken (märkt) "Click Here"
) i meddelandet. Titeln för TextField1 ändras från Textfält till Mitt textfält.
Lägga till nya fält från XDP-fil i anpassat formulär adding-new-fields-from-xdp-file-to-adaptive-form-nbsp
Alla fält som läggs till senare i den ursprungliga XDP-filen visas på fliken Formulärhierarki och du kan dra de nya fälten till det anpassade formuläret.
Du behöver inte klicka på länken i felmeddelandet för att uppdatera fälten på fliken Formulärhierarki.
Borttagna fält i XDP-fil deleted-fields-in-xdp-file
Om ett fält som tidigare kopierats till ett adaptivt formulär tas bort från en XDP-fil visas ett felmeddelande i redigeringsläget om att fältet inte finns i XDP-filen. I sådana fall kan du ta bort fältet manuellt från ett anpassat formulär eller rensa bindRef
-egenskapen i komponentdialogrutan.
Följande steg visar det här användningsflödet för resurserna i exemplet som används i den här artikeln:
-
Uppdatera
sample-form.xdp
och ta bort NumericField1. -
Överför
sample-form.xdp
i AEM Forms UI -
Öppna
sample-xfa-af
anpassat formulär för redigering. Följande felmeddelande visas: Schema/formulärmall för det anpassade formuläret har uppdaterats.Click Here
för att basera den på den nya versionen. -
Klicka på länken (märkt "
Click Here
") i meddelandet. Ett felmeddelande visas som anger att fältet inte längre finns i XDP-filen.
Fältet som har tagits bort är också markerat med en ikon som anger ett fel i fältet.
bindRef
i redigeringsdialogrutan) betraktas också som borttagna fält. Om författaren inte åtgärdar dessa fel och publicerar det adaptiva formuläret, behandlas fältet som ett vanligt, obindat, adaptivt formulärfält och inkluderas i det obindade avsnittet i XML-utdatafilen.Nedladdningar downloads
Innehållspaket för exemplet i den här artikeln