Wiederholbares Bedienfeldverhalten mit minimalen Wiederholungen und Sichtbarkeitsregeln in AEM Adaptive Forms
In den AEM Adaptive Forms-Kernkomponenten Mindestanzahl der Wiederholungen wird die Mindestanzahl der wiederholbaren Instanzen festgelegt. Die anfängliche Instanzanzahl wird dabei nicht auf null gesetzt. Ein wiederholbarer Bereich beginnt mit einer Instanz, wenn keine Anfangsanzahl angegeben ist. Die Regeln des visuellen Regeleditors in einem wiederholbaren Bereich gelten für die letzte Instanz, und das getestete verschachtelte Wrapper-Muster kann die Instanz hinzufügen beeinträchtigen. Um das Formular sicher zu gestalten, testen Sie das anfängliche Rendering, die Sichtbarkeitsregeln und das Verhalten der Instanz hinzufügen in der Zielumgebung.
Beschreibung description
Umgebung
AEM as a Cloud Service Adaptive Forms mit Kernkomponenten und wiederholbaren Bedienfeldern
Problem/Symptome
- Das Festlegen Mindestanzahl Wiederholungen) auf
0führt nicht zu einem erstmaligen Rendering auf Null-Instanz in der überprüften Kernkomponenten-Laufzeit. - Eine Ein-/Ausblenden-Regel in einem wiederholbaren Bereich steuert die Sichtbarkeit nicht zuverlässig für jede Instanz. Adobe dokumentiert, dass die Regeln des visuellen Regeleditors in einem wiederholbaren Bereich auf die letzte Instanz angewendet werden.
- Im getesteten Muster für verschachtelte Bereiche beeinträchtigt das Umschließen eines wiederholbaren Bereichs in einen nicht wiederholbaren Bereich zur Steuerung der Sichtbarkeit die Instanz hinzufügen.
Ursache
Wenn eine anfängliche Elementanzahl nicht explizit festgelegt ist, initialisiert die überprüfte Laufzeit einen wiederholbaren Bereich mit mindestens einer Instanz mithilfe von Math.max(1, minItems). Der minimale Wiederholungswert fordert daher für sich genommen nicht null anfängliche Instanzen an. Die Regeln des visuellen Regeleditors für wiederholbare Bereiche gelten für die letzte Instanz, anstatt alle Instanzen zu steuern. Das getestete Muster für verschachtelte Wrapper beeinträchtigt auch die Funktion „Instanz hinzufügen“, überprüfen Sie also jede alternative Formularstruktur in der Zielumgebung.
Lösung resolution
Führen Sie die folgenden Schritte aus, um das Verhalten von wiederholbaren Bereichen zu entwerfen und zu testen:
- Behandeln Sie in den AEM as a Cloud Service Adaptive FormsKernkomponenten " Wiederholungen“ als zulässige Mindestanzahl und nicht als Anforderung für null anfängliche Instanzen. Wenn
initialItemsnicht explizit festgelegt ist, initialisiert die Laufzeit mindestens eine Instanz. Wenn Sie die Mindestanzahl der Wiederholungen auf null setzen, können alle Instanzen entfernt werden. Dies führt allein nicht zu einem anfänglichen Rendering mit null Instanz. - Verlassen Sie sich nicht auf eine einzige Regel des visuellen Regeleditors, die an ein wiederholbares Bedienfeld angehängt ist, um jede Instanz zu steuern. Adobe dokumentiert, dass die in einem wiederholbaren Bereich erstellten Regeln auf die letzte Instanz angewendet werden. Wenn die Anforderung auf eine andere spezifische Instanz abzielt, verwenden Sie den dokumentierten Ansatz mit benutzerdefinierten Funktionen und testen Sie ihn im Zielformular.
- Vermeiden Sie es, ein wiederholbares Bedienfeld in ein nicht wiederholbares Bedienfeld einzuschließen, nur um Regeln zum Ein-/Ausblenden anzuwenden, es sei denn, die genaue Struktur wurde getestet. In der dokumentierten verschachtelten Bereichsreproduktion beeinträchtigte dieser Wrapper die Instanz hinzufügen.
- Wenn für das Formular beim ersten Laden keine Instanzen und bei wiederholbaren Instanzen keine bedingte Sichtbarkeit erforderlich sind, gestalten Sie das Formular neu oder verwenden Sie eine benutzerdefinierte Bereichsimplementierung, die für die Target-Laufzeit überprüft wird. Behandeln Sie einen Wrapper nicht als unterstützte Problemumgehung, ohne Instanz hinzufügen und zugehörige Regeln zu überprüfen.
- Anzeigen einer Vorschau oder Rendern des Formulars Überprüfen Sie die anfängliche Anzahl der Instanzen, das erwartete Verhalten beim Ein-/Ausblenden und die Aktionen „Instanz hinzufügen“ und „Instanz entfernen“, einschließlich der im Formular verwendeten verschachtelten Struktur.