AEM自适应Forms中具有最低重复次数和可见性规则的可重复面板行为
在AEM自适应Forms核心组件中,最小重复次数设置最小可重复实例数;它不会将初始实例计数设置为零。 未指定初始计数时,可重复面板会从一个实例开始。 可重复面板上的可视规则编辑器规则应用于最后一个实例,并且测试的嵌套包装器模式可能会干扰添加实例。 要安全地设计表单,请在目标环境中测试初始渲染、可见性规则和添加实例行为。
描述 description
环境
使用核心组件和可重复面板的AEM as a Cloud Service自适应Forms
问题/症状
- 将 最小重复次数 设置为
0不会在审阅的核心组件运行时中生成零实例初始渲染。 - 可重复面板上的显示/隐藏规则无法可靠地控制每个实例的可见性。 重复面板上的可视规则编辑器规则应用于最后一个实例的Adobe文档。
- 在测试的嵌套面板图案中,在非可重复面板中封装可重复面板以控制可见性会干扰添加实例。
原因
未显式设置初始项数时,审阅运行时使用Math.max(1, minItems)初始化可重复面板,其中至少有一个实例。 因此,最小重复值本身不会请求零个初始实例。 可重复面板上的可视规则编辑器规则应用于最后一个实例,而不是控制所有实例。 测试的嵌套包装器模式也会干扰添加实例,因此验证目标环境中的任何替代表单结构。
解决方法 resolution
按照以下步骤设计和测试可重复面板行为:
- 在AEM as a Cloud Service自适应Forms核心组件中,将 最小重复次数 视为允许的最小计数,而不是视为对零初始实例的请求。 如果未显式设置
initialItems,运行时将至少初始化一个实例。 将最小重复次数设置为零允许删除所有实例;它本身不会生成零实例的初始渲染。 - 不要依赖附加到可重复面板的可视化规则编辑器规则来控制每个实例。 Adobe文档:在可重复面板上创建的规则适用于最后一个实例。 如果要求以另一个特定实例为目标,请使用记录的自定义函数方法,并以目标形式对其进行测试。
- 避免仅为了应用显示/隐藏规则而在非可重复面板中封装可重复面板,除非已测试确切的结构。 在记录的嵌套面板复制中,此包装器干扰了添加实例。
- 如果表单在初始加载时要求零个实例,或者要求跨可重复实例有条件可见,请重新设计表单或使用针对目标运行时审核的自定义面板实施。 如果不验证添加实例和相关规则,请勿将包装器视为支持的解决方法。
- 预览或渲染表单。 验证初始实例计数、预期的显示/隐藏行为以及添加实例和删除实例操作,包括表单中使用的嵌套结构。
recommendation-more-help
experience-cloud-kcs-help-kbarticles