Met Adobe Experience Manager (AEM)-formulieren kunt u complexe transacties transformeren in eenvoudige, prachtige digitale ervaringen. Het vereist echter gezamenlijke inspanningen om een efficiënt en productief AEM Forms-ecosysteem te implementeren, op te bouwen, uit te voeren en in stand te houden.
Dit document bevat richtlijnen en aanbevelingen die beheerders, auteurs en ontwikkelaars van formulieren kunnen gebruiken wanneer ze met AEM Forms werken, en met name wanneer ze onderdelen voor adaptieve formulieren gebruiken. Hierin worden de beste werkwijzen besproken, van het instellen van een formulierontwikkelingsproject tot het configureren, aanpassen, ontwerpen en optimaliseren van AEM Forms. Deze beste praktijken dragen collectief bij tot de algemene prestaties van het ecosysteem van AEM Forms.
Daarnaast zijn er enkele aanbevelingen voor algemene AEM aanbevolen procedures:
Een vereenvoudigde en gestandaardiseerde projectstructuur kan de ontwikkeling en het onderhoud aanzienlijk verminderen. Apache Maven is een opensource tool die wordt aanbevolen voor het bouwen van AEM projecten.
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.
archetype:generate
gebruiken om de initiële structuur te genereren.eclipse:eclipse
bevel om de eclipse projectdossiers te produceren en het project in eclipse in te voeren.Zie voor meer informatie Hoe te om AEM Projecten te bouwen gebruikend Apache Maven.
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.
Wanneer u uw AEM project hebt ingesteld, definieert u een strategie voor het ontwerpen en aanpassen van adaptieve formuliersjablonen en componenten.
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.
Het is belangrijk om zorgvuldig het gegevensmodel te kiezen dat niet alleen aan uw vereisten voldoet maar uw bestaande investeringen in XFA en XSD activa uitbreidt, als om het even welk. Het wordt aanbevolen XSD-model te gebruiken om formuliersjablonen te maken, omdat de gegenereerde XML gegevens bevat volgens de XPATH-definitie in het schema. Het gebruik van XSD-model als standaardkeuze voor het formuliergegevensmodel helpt ook omdat het formulierontwerp loskoppelt van een back-end systeem dat gegevens verwerkt en verbruikt, en het verbetert de prestaties van het formulier door een-op-een-toewijzing van formuliervelden. BindRef van het veld kan ook de XPATH van de gegevenswaarde in XML worden gemaakt.
Zie voor meer informatie Een adaptief formulier maken.
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.
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.
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.
Zie ook componentbeschrijvingen en tips en trucs in Inleiding tot het ontwerpen van adaptieve formulieren.
AEM Forms biedt een regeleditor Hiermee kunt u regels maken om dynamisch gedrag toe te voegen aan adaptieve formuliercomponenten. Met deze regels kunt u voorwaarden evalueren en acties activeren op componenten, zoals velden weergeven of verbergen, waarden berekenen, vervolgkeuzelijst dynamisch wijzigen, enzovoort.
De redacteur van de regel verstrekt een visuele redacteur en een coderedacteur voor het schrijven van regels. Overweeg het volgende wanneer het schrijven van regels gebruikend de wijze van de coderedacteur:
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.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.
Met Aangepast voor thema's kunt u herbruikbare stijlen maken die op verschillende formulieren kunnen worden toegepast voor een consistente vormgeving. U wordt aangeraden thema's te gebruiken om stijlen voor formuliercomponenten en deelvensters te definiëren. De beste praktijken rond thema's zijn als volgt:
Zie voor meer informatie Thema's.
Auteurs van formulieren en eindgebruikers van formulieren hebben doorgaans te maken met prestatieproblemen bij het laden van grote formulieren in de ontwerpmodus of bij uitvoering. Naarmate het aantal objecten (velden en deelvensters) in het formulier toeneemt, wordt het ontwerp en de runtime minder prettig. Het voorkomt ook dat meerdere auteurs tegelijkertijd samenwerken en een formulier ontwerpen.
Overweeg de volgende aanbevolen procedures om prestatieproblemen met grote formulieren te verhelpen:
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.
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.
U kunt adaptieve formuliervelden vooraf invullen met gegevens die vanaf de achtergrond zijn opgehaald, zodat gebruikers het formulier snel kunnen invullen en typfouten kunnen voorkomen.
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.
Zie voor meer informatie Aangepaste formuliervelden vooraf invullen.
Voor adaptieve formulieren zijn acties verzenden vereist om door de gebruiker opgegeven gegevens te verwerken. Een handeling Verzenden bepaalt de taak die wordt uitgevoerd voor de gegevens die u verzendt met behulp van een adaptief formulier.
U kunt de multi-sign ervaring van Acrobat Sign in adaptieve vormen gebruiken. Houd rekening met het volgende wanneer u Acrobat Sign in adaptieve formulieren configureert. Zie voor meer informatie Acrobat Sign in een adaptieve vorm gebruiken.
Een recorddocument (DoR) is een afgevlakte PDF-versie van een adaptief formulier dat u kunt afdrukken, ondertekenen of archiveren.
Afhankelijk van het formuliergegevensmodel waarop een adaptief formulier is gebaseerd, kunt u als volgt een sjabloon configureren voor 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.
AEM Chrome-plug-in is een browserextensie voor Google Chrome die hulpprogramma's biedt voor het opsporen van fouten in adaptieve formulieren. Auteurs en ontwikkelaars van formulieren kunnen deze gereedschappen gebruiken:
Zie voor meer informatie AEM Chrome-plug-in - Adaptief formulier.
Calvin SDK is een hulpprogramma-API waarmee Adaptive Forms-ontwikkelaars Adaptive Forms kunnen testen. Calvin SDK is bovenop de Het testframework Hobbes.js. U kunt het framework gebruiken om het volgende te testen:
Zie voor meer informatie Testen van adaptieve formulieren automatiseren.
Validaties aan de serverzijde zijn vereist om te voorkomen dat er pogingen worden ondernomen om validaties op de client te omzeilen en dat er een mogelijk compromis ontstaat tussen gegevensverzending en overtredingen van de bedrijfsregels. Servervalidaties worden op de server uitgevoerd door de vereiste clientbibliotheek te laden.
AEM biedt vertaalworkflows waarmee u adaptieve formulieren kunt lokaliseren. Zie voor meer informatie Aangepaste formulieren lokaliseren met AEM vertaalworkflow.
U kunt het beste adaptieve formulieren als volgt lokaliseren:
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.
U kunt een extra instantie van de server van AEM Forms vormen die achter de firewall in een beveiligde streek verblijft. U kunt deze instantie gebruiken voor:
U moet vaak uw AEM projecten van één milieu naar een andere verplaatsen. Enkele belangrijke dingen die u moet onthouden tijdens het verplaatsen zijn:
Sommige beste praktijken om AEM te vormen om de algemene prestaties te verbeteren zijn als volgt:
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.
Beveiligde AEM Forms-server.
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.
In een productieomgeving wordt aanbevolen de ingediende formuliergegevens niet in AEM opslagplaats op te slaan. Bij de standaardimplementatie van Forms Portal Store, Store Content en Store PDF submit worden formuliergegevens opgeslagen in AEM opslagplaats. Deze indieningsacties zijn alleen bedoeld voor demonstratiedoeleinden. Bovendien maken de functies Opslaan, Hervatten en Automatisch opslaan standaard gebruik van poortopslag. Overweeg daarom de volgende aanbevelingen:
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 .
Een van de belangrijkste uitdagingen voor organisaties is hoe te om persoonlijk identificeerbare (PII) gegevens te behandelen. Hier volgt een aantal aanbevolen procedures voor het verwerken van dergelijke gegevens: