Aanbevolen werkwijzen voor het werken met adaptieve formulieren best-practices-for-working-with-adaptive-forms

Apache Maven gebruiken aem-project-archetype om structuur voor AEM project te creëren en te beheren. Het leidt tot geadviseerde structuur en malplaatjes voor uw AEM project. Ook, verstrekt het bouwstijlautomatisering en veranderingscontrolesystemen om het project te helpen beheren.

• De afbeelding gebruiken archetype:generate gebruiken om de initiële structuur te genereren.
• Gemaakt gebruiken eclipse:eclipse bevel om de eclipse projectdossiers te produceren en het project in eclipse in te voeren.

Met het gereedschap FileVault of VLT kunt u de inhoud van een CRX- of AEM-instantie toewijzen aan uw bestandssysteem. Het verstrekt verrichtingen van het veranderingsbeheer, zoals controle-binnen en controle-out van de AEM projectinhoud. Zie Het gereedschap VLT gebruiken.

Als u Eclipse-Geïntegreerde ontwikkelomgeving gebruikt, kunt u AEM hulpmiddelen van de Ontwikkelaar voor naadloze integratie van winde van de Verduistering met AEM instanties gebruiken om AEM toepassingen tot stand te brengen. Zie voor meer informatie Gereedschappen voor AEM ontwikkelaars voor Eclipse.

Een adaptieve formuliersjabloon is een gespecialiseerde AEM die structuur en de informatie over de kop- en voettekst van een adaptief formulier definieert. Een sjabloon heeft vooraf geconfigureerde indelingen, stijlen en basisstructuur voor een adaptief formulier. AEM Forms beschikt over out-of-the-box sjablonen en componenten waarmee u adaptieve formulieren kunt maken. U kunt echter naar wens aangepaste sjablonen en componenten maken. Het wordt aanbevolen vereisten te verzamelen voor aanvullende sjablonen en componenten die u nodig hebt in uw aangepaste formulieren. Zie voor meer informatie Aangepaste formulieren en componenten aanpassen.

Met AEM Forms kunt u adaptieve formulieren maken op basis van de volgende formuliermodellen. De formuliermodellen fungeren als interface voor gegevensuitwisseling tussen een formulier en AEM en bieden een op XML gebaseerde structuur voor gegevensstroom binnen en buiten een adaptief formulier. Bovendien leggen de formuliermodellen regels en beperkingen op aan adaptieve formulieren in de vorm van schema- en XFA-beperkingen.

• Geen: Voor adaptieve formulieren die met deze optie worden gemaakt, wordt geen formuliermodel gebruikt. De XML-gegevens die op basis van dergelijke formulieren worden gegenereerd, hebben een vlakke structuur met velden en bijbehorende waarden.
• XML- of JSON-schema: De schema's van XML en JSON vertegenwoordigen de structuur waarin de gegevens door het achterste deelsysteem in uw organisatie worden geproduceerd of worden verbruikt. U kunt een schema aan een adaptief formulier koppelen en de elementen ervan gebruiken om dynamische inhoud aan het aangepaste formulier toe te voegen. De elementen van het schema zijn beschikbaar op het tabblad Gegevensmodel van de inhoudbrowser voor het ontwerpen van adaptieve formulieren. U kunt de schema-elementen slepen en neerzetten om het formulier samen te stellen.
• XFA-formuliersjabloon: Het is een ideaal formuliermodel als u investeert in op XFA gebaseerde HTML5-formulieren. Dit biedt een directe manier om uw XFA-formulieren om te zetten in adaptieve formulieren. Bestaande XFA-regels blijven behouden in de bijbehorende adaptieve formulieren. De resulterende adaptieve formulieren ondersteunen XFA-constructies, zoals validaties, gebeurtenissen, eigenschappen en patronen.
• Formuliergegevensmodel: Het is een voorkeursformuliermodel als u uw back-endsystemen, zoals databases, webservices en AEM gebruikersprofiel, wilt integreren om adaptieve formulieren vooraf in te vullen en verzonden formuliergegevens terug te schrijven naar de back-endsystemen. Met een formuliergegevensmodeleditor kunt u entiteiten en services definiëren en configureren in een formuliergegevensmodel waarmee u adaptieve formulieren kunt maken. Zie voor meer informatie AEM Forms-gegevensintegratie.

