AEM アダプティブFormsの最小限の繰り返しと表示ルールによる繰り返し可能なパネルの動作
AEM アダプティブ Forms コアコンポーネントでは、最小繰り返しは繰り返し可能なインスタンスの最小数を設定します。最初のインスタンス数は0に設定されません。 繰り返し可能なパネルは、初期数が指定されていない場合に1つのインスタンスから始まります。 繰り返し可能なパネルのビジュアルルールエディタールールは最後のインスタンスに適用され、テスト済みのネストされたラッパーパターンは Add Instance に干渉する可能性があります。 フォームを安全に設計するには、最初のレンダリング、表示ルール、およびターゲット環境でのインスタンスの追加の動作をテストします。
説明 description
環境
コアコンポーネントと繰り返し可能なパネルを使用したAEM as a Cloud Service アダプティブForms
問題/症状
- 最小繰り返しを
0に設定しても、レビュー済みのコアコンポーネントランタイムでゼロの初期レンダリングが生成されません。 - 繰り返し可能なパネルの表示/非表示ルールでは、すべてのインスタンスの表示を確実に制御できません。 繰り返し可能パネルのビジュアルルールエディタールールが最後のインスタンスに適用されるAdobe ドキュメント。
- テストされたネストされたパネルのパターンでは、繰り返し可能なパネルを繰り返し不可能なパネルに折り返して表示を制御すると、 インスタンスを追加が妨げられます。
原因
最初の項目数が明示的に設定されていない場合、レビュー済みランタイムは、Math.max(1, minItems)を使用して少なくとも1つのインスタンスを持つ繰り返し可能なパネルを初期化します。 したがって、最小繰り返し値は、それ自体ではゼロの初期インスタンスを要求しません。 繰り返し可能なパネルのビジュアルルールエディタールールは、すべてのインスタンスを制御するのではなく、最後のインスタンスに適用されます。 テストされたネストされたラッパーパターンもAdd Instanceと干渉するので、ターゲット環境で代替フォーム構造を検証します。
解決策 resolution
繰り返し可能なパネルの動作を設計およびテストするには、次の手順に従います。
- AEM as a Cloud Service アダプティブForms コアコンポーネントでは、最小繰り返しを、最初のインスタンスが0件のリクエストとしてではなく、許可される最小数として扱います。
initialItemsが明示的に設定されていない場合、ランタイムは少なくとも1つのインスタンスを初期化します。 最小繰り返しをゼロに設定すると、すべてのインスタンスを削除できます。それ自体では、ゼロのインスタンスの初期レンダリングは生成されません。 - すべてのインスタンスを制御するために、繰り返し可能なパネルにアタッチされた1つのビジュアルルールエディタールールに依存しないでください。 繰り返し可能なパネルで作成されたルールが最後のインスタンスに適用されるAdobe ドキュメント。 要件が別の特定のインスタンスを対象としている場合は、文書化されたカスタム関数アプローチを使用して、ターゲットフォームでテストします。
- 正確な構造がテストされていない限り、「表示/非表示」ルールを適用するためだけに、繰り返し可能なパネルを繰り返し不可能なパネルにラップしないでください。 ドキュメントに記載されているネストされたパネルの複製では、このラッパーが Add Instance に干渉しました。
- フォームの初期読み込み時にインスタンスがゼロになる場合や、繰り返し可能なインスタンス間で条件付きの表示が必要な場合は、フォームを再設計するか、ターゲットランタイム用にレビューされたカスタムパネル実装を使用します。 Add Instanceおよび関連するルールを検証せずに、ラッパーをサポートされる回避策として扱わないでください。
- フォームのプレビューまたはレンダリング。 最初のインスタンス数、期待される表示/非表示の動作、インスタンスの追加および削除アクション(フォームで使用されるネストされた構造を含む)を確認します。
recommendation-more-help
experience-cloud-kcs-help-kbarticles