Compatibilidade com versões anteriores do AEM Forms e impacto de atualização do SDK nos componentes proxy do Adaptive Forms
No Adobe Experience Manager (AEM) Forms, as organizações geralmente personalizam o Adaptive Forms usando componentes proxy de propriedade de projetos. Podem surgir dúvidas sobre como as atualizações do SDK afetam essas personalizações e como a política de compatibilidade com versões anteriores do Adobe se aplica às versões de componentes do Adaptive Forms. Para corrigir esse problema, siga as práticas de personalização compatíveis e valide todos os componentes proxy antes de promover atualizações para produção.
Descrição description
Ambiente
Adobe Experience Manager (AEM) as a Cloud Service (todas as versões)
Problema/Sintomas
- Preocupações com atualizações secundárias do SDK que afetam componentes proxy personalizados ou bibliotecas de clientes.
- Problemas observados após as atualizações do SDK em que o código personalizado foi afetado.
- Necessidade de clareza sobre as garantias de compatibilidade do Adobe para versões de componentes do Adaptive Forms.
Causa
Alterações menores ou compatíveis com versões anteriores nas versões de componentes do Adaptive Forms podem afetar os componentes proxy personalizados se essas personalizações dependerem de detalhes de implementação internos ou não documentados. As garantias de compatibilidade do Adobe se aplicam apenas aos pontos de extensão documentados e ao comportamento pronto para uso suportado, não às estruturas internas ou recursos sobrepostos.
Resolução resolution
Siga as etapas abaixo para resolver o problema:
- Configurar componentes proxy de propriedade de projeto: Use componentes proxy de propriedade de projeto com
sling:resourceSuperTypefazendo referência à versão necessária do componente Adobe Adaptive Forms. - Limitar alterações de componentes personalizados: Minimize as alterações personalizadas de HTL e da caixa de diálogo. Use somente APIs, eventos, seletores e pontos de extensão documentados.
- Criar bibliotecas de cliente de propriedade de projeto: Crie bibliotecas de cliente de propriedade de projeto separadas com nomes de categoria exclusivos.
- Proteger bibliotecas de cliente de propriedade da Adobe: Evite sobrepor ou modificar a base de tempo de execução compartilhada de propriedade da Adobe ou bibliotecas de cliente dependentes.
- Validar personalizações: valide todas as personalizações em um ambiente inferior antes de promover atualizações para produção. Após cada atualização de componente do SDK ou Forms, faça um teste de regressão em todos os componentes proxy e personalizações para renderização, criação, validação, regras, preenchimento prévio, envio, acessibilidade, carregamento da biblioteca do cliente e comportamento personalizado do JavaScript.
- Valide e promova atualizações do SDK: Se o projeto gerenciar a versão dos Componentes principais do Forms adaptável como uma dependência, atualize-a e implante-a em um ambiente mais baixo primeiro. Confirme se todos os componentes proxy personalizados e bibliotecas de clientes funcionam conforme esperado e promova a atualização para ambientes superiores por meio do processo de implantação padrão.
Notas
- A compatibilidade com versões anteriores se aplica ao comportamento pronto para uso com suporte, às APIs documentadas e aos pontos de extensão documentados para componentes do Adaptive Forms.
- Correções de erros e aprimoramentos compatíveis com versões anteriores podem ser fornecidos em uma versão existente do componente, desde que o contrato compatível seja mantido.
- Uma nova versão do componente é introduzida somente para alterações incompatíveis com versões anteriores no comportamento compatível ou pontos de extensão documentados.
- Os detalhes da implementação, como renderização HTL, estrutura HTML e DOM, classes CSS, comportamento do JavaScript, APIs do lado do cliente, validação, execução de regras, estrutura de diálogo e configuração e bibliotecas de clientes podem mudar na mesma versão de componente, desde que o contrato compatível seja mantido.
- Não há garantia de que as personalizações que dependem dos detalhes de implementação interna, como HTL copiado, estruturas DOM privadas, seletores não documentados ou bibliotecas de clientes Adobe sobrepostas, permanecerão inalteradas por atualizações secundárias.
- Os ambientes gerenciados pela Adobe não fornecem um switch de atualização automático separado, exclusivo para desenvolvimento.