Comportamento del pannello ripetibile con ripetizioni minime e regole di visibilità in AEM Adaptive Forms
In AEM Adaptive Forms Core Components, Minimum ripetitions imposta il numero minimo di istanze ripetibili, ma non imposta il conteggio iniziale delle istanze su zero. Un pannello ripetibile inizia con un’istanza quando non è specificato alcun conteggio iniziale. Le regole dell’Editor di regole visive in un pannello ripetibile si applicano all’ultima istanza e il pattern di wrapper nidificato testato può interferire con Aggiungi istanza. Per progettare il modulo in modo sicuro, verifica il rendering iniziale, le regole di visibilità e il comportamento Aggiungi istanza nell’ambiente di destinazione.
Descrizione description
Ambiente
AEM as a Cloud Service Adaptive Forms con componenti core e pannelli ripetibili
Problema/Sintomi
- L’impostazione di ripetizioni minime su
0non produce un rendering iniziale a istanza zero nel runtime dei Componenti core revisionati. - Una regola Mostra/Nascondi su un pannello ripetibile non controlla in modo affidabile la visibilità di ogni istanza. Nei documenti di Adobe le regole dell’Editor di regole visive in un pannello ripetibile vengono applicate all’ultima istanza.
- Nel modello di pannello nidificato testato, il wrapping di un pannello ripetibile in un pannello non ripetibile per controllare la visibilità interferisce con Aggiungi istanza.
Causa
Quando il conteggio iniziale degli elementi non è impostato in modo esplicito, il runtime revisionato inizializza un pannello ripetibile con almeno un’istanza utilizzando Math.max(1, minItems). Il valore minimo di ripetizione pertanto non richiede, di per sé, nessuna istanza iniziale. Le regole dell’Editor di regole visive sui pannelli ripetibili si applicano all’ultima istanza, anziché controllare tutte le istanze. Il pattern di wrapper nidificato testato interferisce anche con Aggiungi istanza, pertanto convalida qualsiasi struttura di modulo alternativa nell’ambiente di destinazione.
Risoluzione resolution
Per progettare e testare il comportamento dei pannelli ripetibili, procedi come segue:
- Nei componenti core Forms adattivi di AEM as a Cloud Service, considera il numero minimo di ripetizioni come numero minimo consentito, non come richiesta per zero istanze iniziali. Se
initialItemsnon è impostato in modo esplicito, il runtime inizializza almeno un’istanza. Se si imposta il valore di ripetizioni minime su zero, tutte le istanze possono essere rimosse, ma non viene prodotto un rendering iniziale a istanza zero. - Non fare affidamento su una regola dell’Editor di regole visive collegata a un pannello ripetibile per controllare ogni istanza. Documenti di Adobe che le regole create su un pannello ripetibile si applicano all’ultima istanza. Se il requisito è destinato a un’altra istanza specifica, utilizza l’approccio documentato basato sulle funzioni personalizzate e testalo nel modulo di destinazione.
- Evita di racchiudere un pannello ripetibile in un pannello non ripetibile solo per applicare le regole Mostra/Nascondi, a meno che non sia stata testata la struttura esatta. Nella riproduzione documentata del pannello nidificato, questo wrapper ha interferito con Aggiungi istanza.
- Se il modulo richiede nessuna istanza al caricamento iniziale o visibilità condizionale tra istanze ripetibili, riprogetta il modulo o utilizza un’implementazione del pannello personalizzato esaminata per il runtime di destinazione. Non trattare un wrapper come soluzione alternativa supportata senza verificare Aggiungi istanza e le regole correlate.
- Visualizzare l’anteprima o il rendering del modulo. Verificare il conteggio iniziale delle istanze, il comportamento previsto per Mostra/Nascondi e le azioni Aggiungi istanza e Rimuovi istanza, inclusa la struttura nidificata utilizzata nel modulo.