AEM Forms biedt adaptieve formuliersjablonen die u kunt gebruiken om adaptieve formulieren te maken. U kunt ook uw eigen sjablonen maken. AEM biedt statische en bewerkbare sjablonen.

• Statische sjablonen worden gedefinieerd en geconfigureerd door ontwikkelaars.
• Bewerkbare sjablonen worden gemaakt door auteurs die de sjablooneditor gebruiken. Met de sjablooneditor kunt u een basisstructuur en initiële inhoud in een sjabloon definiëren. Wijzigingen in de structuurlaag worden in alle formulieren met die sjabloon doorgevoerd. De eerste inhoud kan een vooraf geconfigureerd thema, vooraf ingevulde service, verzendactie enzovoort bevatten. Deze instellingen kunnen echter wel worden gewijzigd voor een formulier in de formuliereditor. Zie voor meer informatie Aangepaste formuliersjablonen.

Gebruik voor het opmaken van een specifiek veld of een specifieke instantie in het deelvenster inline styling. U kunt ook een klasse definiëren in een CSS-bestand en de klassenaam opgeven in de CSS-klasseneigenschap van de component.

Neem een clientbibliotheek in een component op om stijlen consistent toe te passen op adaptieve formulieren of fragmenten die die component gebruiken. Zie voor meer informatie Een adaptief onderdeel van een formulierpagina maken.

Pas stijlen toe die zijn gedefinieerd in een clientbibliotheek om adaptieve formulieren te selecteren door het pad naar de clientbibliotheek op te geven in het veld CSS-bestandspad in de adaptieve eigenschappen van de formuliercontainer.

Als u een clientbibliotheek met uw stijlen wilt maken, kunt u het aangepaste CSS-bestand configureren in de basisclient van de Thema-editor of in de eigenschappen van de Form Container.

Aangepaste formulieren bieden deelvensterlay-outs, zoals responsieve formulieren, tabbladen, accordeons en wizard, om te bepalen hoe formuliercomponenten worden ingedeeld in een deelvenster. U kunt aangepaste deelvensterlay-outs maken en beschikbaar maken voor gebruik door formulierauteurs. Zie voor meer informatie Aangepaste indelingscomponenten voor aangepaste formulieren maken.

U kunt ook specifieke aangepaste formuliercomponenten aanpassen, zoals velden en de indeling van deelvensters.

• Gebruik de Bedekking functionaliteit van AEM om een kopie van een component te wijzigen. Het wordt afgeraden standaardcomponenten te wijzigen.
• De indeling van adaptieve formuliercomponenten buiten de box aanpassen in /libs aangepaste indelingscomponenten maken naast de standaardschermindelingen.
• Introduceer aangepaste interactiviteiten door aangepaste widgets of weergaven te maken. Het wordt afgeraden standaardcomponenten te wijzigen. Zie voor meer informatie Vormgevingskader.

Zie Persoonlijke identificeerbare gegevens verwerken voor aanbevelingen voor de verwerking van PII-gegevens.

Gebruik de browser Objecten in het zijpaneel om snel velden te openen die diep onder in de formulierhiërarchie liggen. Met het zoekvak kunt u zoeken naar objecten in het formulier of in de objectstructuur en van het ene object naar het andere navigeren.

Selecteer de component en klik op . U kunt ook dubbelklikken op een component om de eigenschappen ervan weer te geven in de eigenschappenbrowser.

Gebruik sneltoetsen om snel actie te ondernemen op uw formulieren. Zie AEM Forms-sneltoetsen.

Aangepaste formuliercomponenten worden alleen aanbevolen voor gebruik op adaptieve formulierpagina's. De componenten zijn afhankelijk van hun bovenliggende hiërarchie. Gebruik deze daarom niet op een AEM pagina.

Gebruik betekenisvolle en unieke namen voor formuliervelden en componenten om mogelijke conflicten te voorkomen tijdens het schrijven van regels.

