Adaptieve Forms synchroniseren met XFA-formuliersjablonen

Inleiding

U kunt een adaptief formulier maken op basis van een XFA-formuliersjabloon ( *.XDP bestand). Dankzij dit hergebruik kunt u uw investering in bestaande XFA-formulieren behouden. Een adaptief formulier maken op basis van een sjabloon voor informatie over het gebruik van een XFA-formuliersjabloon voor het maken van een adaptief formulier.

U kunt velden uit het XDP-bestand opnieuw gebruiken in het aangepaste formulier. Deze velden worden gebonden velden genoemd. De eigenschappen van de gebonden velden (zoals scripts, labels en weergave-indeling) worden uit het XDP-bestand gekopieerd. U kunt er ook voor kiezen de waarde van sommige van deze eigenschappen te overschrijven.

AEM Forms biedt een manier om u te helpen de velden van de adaptieve formulieren synchroon te houden met alle wijzigingen die later worden aangebracht in de corresponderende velden in het XDP-bestand. In dit artikel wordt uitgelegd hoe u deze synchronisatie kunt inschakelen.

U kunt velden van een XFA-formulier naar een adaptief formulier slepen

In de AEM Forms-ontwerpomgeving kunt u velden van een XFA-formulier (links) naar een adaptief formulier slepen (rechts)

Vereisten

Om de informatie in dit artikel te gebruiken, wordt een vertrouwdheid met de volgende gebieden geadviseerd:

Als u de elementen in het voorbeeld in het artikel wilt gebruiken, downloadt u het voorbeeldpakket zoals wordt beschreven in de volgende sectie, Voorbeeldpakket.

Voorbeeldpakket

In het artikel wordt een voorbeeld gebruikt om te tonen hoe u het aangepaste formulier synchroniseert met een bijgewerkte XFA-formuliersjabloon. De elementen die in het voorbeeld worden gebruikt, zijn beschikbaar in een pakket. U kunt deze downloaden in de sectie Downloads in dit artikel.

Nadat u het pakket hebt geüpload, kunt u deze elementen weergeven in de gebruikersinterface van AEM Forms.

Installeer het pakket met behulp van pakketbeheer: https://<server>:<port>/crx/packmgr/index.jsp

Het pakket bevat de volgende elementen:

  1. sample-form.xdp: De XFA-formuliersjabloon die als voorbeeld wordt gebruikt

  2. sample-xfa-af: Het adaptieve formulier op basis van het bestand sample-form.xdp. Dit adaptieve formulier bevat echter geen velden. In de volgende stap voegen we inhoud toe aan dit aangepaste formulier.

Inhoud toevoegen aan adaptief formulier

  1. Ga naar https://<server>:<port>/aem/forms.html. Voer uw referenties in als hierom wordt gevraagd.
  2. Open de sample-af-xfa voor bewerking in de auteursmodus.
  3. Kies Gegevensmodelobjecten op het tabblad Inhoud in de inhoudbrowser op de zijbalk. Sleep NumeriekVeld1 en TextField1 naar het adaptieve formulier.
  4. Wijzig de titel van NumericField1 van Numeriek veld in AF Numeriek veld.
OPMERKING

In de voorgaande stappen is een eigenschap van een veld in het XDP-bestand overschreven. Deze eigenschap wordt daarom niet gesynchroniseerd als de overeenkomende eigenschap in het XDP-bestand later wordt gewijzigd.

Wijzigingen in XDP-bestand detecteren

Telkens wanneer er een wijziging optreedt in een XDP-bestand of een fragment, geeft de gebruikersinterface van AEM Forms alle adaptieve formulieren weer die zijn gebaseerd op het XDP-bestand of het fragment.

Nadat u een XDP-bestand hebt bijgewerkt, moet u het opnieuw uploaden in de AEM Forms-gebruikersinterface om de wijzigingen te kunnen markeren.

Als voorbeeld, laten wij het sample-form.xdp dossier bijwerken gebruikend de volgende stappen:

  1. Navigeer naar https://<server>:<port>/projects.html. Voer desgevraagd uw referenties in.

  2. Klik op het tabblad Forms aan de linkerkant.

  3. Download het sample-form.xdp-bestand op uw lokale computer. Het XDP-bestand wordt gedownload als een .zip-bestand, dat kan worden geëxtraheerd met een willekeurig bestandsdecompressiehulpprogramma.

  4. Open het sample-form.xdp dossier en verander de titel van het gebied TextField1 van Tekstgebied in Mijn Gebied van de Tekst.

  5. Upload het sample-form.xdp bestand terug naar de gebruikersinterface van AEM Forms.

