Impacto de la compatibilidad con versiones anteriores de AEM Forms y la actualización de SDK en los componentes proxy de Forms adaptable
En Adobe Experience Manager (AEM) Forms, las organizaciones suelen personalizar Forms adaptable mediante componentes proxy propiedad del proyecto. Pueden surgir preguntas sobre cómo afectan las actualizaciones de SDK a estas personalizaciones y cómo se aplica la política de compatibilidad con versiones anteriores de Adobe a las versiones de los componentes de Forms adaptables. Para solucionar este problema, siga las prácticas de personalización admitidas y valide todos los componentes proxy antes de promocionar las actualizaciones en producción.
Descripción description
Entorno
Adobe Experience Manager (AEM) as a Cloud Service (todas las versiones)
Problema/Síntomas
- Preocupaciones sobre actualizaciones menores de SDK que afectan a componentes proxy personalizados o bibliotecas de cliente.
- Problemas observados después de las actualizaciones de SDK en los que se vio afectado el código personalizado.
- Necesidad de aclarar las garantías de compatibilidad de Adobe para las versiones de componentes de Forms adaptables.
Causa
Los cambios menores o compatibles con versiones anteriores de las versiones de los componentes de Forms adaptables pueden afectar a los componentes proxy personalizados si esas personalizaciones dependen de los detalles de implementación internos o no documentados. Las garantías de compatibilidad de Adobe solo se aplican a los puntos de extensión documentados y al comportamiento admitido de forma predeterminada, no a las estructuras internas ni a los recursos superpuestos.
Resolución resolution
Siga los pasos a continuación para resolver el problema:
- Configurar componentes proxy propiedad del proyecto: Usar componentes proxy propiedad del proyecto con
sling:resourceSuperTypeque hagan referencia a la versión del componente Adobe Adaptive Forms necesaria. - Limitar cambios en los componentes personalizados: Minimizar cambios personalizados en los cuadros de diálogo y HTL. Utilice únicamente API, eventos, selectores y puntos de extensión documentados.
- Crear bibliotecas de cliente de propiedad del proyecto: Cree bibliotecas de cliente de propiedad del proyecto independientes con nombres de categoría únicos.
- Proteger bibliotecas de cliente propiedad de Adobe: Evite superponer o modificar bibliotecas de cliente dependientes o bases de tiempo de ejecución compartidas propiedad de Adobe.
- Validar personalizaciones: Validar todas las personalizaciones en un entorno inferior antes de promocionar las actualizaciones a producción. Después de cada actualización de componente de SDK o Forms, realice una prueba de regresión de todos los componentes proxy y las personalizaciones para el procesamiento, la creación, la validación, las reglas, el relleno previo, el envío, la accesibilidad, la carga de la biblioteca de cliente y el comportamiento personalizado de JavaScript.
- Validar y promocionar actualizaciones de SDK: Si el proyecto administra la versión de los componentes principales de Forms adaptable como dependencia, actualícela e impleméntelo primero en un entorno inferior. Confirme que todos los componentes proxy personalizados y las bibliotecas de cliente funcionan según lo esperado y, a continuación, promocione la actualización a entornos superiores a través del proceso de implementación estándar.
Notas
- La compatibilidad con versiones anteriores se aplica al comportamiento predeterminado admitido, las API documentadas y los puntos de extensión documentados para los componentes de Forms adaptable.
- Las correcciones de errores y las mejoras compatibles con versiones anteriores pueden entregarse dentro de una versión de componente existente, siempre y cuando se mantenga el contrato compatible.
- La nueva versión del componente solo se introduce para cambios incompatibles con versiones anteriores en el comportamiento admitido o en los puntos de extensión documentados.
- Los detalles de implementación, como el procesamiento HTL, la estructura HTML y DOM, las clases CSS, el comportamiento de JavaScript, las API del lado del cliente, la validación, la ejecución de reglas, la estructura de diálogo y configuración y las bibliotecas de cliente pueden cambiar dentro de la misma versión del componente, siempre que se mantenga el contrato compatible.
- No se garantiza que las personalizaciones que dependen de detalles de implementación interna, como HTL copiado, estructuras DOM privadas, selectores no documentados o bibliotecas de cliente de Adobe superpuestas, no se vean afectadas por actualizaciones menores.
- Los entornos administrados por Adobe no proporcionan un conmutador de actualización automática independiente, solo para desarrollo.