Gebruiken this operator voor een component om naar zichzelf te verwijzen in een regelexpressie. Het zorgt ervoor dat de regel geldig blijft zelfs als de componentennaam verandert. Bijvoorbeeld, field1.valueCommit script: this.value > 10.

Gebruik componentnamen wanneer u naar andere formuliercomponenten verwijst. Gebruik de value eigenschap om de waarde van een veld of component op te halen. Bijvoorbeeld, field1.value.

Verwijs componenten door relatieve unieke hiërarchie om het even welk conflict te vermijden. Bijvoorbeeld, parentName.fieldName.

Wanneer u complexe of veelgebruikte regels afhandelt, kunt u bedrijfslogica als functies in een aparte clientbibliotheek schrijven die u kunt opgeven en hergebruiken voor adaptieve formulieren. De clientbibliotheek moet een zelfstandige bibliotheek zijn en mag geen externe afhankelijkheden hebben, behalve op jQuery en Underscore.js. U kunt ook de clientbibliotheek gebruiken om te controleren servervalidatie van de ingediende formuliergegevens.

Adaptieve formulieren bieden een set API's waarmee u kunt communiceren en waarmee u handelingen kunt uitvoeren op adaptieve formulieren. Enkele belangrijke API's zijn als volgt. Zie voor meer informatie JavaScript Library API-referentie voor Adaptive Forms.

• guideBridge.reset(): Hiermee herstelt u een formulier.

• guideBridge.submit(): Hiermee verzendt u een formulier.

• guideBridge.setFocus(somExp, focusOption, runCompletionExp): Hiermee wordt de focus op een veld ingesteld.

• guideBridge.validate(errorList, somExpression, focus): Valideert een formulier.

• guideBridge.getDataXML(options): Hiermee worden formuliergegevens opgehaald als XML.

• guideBridge.resolveNode(somExpression): Hiermee wordt een formulierobject opgehaald.

• guideBridge.setProperty(somList, propertyName, valueList): Hiermee wordt de eigenschap van een formulierobject ingesteld.

• Daarnaast kunt u de volgende veldeigenschappen gebruiken:

  • field.value om de waarde van een veld te wijzigen.
  • f ield.enabled om een veld in of uit te schakelen.
  • field.visible om de zichtbaarheid van een veld te wijzigen.

Auteurs van adaptieve formulieren moeten mogelijk JavaScript-code schrijven om bedrijfslogica in een formulier te maken. JavaScript is weliswaar krachtig en effectief, maar het is waarschijnlijk dat hierdoor de beveiligingsverwachtingen in het gedrang komen. Daarom moet u ervoor zorgen dat de auteur van het formulier een vertrouwd persoon is en dat er processen zijn om de JavaScript-code te controleren en goed te keuren voordat een formulier in productie wordt genomen. De beheerder kan de toegang tot de toegang van de regelredacteur tot gebruikersgroepen beperken die op hun rol of functie wordt gebaseerd. Zie De toegang van de regelredacteur van de subsidie tot uitgezochte gebruikersgroepen.

U kunt expressies in regels gebruiken om adaptieve formulieren dynamisch te maken. Alle expressies zijn geldige JavaScript-expressies en gebruiken API's van het scriptmodel voor aangepaste formulieren. Deze expressies retourneren waarden van bepaalde typen. Voor meer informatie over expressies en tips en trucs om deze heen raadpleegt u Adaptieve formulierexpressies.

Aanbevolen wordt om adaptieve formulieren te maken met behulp van XSD-formuliergegevensmodel, zelfs als een XFA wordt geconverteerd naar een adaptief formulier, indien mogelijk.

Neem alleen de velden en deelvensters op in adaptieve formulieren die informatie van de gebruiker vastleggen. Houd statische inhoud minimaal of gebruik URL's om deze in een apart venster te openen.

Hoewel elk formulier is ontworpen voor een bepaald doel, zijn er in de meeste formulieren enkele gangbare segmenten. Bijvoorbeeld persoonlijke gegevens, adres, arbeidsgegevens enzovoort. Maken adaptieve formulierfragmenten voor algemene formulierelementen en secties en deze in alle formulieren gebruiken. U kunt een deelvenster in een bestaand formulier ook opslaan als een fragment. Elke wijziging in een fragment wordt weerspiegeld in alle bijbehorende adaptieve formulieren. Het bevordert samenwerkingscreatie aangezien de veelvoudige auteurs aan verschillende fragmenten gelijktijdig kunnen werken die omhoog een vorm maken.

