Miglioramento delle prestazioni dei moduli di grandi dimensioni con caricamento lento improve-performance-of-large-forms-with-lazy-loading

CAUTION
AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.

Introduzione al caricamento pigro introduction-to-lazy-loading

Quando il modulo diventa grande e complesso con centinaia e migliaia di campi, gli utenti finali riscontrano un lungo tempo di risposta durante il rendering dei moduli in fase di esecuzione. Per ridurre al minimo il tempo di risposta, i moduli adattivi consentono di suddividere i moduli in frammenti logici e configurarli per posticipare l’inizializzazione o il caricamento dei frammenti fino a quando il frammento non deve essere visibile. Viene definito caricamento pigro. Inoltre, i frammenti configurati per il caricamento lento vengono scaricati quando l’utente passa ad altre sezioni del modulo e i frammenti non sono più visibili.

Prima di configurare il caricamento lento, comprendiamo i requisiti e i passaggi preparatori.

Preparazione del caricamento lento preparing-to-configure-lazy-loading

Prima di configurare il caricamento lento dei frammenti nel modulo adattivo, è importante definire strategie per la creazione dei frammenti, identificare i valori utilizzati negli script o a cui si fa riferimento in altri frammenti e definire regole per controllare la visibilità dei campi nei frammenti caricati in modo lento.

  • Identificare e creare frammenti
    È possibile configurare solo frammenti di modulo adattivi per il caricamento lento. Un frammento è un segmento autonomo che si trova al di fuori di un modulo adattivo e può essere riutilizzato nei diversi moduli. Quindi, il primo passo verso l'implementazione del caricamento pigro è quello di identificare le sezioni logiche in un modulo e convertirle in frammenti. È possibile creare un frammento da zero o salvare come frammento un pannello di modulo esistente.

    Per ulteriori informazioni sulla creazione dei frammenti, consulta Frammenti di moduli adattivi.

  • Identificare e contrassegnare i valori globali
    Le transazioni basate su Forms coinvolgono elementi dinamici per acquisire dati rilevanti dagli utenti ed elaborarli per semplificare l’esperienza di compilazione dei moduli. Ad esempio, nel modulo è presente il campo A nel frammento X il cui valore determina la validità del campo B in un altro frammento. In questo caso, se il frammento X è contrassegnato per il caricamento lento, il valore del campo A deve essere disponibile per convalidare il campo B anche quando il frammento X non è caricato. A questo scopo, è possibile contrassegnare il campo A come globale, in modo che il relativo valore sia disponibile per la convalida del campo B quando il frammento X non è caricato.

    Per informazioni su come rendere il valore di un campo globale, consulta Configurazione del caricamento lento.

  • Scrivere regole per controllare la visibilità dei campi
    Forms include alcuni campi e sezioni che non sono applicabili a tutti gli utenti e in tutte le condizioni. Gli autori e gli sviluppatori di Forms utilizzano regole di visibilità o di visualizzazione per controllarne la visibilità in base agli input degli utenti. Ad esempio, il campo Indirizzo ufficio non viene visualizzato agli utenti che scelgono Disoccupato nel campo Stato impiego di un modulo. Per ulteriori informazioni sulla scrittura delle regole, consulta Utilizzo dell’editor di regole.

    Puoi sfruttare le regole di visibilità nei frammenti caricati in modo che i campi condizionali vengano visualizzati solo quando sono obbligatori. Inoltre, contrassegna il campo condizionale globale per farvi riferimento nell’espressione di visibilità del frammento caricato in modo lento.

Configurazione del caricamento lento configuring-lazy-loading

Esegui i seguenti passaggi per abilitare il caricamento lento su un frammento di modulo adattivo:

  1. Apri il modulo adattivo in modalità di authoring contenente il frammento che desideri abilitare per il caricamento lento.

  2. Seleziona il frammento di modulo adattivo e tocca cmppr .

  3. Nella barra laterale, abilita Carica frammento pigro e toccare Fine.

    Abilita caricamento lento per il frammento di modulo adattivo

    Il frammento è ora abilitato per il caricamento lento.

È possibile contrassegnare come globali i valori degli oggetti contenuti nel frammento caricato in modo che siano disponibili per l’uso negli script quando il frammento contenitore non viene caricato. Effettua le seguenti operazioni:

  1. Apri il frammento di modulo adattivo in modalità di authoring.

  2. Tocca il campo di cui vuoi contrassegnare il valore come globale, quindi tocca .

  3. Nella barra laterale, abilita Usa valore durante il caricamento lento.
    Campo di carico pigro nella barra laterale

    Il valore è ora contrassegnato come globale e sarà disponibile per l’uso negli script anche quando il frammento contenitore viene scaricato.

Considerazioni e best practice per la configurazione del caricamento lento considerations-and-best-practices-for-configuring-lazy-loading

Alcune limitazioni, raccomandazioni e punti importanti da tenere a mente quando si lavora con il caricamento lento sono i seguenti:

  • Si consiglia di utilizzare moduli adattivi basati su schema XSD su moduli adattivi basati su XFA per configurare il caricamento lento su moduli di grandi dimensioni. Il guadagno di prestazioni dovuto all'implementazione lenta del caricamento nei moduli adattivi basati su XFA è relativamente inferiore rispetto al guadagno nei moduli adattivi basati su XSD.
  • Non configurare il caricamento lento sui frammenti in un layout a griglia reattiva. Può causare prestazioni degradate.
  • Si consiglia di non configurare il caricamento lento sui frammenti nel primo pannello che esegue il rendering al caricamento del modulo adattivo.
  • Nella gerarchia dei frammenti è supportato un massimo di due livelli.
  • Assicurati che i campi contrassegnati come globali siano univoci all'interno di un modulo adattivo.
  • È consigliabile scrivere regole di visibilità per i frammenti che devono essere visualizzati o nascosti in base a una condizione. Ad esempio, è possibile mostrare o nascondere il frammento Dettagli coniuge in base allo stato civile specificato da un utente.
  • I componenti Allegati file e Termini e condizioni non sono supportati nei frammenti caricati in modo lento.

Best practice di scripting per la configurazione del caricamento lento scripting-best-practices-for-configuring-lazy-loading

I punti importanti da tenere a mente durante lo sviluppo di script per pannelli di caricamento lenti sono i seguenti:

  • Assicurati che gli script di inizializzazione e di calcolo utilizzati nei campi di un frammento caricato con layout siano idempotenti in natura. Gli script impotenti sono quelli che hanno lo stesso effetto anche dopo più esecuzioni.

  • Utilizzare la proprietà disponibile a livello globale dei campi per rendere disponibile il valore dei campi situati in un pannello di caricamento lento a tutti gli altri pannelli di un modulo.

  • Non inoltrare il valore di riferimento di un campo all’interno di un pannello pigro indipendentemente dal fatto che il campo sia contrassegnato o meno a livello globale tra i frammenti.

  • Utilizza la funzione di reimpostazione del pannello per reimpostare tutti gli elementi visibili nel pannello utilizzando la seguente espressione di clic.

    guideBridge.resolveNode(guideBridge.getFocus({"focusOption": "navigablePanel"}).resetData()

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da