Als een XDP-bestand wordt bijgewerkt, wordt in de editor een pictogram weergegeven wanneer u de adaptieve formulieren bewerkt op basis van het XDP-bestand. Dit pictogram geeft aan dat het adaptieve formulier niet meer synchroon is met het XDP-bestand. Zie het pictogram naast in het zijpaneel in de volgende afbeelding.

Pictogram om weer te geven dat het adaptieve formulier niet meer synchroon is met het XDP-bestand

Aangepaste formulieren synchroniseren met het nieuwste XDP-bestand

Wanneer een adaptief formulier dat niet meer synchroon is met het XDP-bestand de volgende keer wordt geopend voor ontwerpen, wordt het volgende bericht weergegeven:
Schema-/formuliersjabloon voor het adaptieve formulier is bijgewerkt. Click Here om het met de nieuwe versie opnieuw te baseren.

Wanneer u op het bericht klikt, worden de velden in het adaptieve formulier gesynchroniseerd met de bijbehorende velden in het XDP-bestand.

Open sample-xfa-af in de ontwerpmodus voor het voorbeeld dat in dit artikel wordt gebruikt. Het bericht wordt onder aan het adaptieve formulier weergegeven.

Bericht waarin u wordt gevraagd het adaptieve formulier te synchroniseren met het XDP-bestand

De eigenschappen bijwerken

Alle eigenschappen die van het XDP-bestand naar het adaptieve formulier zijn gekopieerd, worden bijgewerkt, behalve de eigenschappen die door de auteur expliciet in het adaptieve formulier (uit het dialoogvenster Component) zijn genegeerd. De lijst met eigenschappen die zijn bijgewerkt, is beschikbaar in de serverlogboeken.

Als u de eigenschappen in het adaptieve voorbeeldformulier wilt bijwerken, klikt u op de koppeling (met het label "Click Here") in het bericht. De titel van TextField1 verandert van Tekstveld in Mijn tekstveld.

update-property

OPMERKING

Het label AF Numeriek veld is niet gewijzigd omdat u deze eigenschap uit het dialoogvenster Eigenschappen van component hebt overschreven, zoals beschreven in Inhoud toevoegen aan adaptieve formulieren.

Nieuwe velden van XDP-bestand toevoegen aan adaptief formulier  

Alle velden die later aan het oorspronkelijke XDP-bestand worden toegevoegd, worden weergegeven op het tabblad Formulierhiërarchie en u kunt deze nieuwe velden naar het aangepaste formulier slepen.

U hoeft niet op de koppeling in het foutbericht te klikken om de velden op het tabblad Formulierhiërarchie bij te werken.

Verwijderde velden in XDP-bestand

Als een veld dat eerder naar een adaptief formulier is gekopieerd, uit een XDP-bestand wordt verwijderd, wordt in de ontwerpmodus een foutbericht weergegeven met de mededeling dat het veld niet bestaat in het XDP-bestand. Verwijder in dergelijke gevallen handmatig het veld uit het adaptieve formulier of wis de eigenschap bindRef in het dialoogvenster met componenten.

De volgende stappen illustreren deze gebruiksstroom voor de elementen in het voorbeeld dat in dit artikel wordt gebruikt:

  1. Werk het sample-form.xdp dossier bij en schrap NumericField1.

  2. Het sample-form.xdp-bestand uploaden in de gebruikersinterface van AEM Forms

  3. Open het aangepaste formulier sample-xfa-af voor ontwerpen. Het volgende foutbericht wordt weergegeven: Schema/formuliersjabloon voor het adaptieve formulier is bijgewerkt. Click Here om het met de nieuwe versie opnieuw te baseren.

  4. Klik op de koppeling ( " Click Here") in het bericht. Er wordt een foutbericht weergegeven met de mededeling dat het veld niet meer bestaat in het XDP-bestand.

Fout die u ziet wanneer u een element in het XDP dossier schrapt

Het veld dat is verwijderd, wordt ook gemarkeerd met een pictogram om een fout in het veld aan te geven.

Foutpictogram in het veld

OPMERKING

De velden in het adaptieve formulier met een onjuiste binding (een ongeldige bindRef-waarde in het dialoogvenster Bewerken) worden ook beschouwd als verwijderde velden. Als de auteur deze fouten niet corrigeert en het adaptieve formulier niet publiceert, wordt het veld behandeld als een normaal, niet-gebonden adaptief formulierveld en wordt het veld opgenomen in de niet-gebonden sectie van het XML-uitvoerbestand.

Downloads

Inhoudspakket voor het voorbeeld in dit artikel

Bestand ophalen

Op deze pagina