Compatibilità con le versioni precedenti di AEM Forms e impatto degli aggiornamenti di SDK sui componenti proxy di Adaptive Forms
In Adobe Experience Manager (AEM) Forms, le organizzazioni spesso personalizzano Adaptive Forms utilizzando componenti proxy di proprietà del progetto. Possono sorgere domande sul modo in cui gli aggiornamenti di SDK influiscono su queste personalizzazioni e sul modo in cui i criteri di compatibilità con le versioni precedenti di Adobe si applicano alle versioni dei componenti di Forms adattivi. Per risolvere questo problema, segui le procedure di personalizzazione supportate e convalida tutti i componenti proxy prima di promuovere gli aggiornamenti alla produzione.
Descrizione description
Ambiente
Adobe Experience Manager (AEM) as a Cloud Service (tutte le versioni)
Problema/Sintomi
- Problemi relativi ad aggiornamenti minori di SDK che influiscono sui componenti proxy personalizzati o sulle librerie client.
- Problemi osservati dopo gli aggiornamenti di SDK in cui il codice personalizzato è stato interessato.
- È necessario fare chiarezza sulle garanzie di compatibilità di Adobe per le versioni dei componenti Adaptive Forms.
Causa
Modifiche minori o compatibili con le versioni precedenti delle versioni dei componenti Adaptive Forms possono influire sui componenti proxy personalizzati se tali personalizzazioni si basano su dettagli di implementazione interni o non documentati. Le garanzie di compatibilità di Adobe si applicano solo ai punti di estensione documentati e al comportamento predefinito supportato, non alle strutture interne o alle risorse sovrapposte.
Risoluzione resolution
Per risolvere il problema, segui i passaggi seguenti:
- Configurare i componenti proxy di proprietà del progetto: Utilizzare i componenti proxy di proprietà del progetto con
sling:resourceSuperTypeche fa riferimento alla versione richiesta del componente Forms adattivo di Adobe. - Limita modifiche componenti personalizzati: Riduci a icona HTL personalizzato e le modifiche apportate alle finestre di dialogo. Utilizza solo API, eventi, selettori e punti di estensione documentati.
- Creare librerie client di proprietà del progetto: Creare librerie client di proprietà del progetto separate con nomi di categoria univoci.
- Proteggi le librerie client di proprietà di Adobe: evita di sovrapporre o modificare la base di runtime condiviso di Adobe o le librerie client dipendenti.
- Convalida personalizzazioni: Convalida tutte le personalizzazioni in un ambiente inferiore prima di promuovere gli aggiornamenti in produzione. Dopo ogni aggiornamento dei componenti SDK o Forms, esegui un test di regressione per tutti i componenti proxy e le personalizzazioni per il rendering, l’authoring, la convalida, le regole, la precompilazione, l’invio, l’accessibilità, il caricamento delle librerie client e il comportamento personalizzato di JavaScript.
- Convalidare e promuovere gli aggiornamenti di SDK: Se il progetto gestisce la versione dei Componenti core di Forms adattivi come dipendenza, devi prima aggiornarla e distribuirla in un ambiente inferiore. Verifica che tutti i componenti proxy personalizzati e le librerie client funzionino come previsto, quindi promuovi l’aggiornamento ad ambienti superiori tramite il processo di distribuzione standard.
Note
- La compatibilità con le versioni precedenti si applica al comportamento predefinito supportato, alle API documentate e ai punti di estensione documentati per i componenti Adaptive Forms.
- È possibile fornire correzioni di bug e miglioramenti compatibili con le versioni precedenti all’interno di una versione di un componente esistente, purché venga mantenuto il contratto supportato.
- Una nuova versione del componente viene introdotta solo per modifiche non compatibili con le versioni precedenti del comportamento supportato o dei punti di estensione documentati.
- I dettagli dell’implementazione come il rendering HTL, la struttura HTML e DOM, le classi CSS, il comportamento JavaScript, le API lato client, la convalida, l’esecuzione delle regole, la struttura delle finestre di dialogo e della configurazione e le librerie client possono cambiare all’interno della stessa versione del componente, purché venga mantenuto il contratto supportato.
- Le personalizzazioni che dipendono dai dettagli di implementazione interni, come HTL copiato, strutture DOM private, selettori non documentati o librerie client sovrapposte di Adobe, non saranno influenzate da aggiornamenti minori.
- Gli ambienti gestiti da Adobe non forniscono uno switch di aggiornamento automatico separato solo per lo sviluppo.