Un profil est un nœud de ressources dans Apache Sling. Il représente une version personnalisée du service de rendu HTML5 forms. Vous pouvez utiliser le service de rendu HTML5 forms pour personnaliser l’apparence, le comportement et les interactions de HTML5 forms. Un nœud de profil existe dans le dossier /content du référentiel JCR. Vous pouvez mettre le nœud directement sous le dossier /content ou tout autre sous-dossier du dossier /content.

Le nœud de profil présente la propriété sling:resourceSuperType et la valeur par défaut est xfaforms/profile. Le script de rendu du nœud figure dans le dossier /libs/xfaforms/profile.

Les scripts Sling sont des scripts JSP. Ces scripts JSP servent de conteneurs pour rassembler le code HTML du formulaire demandé et les artefacts JS/CSS requis. Ces scripts Sling sont également appelés des scripts de rendu de profil. Le rendu de profil appelle le service Forms OSGi afin de générer le formulaire demandé.

Le script de profil est dans html.jsp et html.POST.jsp pour les demandes d’acquisition et de post-traitement. Vous pouvez copier et modifier un ou plusieurs fichiers à remplacer pour y ajouter vos personnalisations. N’apportez aucune modification car la mise à jour des correctifs écrase de telles modifications.

Un profil comporte divers modules : les modules formRuntime.jsp, config.jsp, toolbar.jsp, formBody.jsp, nav_footer.jsp, et footer.jsp.

formRuntime.jsp

Le module formRuntime.jsp contient des références aux bibliothèques client. Il décrit également des méthodes pour extraire des informations sur les paramètre régionaux dans la demande et inclure les messages dans la demande. Dans formRuntime.jsp, vous pouvez inclure des bibliothèques ou des styles javascript personnalisés. 

config.jsp

Le module config.jsp contient les différentes configurations telles que les services de journalisation, de proxy, et la version du comportement. Dans config.jsp, vous pouvez personnaliser les configurations et les widgets. Vous pouvez également y ajouter des configurations telles que l’enregistrement de widgets personnalisés. 

toolbar.jsp

Le module toolbar.jsp contient le code pour créer la barre d’outils colorée. Pour supprimer la barre d’outils, supprimez toolbar.jsp du module HTML.jsp

formBody.jsp

Le module de formBody.jsp sert à la représentation HTML du formulaire XFA.

HTML5 forms commence par générer uniquement la première page du formulaire. Lorsqu’un utilisateur fait défiler le formulaire, le reste des formulaires est chargé. La vitesse de chargement est ainsi optimisée. Le composant nav_footer.jsp contient tous les styles et éléments requis pour faciliter le chargement des pages dans le défilement.

footer.jsp

Le module footer.jsp est vide. Ce module vous permet d’ajouter des scripts qui ne sont utilisés que pour l’interaction utilisateur.

Création de profils personnalisés

Pour créer un profil personnalisé, procédez comme suit :

Créez un nœud de profil

  1. Accédez à l’interface CRX DE à l’adresse http://[serveur]:[port]/crx/de et connectez-vous à l’interface avec des informations d’identification utilisateur.

  2. Dans le panneau de gauche, rendez-vous à l’emplacement suivant : /content/xfaforms/profiles.

  3. Copiez le paramètre par défaut du noeud et collez le nœud dans un autre dossier(/content/profiles) intitulé hrform.

  4. Sélectionnez le nouveau nœud, hrform, puis ajoutez une propriété de chaîne : sling:resourceType avec la valeur : hrform/demo.

  5. Cliquez sur Enregistrer tout dans le menu de la barre d’outils pour enregistrer les modifications.

Créez un script de rendu de profil

Après la création d’un profil personnalisé, ajoutez les informations de rendu à ce profil. Lorsqu’il reçoit une demande pour le nouveau profil, CRX vérifie l’existence du dossier/apps pour la page JSP à générer. Créez la page JSP dans le dossier /apps.

  1. Dans le volet de gauche, accédez au dossier /apps.

  2. Effectuez un clic droit sur le dossier /apps et créez un dossier intitulé hrform.

  3. Dans hrform, créez un dossier intitulé demo.

  4. Cliquez sur le bouton Enregistrer tout.

  5. Naviguez jusqu’à /libs/xfaforms/html/profil.jsp et copiez le nœud html.jsp.

  6. Collez le nœud html.jsp dans le dossier /apps/hrform/démo créé au-dessus avec le même nom html.jsp et cliquez sur Enregistrer.

  7. Si vous rencontrez d’autres composants du script de profil, suivez les étapes 1 à 6 pour copier les composants dans le dossier /apps/hrform/demo.

  8. Pour vérifier que le profil est créé, ouvrez l’URL : http://[serveur]:[port]/content/xfaforms/profiles/hrform.html

Pour vérifier les formulaires, Importez les formulaires de votre système de fichiers local vers AEM Forms et affichez l’aperçu du formulaire sur l’instance d’auteur du serveur AEM.

Ce produit est distribué sous licence Creative Commons Attribution - Pas d’utilisation commerciale - Partage à l’identique 3.0 non transposé  Les publications Twitter™ et Facebook ne sont pas couvertes par les dispositions Creative Commons.

Mentions légales   |   Politique de confidentialité en ligne