Synkronisera adaptiv Forms med XFA-formulärmallar synchronizing-adaptive-forms-with-xfa-form-templates

CAUTION
AEM 6.4 har nått slutet på den utökade supporten och denna dokumentation är inte längre uppdaterad. Mer information finns i teknisk supportperiod. Hitta de versioner som stöds här.

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.

Du kan dra fält från ett XFA-formulär till ett anpassat formulär

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:

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:

  1. sample-form.xdp: XFA-formulärmallen används som exempel

  2. 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

  1. Navigera till https://<server>:<port>/aem/forms.html. Ange dina autentiseringsuppgifter om du tillfrågas.
  2. Öppna exemplet-af-xfa för redigering i redigeringsläge.
  3. Välj fliken Datamodellobjekt i innehållsläsaren i sidlisten. Dra NumericField1 och TextField1 till det adaptiva formuläret.
  4. Ändra titeln för NumericField1 från Numeriskt fält till Numeriskt AF-fält.
NOTE
I föregående steg skrev vi över en egenskap för ett fält i XDP-filen. Den här egenskapen kommer därför inte att synkroniseras om motsvarande egenskap i XDP-filen ändras senare.

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:

  1. Navigera till https://<server>:<port>/projects.html. Ange dina inloggningsuppgifter om du uppmanas att göra det.

  2. Klicka på fliken Forms till vänster.

  3. Ladda ned sample-form.xdp på din lokala dator. XDP-filen hämtas som .zip som kan extraheras med valfritt fildekomprimeringsverktyg.

  4. Öppna sample-form.xdp och ändra titeln för fältet TextField1 från Textfält till Mitt textfält.

  5. Ö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.

Ikon som visar att det adaptiva formuläret inte är synkroniserat med XDP-filen

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.

Meddelande som uppmanar dig att synkronisera det adaptiva formuläret med XDP-filen

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.

update-property

NOTE
Etiketten för det numeriska AF-fältet ändrades inte eftersom du hade åsidosatt den här egenskapen från dialogrutan för komponentegenskaper enligt beskrivningen i Lägga till innehåll i anpassningsbara formulär.

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:

  1. Uppdatera sample-form.xdp och ta bort NumericField1.

  2. Överför sample-form.xdp i AEM Forms UI

  3. Ö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.

  4. 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.

Ett fel uppstod när du tog bort ett element i XDP-filen

Fältet som har tagits bort är också markerat med en ikon som anger ett fel i fältet.

Felikon i fältet

NOTE
De fält i det adaptiva formuläret som har en felaktig bindning (en ogiltig) 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

Hämta fil

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da