• Net als adaptieve formulieren wordt aangeraden dat alle fragmentspecifieke opmaak en aangepaste scripts in de clientbibliotheek worden gedefinieerd met behulp van het dialoogvenster Fragmentcontainer. Probeer ook zelf-voldoende fragmenten te maken die niet afhankelijk zijn van objecten buiten de fragmenten.
• Gebruik geen cross-fragments-scripts. Als er een object is buiten het fragment waarnaar u moet verwijzen, probeert u dat object te maken tot onderdeel van het bovenliggende formulier. Als het object zich nog steeds in een ander fragment moet bevinden, kunt u het met de naam ervan in het script raadplegen.

Met Opslaan en hervatten met automatisch opslaan kunt u het aangepaste formulier periodiek opslaan en gebruikers in staat stellen later opnieuw te klikken om het formulier in te vullen.

Configureer fragmenten die geleidelijk moeten worden geladen. Tijdens de runtime wordt een fragment dat is gemarkeerd om geladen, alleen gerenderd wanneer dit vereist is. Hierdoor wordt de laadtijd voor grote formulieren aanzienlijk verkort. Deze functie wordt ook ondersteund in fragmenten met herhaalbare deelvensters. Zie voor meer informatie Lazy laden configureren.

• Configureer lui laden niet op fragmenten in een responsieve rasterlay-out of in het eerste deelvenster.
• Componenten voor bestandsbijlagen en Algemene voorwaarden worden niet ondersteund in laaggeladen fragmenten.
• Markeer een waarde in een lazy geladen paneel als Waarde globaal gebruiken als die waarde in een ander deel van het formulier wordt gebruikt zodat de waarde beschikbaar is voor gebruik wanneer het bevattende paneel wordt verwijderd.
• U kunt zichtbaarheidsregels schrijven voor fragmenten die op basis van een voorwaarde moeten worden weergegeven of verborgen.

AEM Forms biedt een vooraf ingevulde service voor het lezen van gegevens uit een vooraf gedefinieerd XML-gegevensbestand en het vooraf invullen van de velden van een adaptief formulier met de inhoud in het vooraf ingevulde XML-bestand.

De XML van de vooraf ingevulde gegevens moet voldoen aan het schema van het formuliermodel dat is gekoppeld aan het adaptieve formulier.

Inclusief afBoundedData en afUnBoundedData secties in de vooraf ingevulde XML om zowel gebonden als niet-gebonden velden vooraf in een adaptief formulier in te vullen.

Voor adaptieve formulieren die zijn gebaseerd op het formuliergegevensmodel, biedt AEM Forms een vooraf ingevulde service voor het formuliergegevensmodel. De Prefill-service zoekt naar gegevensbronnen voor gegevensmodelobjecten in het adaptieve formulier en vult de veldwaarden vooraf in bij het weergeven van het formulier.

U kunt ook het bestand, de crx, de service of de http-protocollen gebruiken om adaptieve formulieren vooraf in te vullen.

AEM Forms biedt ondersteuning voor aangepaste Prefill-services die u kunt insluiten als een OSGi-service om adaptieve formulieren vooraf in te vullen.

Afhankelijk van het formuliergegevensmodel waarop een adaptief formulier is gebaseerd, kunt u als volgt een sjabloon configureren voor DoR:

• XFA-formuliersjabloon: Gebruik het bijbehorende XDP-bestand als de DoR-sjabloon.
• XSD-schema: Gebruik de bijbehorende XFA-sjabloon die hetzelfde XML-schema gebruikt als het adaptieve formulier.
• Geen: Gebruik automatisch gegenereerde doR.

Configureer kop-, voettekst-, afbeeldingen, kleur-, lettertype- en dergelijke rechts op het tabblad Document of Record van de adaptieve formuliereditor.

Gebruiken DoRService om DoR programmatically te produceren.

Verborgen velden uitsluiten van de DoR.

