Formulierset in AEM Forms form-set-in-aem-forms
Overzicht overview
Uw klanten worden vaak gevraagd meerdere formulieren in te dienen om een service of een voordeel aan te vragen. Het gaat om het vinden van alle relevante formulieren; en deze afzonderlijk vullen, verzenden en volgen. Bovendien moeten ze veelvoorkomende details meerdere keren invullen in verschillende formulieren. Het hele proces wordt omslachtig en foutgevoelig als het een groot aantal formulieren betreft. De functie Formulierenset van AEM Forms kan de gebruikerservaring in dergelijke scenario's vereenvoudigen.
Een formulierset is een verzameling HTML5-formulieren die zijn gegroepeerd en worden weergegeven als één set formulieren voor eindgebruikers. Eindgebruikers die beginnen met het invullen van een formulierset, worden naadloos van het ene naar het andere formulier overgeschakeld. Uiteindelijk kunnen ze alle formulieren met één klik verzenden.
AEM Forms biedt formulierauteurs een intuïtieve gebruikersinterface voor het maken, configureren en beheren van formuliersets. Als auteur kunt u formulieren bestellen in een bepaalde volgorde die eindgebruikers moeten volgen. Ook kunt u voorwaarden of geschiktheidsexpressies toepassen op afzonderlijke formulieren om de zichtbaarheid ervan te bepalen op basis van de invoer van de gebruiker. U kunt bijvoorbeeld het formulier met de gegevens van de echtgenoot zo configureren dat het alleen wordt weergegeven wanneer de staat van het huwelijk als Gehuwd is opgegeven.
Bovendien kunt u gemeenschappelijke gebieden in verschillende vormen vormen om gemeenschappelijke gegevensbanden te delen. Als de juiste gegevensbindingen zijn ingesteld, moeten eindgebruikers de algemene gegevens slechts eenmaal invullen als deze automatisch worden ingevuld in de volgende formulieren.
Formuliersets worden ook ondersteund in de AEM Forms-app, zodat uw medewerkers in het veld een formulierset offline kunnen gebruiken, klanten kunnen bezoeken, invoergegevens kunnen invoeren en later kunnen synchroniseren met de AEM Forms-server om formuliergegevens naar bedrijfsprocessen te verzenden.
Formulierset maken en beheren creating-and-managing-form-set
U kunt verschillende XDP's of formuliersjablonen die zijn gemaakt met Designer, koppelen aan een formulierset. Formuliersets kunnen vervolgens selectief worden gebruikt om de XDP's te renderen op basis van waarden die de gebruikers hebben ingevoerd in eerste formulieren en hun profielen.
Gebruiken AEM Forms-gebruikersinterface om al uw formulieren, formuliersets en gerelateerde elementen te beheren.
Een formulierset maken create-a-form-set
Ga als volgt te werk om een formulierset te maken:
-
Selecteer Forms > Forms en Documenten.
-
Selecteer Maken > Formulierset.
-
Voeg op de pagina Eigenschappen toevoegen de volgende details toe en klik op Volgende.
- Titel: Hiermee geeft u de titel van het document op. Met de titel kunt u de formulierset identificeren in de AEM Forms-gebruikersinterface.
- Omschrijving: Hiermee geeft u gedetailleerde informatie over het document op.
- Tags: Hiermee geeft u codes op waarmee de formulierset op unieke wijze wordt geïdentificeerd. Tags helpen u bij het zoeken naar de formulierset. Als u tags wilt maken, typt u nieuwe tagnamen in het vak Tags.
- URL verzenden: Hier geeft u de URL op waar de verzonden gegevens worden gepost voor de zelfstandige uitvoering van een formulierset (gebruik van hoofdletters/kleine letters voor niet-AEM Forms-toepassingen). De gegevens worden voorgelegd aan dit eindpunt als multipart/formdata met volgende verzoekparameter:
- dataXML: Deze parameter bevat een XML-representatie van verzonden formuliersetgegevens. Als alle formulieren in de formulierset een gemeenschappelijk schema gebruiken, wordt de XML gegenereerd volgens dat schema. Anders bevat de XML-hoofdtag een onderliggende tag voor elk ingevuld formulier in de formulierset die gegevens bevat voor de formulierbijlagen.
- formsetPath: Het pad van de indeling in CRXDE, die is ingediend.
- HTML-renderprofiel: U kunt bepaalde opties configureren, zoals zwevende velden, bijlagen en conceptondersteuning (voor zelfstandige uitvoering van formuliersets), om de weergave, het gedrag en de interacties van de formulierset aan te passen. U kunt het bestaande profiel aanpassen of uitbreiden om de instellingen voor het profiel HTML-formulier te wijzigen.
-
In het scherm Formulier selecteren worden de beschikbare XDP-formulieren of XDP-bestanden weergegeven. Zoek en selecteer de formulieren die u in de formulierset wilt opnemen en klik vervolgens op Toevoegen aan formulierset. Zoek zo nodig nogmaals naar formulieren die u wilt toevoegen. Nadat u alle formulieren aan de formulierset hebt toegevoegd, klikt u op Volgende.
note note NOTE Zorg ervoor dat de veldnamen in XDP-formulieren niet het puntteken bevatten. Anders kunnen scripts die proberen de velden op te lossen, die punttekens hebben, deze niet oplossen. -
Op de pagina Formulier(s) configureren kunt u het volgende doen:
- Formuliervolgorde: Sleep de formulieren om ze opnieuw te ordenen. De formuliervolgorde definieert de volgorde waarin formulieren aan de eindgebruiker worden weergegeven in de AEM Forms-app en zelfstandige uitvoering.
- Formulierid: Hiermee geeft u een unieke identiteit op voor de formulieren die moeten worden gebruikt in geschiktheidsexpressies.
- Gegevensmap: Voor elk formulier in een formulierset kan de auteur de XPATH configureren waar de gegevens van dat formulier in verzonden XML worden geplaatst. De standaardwaarde is /. Als alle formulieren in een formulierset zijn gebonden met een schema en hetzelfde XML-schema delen, kunt u deze waarde wijzigen. Het wordt aanbevolen dat voor elk veld in het formulier de juiste gegevensbinding is opgegeven in de XDP. Als twee velden in twee verschillende formulieren dezelfde gegevensbinding hebben, worden in het tweede formulier voorgevulde waarden uit het eerste formulier weergegeven. Bind twee subformulieren met dezelfde interne inhoud niet aan hetzelfde XML-knooppunt. Zie voor meer informatie de XML-structuur van formulierset XML vooraf invullen voor formulierset.
- Belichtingsexpressie: Hiermee wordt een JavaScript-expressie opgegeven die een Booleaanse waarde evalueert en die aangeeft of een formulier in een formulierset kan worden ingevuld. Indien onwaar, wordt de gebruiker niet gevraagd of zelfs getoond het te vullen formulier. De expressie is doorgaans gebaseerd op de waarden van de velden die vóór dit formulier zijn vastgelegd. Expressies bevatten ook aanroepen van de formulierset-API fs.valueOf om de waarden te extraheren die de gebruiker heeft ingevuld in een veld van een formulierset:
fs.valueOf()<form identifier="">, <fieldsom expression="">) > <value>
Als de formulierset bijvoorbeeld twee formulieren bevat: voor bedrijfskosten en reiskosten kunt u een JavaScript-fragment toevoegen in het veld Belichtingsexpressie voor beide formulieren om de gebruikersinvoer voor het type kosten in een formulier te controleren. Als de gebruiker BedrijfsKosten kiest, wordt het formulier BedrijfsKosten teruggegeven aan het eind - gebruiker. Of als de gebruiker reiskosten kiest, wordt een ander formulier weergegeven aan de eindgebruiker. Zie Beleenbaarheidsuitdrukking voor meer informatie.
Bovendien kan de auteur ook een formulier uit de formulierset verwijderen met het pictogram Verwijderen in de rechterhoek van elke rij of een andere formulierset toevoegen met het pictogram '+ in de werkbalk. Deze '+ Met het pictogram ' wordt de gebruiker teruggeleid naar de vorige stap in de wizard die werd gebruikt voor 'Formulier(s) selecteren'. De bestaande selecties blijven behouden en eventuele extra selecties moeten aan de formulierset worden toegevoegd met het pictogram Toevoegen aan formulierset op die pagina.
note note NOTE Alle formulieren die in een formulierset worden gebruikt, worden beheerd door de gebruikersinterface van AEM Forms.
Een formulierset beheren managing-a-form-set
Nadat een formulierset is gemaakt, kunt u de volgende handelingen op die formulierset uitvoeren:
- Eén klik: Wanneer een formulierset wordt gemaakt en op de hoofdelementpagina wordt weergegeven, kunt u met één klik op de formulierset klikken om deze weer te geven. Er wordt een formulierset geopend en alle formuliersjablonen (XDP's) in die formulierset worden weergegeven.
- Bewerken: Als u op Bewerken klikt nadat u een formulierset hebt geselecteerd, wordt het scherm Formulier(s) configureren dat hierboven in Stappen wordt weergegeven om een formulierset te maken, geopend. U kunt alle functies uitvoeren die hier worden beschreven.
- Kopiëren en plakken: Op deze manier kunt u de gehele formulierset van de ene locatie kopiëren en op dezelfde locatie of in een andere map plakken.
- Downloaden: U kunt de formulierset met alle afhankelijke onderdelen downloaden.
- Revisie starten/beheren: Nadat u een formulierset hebt gemaakt, kunt u de revisie instellen door op Revisie starten te klikken. Nadat de revisie voor een formulierset is gestart, wordt de optie Revisie beheren aan de gebruiker weergegeven. In het revisiescherm Beheren kunt u de revisie bijwerken of beëindigen. Voor de revisies die u hebt toegevoegd, kunt u de revisie controleren en zo nodig opmerkingen toevoegen.
- Verwijderen: Hiermee verwijdert u de volledige formulierset. De formulieren in de verwijderde formulierset blijven in de gegevensopslagruimte.
- Publiceren/Publiceren ongedaan maken: Hiermee publiceert of publiceert u de formulierset samen met alle formulieren die erin staan en de bijbehorende elementen van deze formulieren.
- Voorvertoning: Voorvertoning biedt twee opties: Voorvertonen als HTML (zonder gegevens) en aangepaste voorvertoning met voorbeeldgegevens.
- Eigenschappen weergeven/bewerken: U kunt de eigenschappen van metagegevens van een geselecteerde formulierset weergeven of bewerken.
Een formulierset bewerken edit-a-form-set
Ga als volgt te werk om een formulierset te bewerken:
-
Selecteer Forms > Forms en Documenten.
-
Zoek de formulierset die u wilt bewerken. Houd de muisaanwijzer boven het object en selecteer Bewerken (
-
Op de pagina Formulier(s) configureren kunt u het volgende bewerken:
- Formuliervolgorde
- Formulierid
- Gegevensbasis
- Beleenbaarheidsuitdrukking
U kunt ook op het betreffende pictogram Verwijderen klikken om het formulier uit de formulierset te verwijderen.
Formulierset in Process Management form-set-in-process-management
Nadat u een formulierset hebt gemaakt met de gebruikersinterface van AEM Forms Management, kunt u de formulierset in een beginpunt gebruiken of Taakactiviteit toewijzen met Workbench.
Formulierset gebruiken in Taak- of beginpunt using-form-set-in-task-or-start-point
-
Als u een proces ontwerpt, selecteert u onder de sectie Presentatie en gegevens van Taak/Beginpunt toewijzen de optie een CRX-element gebruiken. De browser CRX Asset wordt weergegeven.
-
Selecteer een formulierset om de formulierset in AEM gegevensopslagruimte (CRX) te filteren.
-
Hiermee selecteert u een formulierset en klikt u op OK.
Subsidiabiliteitsexpressies eligibility-expressions
Geschiktheidsexpressies in een formulierset worden gebruikt om formulieren die voor een gebruiker worden weergegeven, te definiëren en dynamisch te beheren. Een bepaald formulier bijvoorbeeld alleen weergeven als de gebruiker tot een bepaalde leeftijdsgroep behoort. Een geschiktheidsexpressie opgeven en bewerken met behulp van formulierbeheer.
Een geschiktheidsexpressie kan elke geldige JavaScript-instructie zijn die een Booleaanse waarde retourneert. De laatste instructie in het JavaScript-codefragment wordt behandeld als een Booleaanse waarde die de geschiktheid van het formulier bepaalt op basis van de verwerking in de rest (vorige regels) van het JavaScript-codefragment. Als de waarde van de expressie true is, kan het formulier aan de gebruiker worden weergegeven. Dergelijke formulieren worden in aanmerking komende formulieren genoemd.
Naast de standaard JavaScript-functies stelt de formulierset ook de fs.valueOf API beschikbaar die toegang biedt tot de waarde van een veld in een formulierset. Gebruik deze API om toegang te krijgen tot de waarde van een formulierveld in een formulierset. De API-syntaxis is fs.valueOf (formUid, fieldSOM), waarbij:
- formUid (tekenreeks): Een unieke id van een formulier in de formulierset. U kunt dit opgeven tijdens het maken van de formulierset in de gebruikersinterface van formulierbeheer. Standaard is dit de naam van het formulier.
- fieldSOM (tekenreeks): A SOM expression of the field in the form specified by the formUid. De expressie SOM of de expressie Scripting Object Model wordt gebruikt om te verwijzen naar waarden, eigenschappen en methoden binnen een bepaald DOM (Document Object Model). U kunt dit in Formulierontwerper weergeven onder het tabblad Scripts als het veld is geselecteerd.
Voorbeelden examples
Geldig gebruik van de API:
fs.valueOf("form1", "xfa.form.form1.subform1.field1")
Ongeldig gebruik van de API:
var formUid = "form1";
var fieldSOM = “xfa.form.form1.subform1.field1"; fs.valueOf(formUid, fieldSOM);
XML vooraf invullen voor formulierset prefill-xml-for-form-set
De reeks van de vorm is een inzameling van veelvoudige HTML5 vormen die gemeenschappelijke of verschillende schema's hebben. Formulierset ondersteunt het vooraf invullen van formuliervelden met behulp van een XML-bestand. U kunt een XML-bestand aan een formulierset koppelen, zodat bepaalde velden in het formulier worden voorgepoleerd wanneer u een formulier in de formulierset opent.
Het vooraf ingevulde XML-bestand wordt opgegeven met de parameter dataRef van de URL van de formulierset. Met de parameter dataRef geeft u het absolute pad op van het XML-bestand met gegevens dat wordt samengevoegd met de formulierset.
U hebt bijvoorbeeld drie formulieren (form1, form2 en form3) in de formulierset met de volgende structuur:
form1
field
form1field
form2
field
form2field
form3
field
form3field
Elk formulier heeft een algemeen benoemd veld met de naam "field" en een uniek benoemd veld met de naam "formfield".
U kunt deze formulierset vooraf invullen met behulp van een XML met de volgende structuur:
<?xml version="1.0" encoding="UTF-8" ?>
<formSetRootTag>
<field>common field value</field>
<form1field>value1</form1field>
<form2field>value2</form2field>
<form3field>value3</form3field>
</formSetRootTag>
Het bovenstaande XML-fragment toont dat de vooraf ingevulde XML voor de formulierset een samenvoeging is van de vooraf ingevulde XML-fragmenten van de afzonderlijke formulieren. Als de gegevenshiërarchie/het schema van bepaalde velden in de verschillende formulieren op elkaar lijken, worden de velden voorgevuld met dezelfde waarden. In dit voorbeeld worden alle drie formulieren voorgevuld met dezelfde waarde voor het algemene veld, "field". Dit is een eenvoudige manier om gegevens van het ene formulier naar het andere over te brengen. Dit kan ook worden bereikt door de velden te binden aan hetzelfde schema of dezelfde referentie voor gegevens. Als u de gegevens van de formulierset wilt segregeren op basis van het schema van het formulier. Dit kan worden bereikt door tijdens het maken van de formulierset het kenmerk 'gegevensbasiskenmerk' van het formulier op te geven (de standaardwaarde is '/', die wordt toegewezen aan de basiscode van de formulierset).
In het vorige voorbeeld, als u de gegevenswortels specificeert: "/form1", "/form2" en "/form3" voor respectievelijk de drie formulieren moet u een vooraf ingevulde XML-code van de volgende structuur gebruiken:
<?xml version="1.0" encoding="UTF-8" ?>
<formSetRootTag>
<form1>
<field>field value1</field>
<form1field>value1</form1field>
</form1>
<form2>
<field>field value2</field>
<form2field>value2</form2field>
</form2>
<form3>
<field>field value3</field>
<form3field>value3</form3field>
</form3>
</formSetRootTag>
In een formulierset definieert de XML een XML-schema met de volgende syntaxis:
<formset>
<fs_data>
<xdp:xdp xmlns:xdp="https://ns.adobe.com/xdp/">
<xfa:datasets xmlns:xfa="https://www.xfa.org/schema/xfa-data/1.0/">
<xfa:data>
<rootElement>
... data ....
</rootElement>
</xfa:data>
</xfa:datasets>
</xdp:xdp>
</fs_data>
<fs_draft>
... private data...
</fs_draft>
</formset>
Beschrijving van vooraf ingevulde XML-elementen prefill-xml-elements-description
Syntaxisregels voor het maken van een vooraf ingevuld XML-bestand:
- bovenliggende elementen: element(en) dat het bovenliggende element kan zijn, waarbij null aangeeft dat het element zich aan de basis van de XML kan bevinden.
- kardinaliteit: geeft het aantal keren weer dat het element binnen het bovenliggende element kan worden gebruikt.
- submitXML: Hiermee wordt aangegeven of het element altijd aanwezig (P) of optioneel (O) is in de verzendende XML.
- prefillXML: Hiermee wordt aangegeven of het element vereist ® of optioneel (O) is in vooraf ingevulde XML.
- kinderen: Hiermee wordt aangegeven welke elementen onderliggende elementen kunnen zijn.
FORMSET formset
parent elements:
null
cardinality: [0,1]
submitXML: P
prefillXML: O
children: fs_data
Het hoofdelement van de XML-formulierset. Het wordt aangeraden dit woord niet te gebruiken als de naam van het basissubformulier van een formulier in de formulierset.
FS_DATA fs-data
parent elements:
formset
kardinaliteit: [1]
submitXML: P
prefillXML: O
children: xdp:xdp/rootElement
De substructuur geeft de gegevens van de formulieren in de formulierset aan. Het element is alleen optioneel in vooraf ingevulde XML als het formuliersetelement niet aanwezig is
XDP:XDP xdp-xdp
parent elements: fs_data/null
cardinality: [0,1]
submitXML: O
prefillXML: O
children: xfa:datasets
Dit label geeft het begin van HTML5 Form XML aan. Dit wordt toegevoegd in het verzendende XML als dit in de vooraf ingevulde XML aanwezig is of als er geen vooraf ingevulde XML is. Deze tag kan worden verwijderd uit de vooraf ingevulde XML.
XFA:DATASETS xfa-datasets
parent elements: xdp:xdp
cardinality: [1]
submitXML: O
prefillXML: O
children: xfa:data
XFA:GEGEVENS xfa-data
parent elements: xfa:datasets
cardinality: [1]
submitXML: O
prefillXML: O
children: rootElement
ROOTELEMENT rootelement
parent elements: xfa:datasets/fs_data/null
cardinality: [0,1]
submitXML: P
prefillXML: O
children: controlled by the Forms in Form set
Het name rootElement is slechts een plaatsaanduiding. De werkelijke naam wordt gekozen uit de formulieren die in de formulierset worden gebruikt. De substructuur die begint met rootElement bevat de gegevens van de velden en subformulieren in de Forms in de formulierset. Er zijn veelvoudige factoren die de structuur van rootElement en zijn kinderen bepalen.
In vooraf ingevulde XML is dit label optioneel, maar als het ontbreekt, wordt de volledige XML genegeerd.
NAAM VAN DE TAG BASISELEMENT
Als er een hoofdelement is in de vooraf ingevulde XML, wordt de naam van dat element ook gebruikt in de verzendings-XML. Wanneer er geen prefill-xml is, is de naam van het rootElement de naam van het basissubformulier van het eerste formulier in de formulierset met een eigenschap dataRoot ingesteld op "/". Als er geen dergelijk formulier is, is de rootElement-naam fs_dummy_root, dat een gereserveerd trefwoord is.
Formulierset in AEM Forms-app formset-in-workspace-app
Met de AEM Forms-app kunnen veldwerkers hun mobiele apparaten synchroniseren met een AEM Forms-server en aan hun taken werken. De toepassing werkt zelfs wanneer het apparaat offline is door gegevens lokaal op het apparaat op te slaan. Met behulp van annotatiefuncties, zoals foto's, kunnen veldwerkers nauwkeurige informatie verschaffen om te integreren in de bedrijfsprocessen.
Ga voor meer informatie over de AEM Forms-app naar AEM Forms-app.
Bekende beperkingen - patronen worden niet volledig ondersteund in de formulierset known-limitations-patterns-not-fully-supported-in-form-set
De volgende gegevenspatronen worden niet volledig ondersteund in de formulierset: