Comportement de panneau répétable avec un minimum de répétitions et de règles de visibilité dans AEM Adaptive Forms
Dans les composants principaux de Forms adaptatif d’AEM, la variable Répétitions minimales définit le nombre minimal d’instances répétables ; elle ne définit pas le nombre d’instances initial sur zéro. Un panneau répétable commence par une instance lorsqu’aucun comptage initial n’est spécifié. Les règles Visual Rule Editor sur un panneau répétable s’appliquent à la dernière instance et le modèle de wrapper imbriqué testé peut interférer avec Ajouter une instance . Pour concevoir le formulaire en toute sécurité, testez le rendu initial, les règles de visibilité et le comportement de l’option Ajouter une instance dans l’environnement cible.
Description description
Environnement
Forms adaptatif d’AEM as a Cloud Service à l’aide des composants principaux et des panneaux répétables
Problème/Symptômes
- La définition de Répétitions minimales sur
0ne génère pas de rendu initial d’instance zéro dans l’exécution des composants principaux révisée. - Une règle Afficher/Masquer sur un panneau répétable ne contrôle pas de manière fiable la visibilité de chaque instance. Les documents Adobe auxquels les règles de l’éditeur visuel de règles sur un panneau répétable s’appliquent à la dernière instance.
- Dans le modèle de panneau imbriqué testé, envelopper un panneau répétable dans un panneau non répétable pour contrôler la visibilité interfère avec Ajouter une instance.
Cause
Lorsqu’un nombre d’éléments initial n’est pas explicitement défini, le runtime révisé initialise un panneau répétable avec au moins une instance à l’aide de Math.max(1, minItems). La valeur minimale de répétition ne demande donc pas, à elle seule, zéro instance initiale. Les règles visuelles de l’éditeur de règles sur les panneaux répétables s’appliquent à la dernière instance plutôt qu’à toutes les instances. Le modèle de wrapper imbriqué testé interfère également avec Ajouter une instance , validez donc toute structure de formulaire alternative dans l’environnement cible.
Résolution resolution
Pour concevoir et tester le comportement du panneau répétable, procédez comme suit :
- Dans les composants principaux de Forms adaptatif d’AEM as a Cloud Service, traitez Répétitions minimales comme le nombre minimum autorisé, et non comme une demande de zéro instance initiale. Lorsque
initialItemsn’est pas défini explicitement, le runtime initialise au moins une instance. Définir les répétitions minimales sur zéro permet de supprimer toutes les instances ; cela ne produit pas, en soi, un rendu initial d’instance zéro. - Ne vous fiez pas à une règle de l’éditeur visuel de règles associée à un panneau répétable pour contrôler chaque instance. Les documents Adobe auxquels les règles créées sur un panneau répétable s’appliquent à la dernière instance. Si le besoin cible une autre instance spécifique, utilisez l’approche de fonction personnalisée documentée et testez-la dans le formulaire cible.
- Évitez d’envelopper un panneau répétable dans un panneau non répétable uniquement pour appliquer les règles Afficher/Masquer , sauf si la structure exacte a été testée. Dans la reproduction documentée de panneaux imbriqués, ce wrapper a interféré avec Ajouter une instance.
- Si le formulaire ne nécessite aucune instance au chargement initial ou une visibilité conditionnelle sur les instances répétables, reconcevez le formulaire ou utilisez une implémentation de panneau personnalisée révisée pour l’exécution cible. Ne considérez pas un wrapper comme une solution prise en charge sans vérifier Ajouter une instance et les règles associées.
- Prévisualisez ou effectuez le rendu du formulaire. Vérifiez le nombre d’instances initial, le comportement attendu d’affichage et de masquage, ainsi que les actions Ajouter une instance et Supprimer une instance , y compris la structure imbriquée utilisée dans le formulaire.