Impact de la rétrocompatibilité AEM Forms et de la mise à jour SDK sur les composants proxy Forms adaptatifs
Dans Adobe Experience Manager (AEM) Forms, les entreprises personnalisent souvent le Forms adaptatif à l’aide de composants proxy appartenant au projet. Des questions peuvent se poser sur la manière dont les mises à jour de SDK affectent ces personnalisations et sur la manière dont la politique de rétrocompatibilité d’Adobe s’applique aux versions des composants de Forms adaptatif. Pour résoudre ce problème, suivez les pratiques de personnalisation prises en charge et validez tous les composants proxy avant de promouvoir les mises à jour en production.
Description description
Environnement
Adobe Experience Manager (AEM) as a Cloud Service (toutes les versions)
Problème/Symptômes
- Préoccupations relatives aux mises à jour SDK mineures affectant les composants proxy personnalisés ou les bibliothèques clientes.
- Problèmes observés après les mises à jour de SDK où le code personnalisé était affecté.
- Besoin de clarté sur les garanties de compatibilité d’Adobe pour les versions de composants de Forms adaptatif.
Cause
Les modifications mineures ou rétrocompatibles apportées aux versions des composants de Forms adaptatif peuvent affecter les composants proxy personnalisés si ces personnalisations reposent sur des détails d’implémentation internes ou non documentés. Les garanties de compatibilité d’Adobe s’appliquent uniquement aux points d’extension documentés et aux comportements prêts à l’emploi pris en charge, et non aux structures internes ou aux ressources superposées.
Résolution resolution
Suivez les étapes ci-dessous pour résoudre le problème :
- Configurer les composants proxy appartenant au projet : utilisez les composants proxy appartenant au projet avec
sling:resourceSuperTyperéférençant la version requise du composant Forms adaptatif Adobe. - Limiter les modifications de composant personnalisé : réduisez les modifications de HTL et de boîte de dialogue personnalisés. Utilisez uniquement des API, des événements, des sélecteurs et des points d’extension documentés.
- Créer des bibliothèques clientes appartenant au projet : créez des bibliothèques clientes distinctes appartenant au projet avec des noms de catégorie uniques.
- Protéger les bibliothèques clientes appartenant à Adobe : évitez de remplacer ou de modifier la base d’exécution partagée appartenant à Adobe ou les bibliothèques clientes dépendantes.
- Valider les personnalisations : validez toutes les personnalisations dans un environnement inférieur avant de promouvoir les mises à jour de production. Après chaque mise à jour des composants SDK ou Forms, testez en régression tous les composants proxy et les personnalisations pour le rendu, la création, la validation, les règles, le préremplissage, l’envoi, l’accessibilité, le chargement de la bibliothèque cliente et le comportement personnalisé de JavaScript.
- Valider et promouvoir les mises à jour de SDK : si le projet gère la version des composants principaux de Forms adaptatif en tant que dépendance, mettez-la à jour et déployez-la d’abord dans un environnement inférieur. Vérifiez que tous les composants proxy personnalisés et les bibliothèques clientes fonctionnent comme prévu, puis promouvez la mise à jour vers des environnements supérieurs par le biais de votre processus de déploiement standard.
Remarques
- La rétrocompatibilité s’applique au comportement prêt à l’emploi pris en charge, aux API documentées et aux points d’extension documentés pour les composants de Forms adaptatif.
- Les correctifs de bugs et les améliorations rétrocompatibles peuvent être fournis dans une version de composant existante tant que le contrat pris en charge est conservé.
- Une nouvelle version de composant est introduite uniquement pour les modifications rétrocompatibles apportées au comportement pris en charge ou aux points d’extension documentés.
- Les détails de mise en œuvre tels que le rendu HTL, la structure HTML et DOM, les classes CSS, le comportement de JavaScript, les API côté client, la validation, l’exécution des règles, la boîte de dialogue et la structure de configuration, ainsi que les bibliothèques clientes peuvent changer au sein de la même version de composant, à condition que le contrat pris en charge soit conservé.
- Il n’est pas garanti que les personnalisations qui dépendent de détails d’implémentation internes, tels que le HTL copié, les structures DOM privées, les sélecteurs non documentés ou les bibliothèques clientes Adobe superposées, ne soient pas affectées par les mises à jour mineures.
- Les environnements gérés par Adobe ne fournissent pas de commutateur séparé de mise à niveau automatique uniquement pour le développement.