Synkronisera adaptiv Forms med XFA-formulärmallar synchronizing-adaptive-forms-with-xfa-form-templates
Adobe rekommenderar att du använder den moderna och utbyggbara datainhämtningen Core Componentsför att skapa nya adaptiva Formseller att lägga till adaptiva Forms på AEM Sites-sidor. De här komponenterna utgör ett betydande framsteg när det gäller att skapa adaptiva Forms-filer, vilket ger imponerande användarupplevelser. I den här artikeln beskrivs det äldre sättet att skapa Adaptiv Forms med baskomponenter.
Introduktion introduction
Du kan skapa ett adaptivt formulär baserat på en XFA-formulärmall ( *.XDP
fil). Tack vare detta återanvändande kan du behålla din investering i befintliga XFA-formulär. Skapa ett adaptivt formulär baserat på en mall om du vill ha information om hur du använder en XFA-formulärmall för att skapa ett adaptivt formulär.
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 ett exempel 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 är tillgängliga i ett paket som kan hämtas från avsnittet Hämtningar 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 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 lägger du 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
- Gå 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 AF numeriskt 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 filen sample-form.xdp
med följande steg:
-
Navigera till
https://<server>:<port>/projects.html.
Ange dina autentiseringsuppgifter om du uppmanas till det. -
Klicka på fliken Forms till vänster.
-
Hämta filen
sample-form.xdp
på den lokala datorn. XDP-filen hämtas som en.zip
-fil, som kan extraheras med valfritt fildekomprimeringsverktyg. -
Öppna filen
sample-form.xdp
och ändra titeln för fältet TextField1 från Textfält till Mitt textfält. -
Överför filen
sample-form.xdp
tillbaka till AEM Forms-gränssnittet.
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 adaptiva formuläret har uppdaterats. Click Here
om du vill basera om den med 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 sample-xfa-af
i redigeringsläget för det exempel som används i den här artikeln. 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 exempelformuläret klickar du på länken (märkt "Click Here"
) i meddelandet. Titeln på TextField1 ändras från Textfält till 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å fall tar du bort fältet manuellt från anpassat formulär eller tar bort egenskapen bindRef
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 filen
sample-form.xdp
och ta bort NumericField1. -
Överför filen
sample-form.xdp
i AEM Forms-gränssnittet -
Öppna det anpassningsbara formuläret
sample-xfa-af
för redigering. Följande felmeddelande visas: Schema/Formulärmall för det adaptiva formuläret har uppdaterats.Click Here
om du vill basera om den med den nya versionen. -
Klicka på länken (med namnet
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
-värde 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 obundet adaptivt formulärfält och inkluderas i det obundna avsnittet i XML-utdatafilen.Nedladdningar downloads
Innehållspaket för exemplet i den här artikeln