Gebruiken afAcceptLang request parameter to view DoR in another locale.

Gebruik adaptieve formulierfragmenten voor gemeenschappelijke elementen in verschillende formulieren en lokaliseer fragmenten. Zo weet u zeker dat u een fragment één keer lokaliseert en het geeft in alle formulieren weer waar het gelokaliseerde fragment wordt gebruikt.

Wijzigingen zoals het toevoegen van een nieuwe component of het toepassen van een script in een gelokaliseerd formulier, worden niet automatisch gelokaliseerd. Daarom moet u een formulier invullen voordat u het lokaliseert om meerdere lokalisatiecycli te voorkomen.

Gebruiken afAcceptLang request parameter to override the browser locale and render the form in the specified locale. Met de volgende URL wordt het formulier bijvoorbeeld geforceerd weergegeven in de Japanse landinstelling, ongeacht de landinstelling die in de browser is opgegeven:

https://[*server*]:[*port*]/<*contextPath*>/<*formFolder*>/<*formName*>.html?wcmmode=disabled&afAcceptLang=ja

AEM Forms ondersteunt momenteel de lokalisatie van adaptieve formulieren met inhoud in het Engels (en), Spaans (es), Frans (fr), Italiaans (it), Duits (de), Japans (ja), Portugees-Braziliaans (pt-BR), Chinees (zh-CN), Chinees-Taiwan (zh-TW) en Koreaans (ko-KR). U kunt echter tijdens runtime ondersteuning toevoegen voor nieuwe landinstellingen voor adaptieve formulieren. Zie voor meer informatie Ondersteuning voor nieuwe landinstellingen voor lokalisatie van adaptieve formulieren.

Compressie van HTML-clientbibliotheek voor JavaScript en CSS vanuit Felix Console inschakelen.

Alle clientbibliotheken in de cache opslaan /etc.clientlibs/fd en eventuele extra aangepaste clientbibliotheken op AEM dispatcher om de reactiesnelheid en beveiliging van uw gepubliceerde formulieren te verbeteren. Zie voor meer informatie Dispatcher.

Niet in cache plaatsen /content/forms/af/ en /content/dam/formsanddocuments/* paden. voor gedetailleerde informatie over het configureren van adaptieve formulieren in cache, raadpleegt u Aangepaste formulieren in cache plaatsen.

HTML inschakelen via de compressiemodule van de webserver. Zie voor meer informatie Prestaties afstemmen van AEM Forms-server.

Verhoog de aanroepen per aanvraagconfiguratie voor grote formulieren. Zie Prestaties van grote en complexe formulieren optimaliseren.

Maken aangepaste foutpagina's weergegeven door fouthandler.

Beveiligde AEM Forms-server.

• Gebruiken nosamplecontent Voer wijze in om ervoor te zorgen dat er geen steekproefinhoud en steekproefgebruikers op de productieserver worden opgesteld. Zie AEM uitvoeren in productielocatie.

Houd de heapgrootte tot minimaal 8 GB. Voor andere instellingen raadpleegt u Prestaties afstemmen van AEM Forms-server.

Gebruik gebruikerssessies voor services in plaats van beheersessies voor het uitvoeren van taken op serviceniveau. Zie voor meer informatie Serviceverificatie.

Conceptgegevens opslaan: Als u de functie Concept van adaptieve formulieren gebruikt, moet u een aangepaste Service Provider Interface (SPI) implementeren om conceptgegevens op te slaan in een veiligere opslag, zoals een database. Zie voor meer informatie Voorbeeld voor het integreren van concepten en verzendingen in de database.

Indieningsgegevens opslaan: Als u de Opslag van de Verzending van het Portaal van de Vorm gebruikt, zou u een douaneSPI moeten uitvoeren om voorleggingsgegevens in een gegevensbestand op te slaan. Zie Voorbeeld voor het integreren van concepten en verzendingen in de database voor een voorbeeldintegratie.

U kunt ook een aangepaste verzendactie schrijven waarmee formuliergegevens en bijlagen worden opgeslagen in een beveiligde opslagruimte. Zie Aangepaste verzendactie schrijven voor adaptieve formulieren voor meer informatie .