Forms の開発（クラシック UI） developing-forms-classic-ui

新しい sling フォルダー ( sling:Folder)

例：/etc/designs/<myDesign>/formlistvalues

ドロップダウンアイテムのリストを格納する複数値文字列タイプ（String[]）の新しいプロパティ（myList など）を追加します。コンテンツはスクリプト（JSP スクリプトやシェルスクリプトの curl など）を使用してインポートすることもできます。

フルパスを 項目読み込みパス フィールド：

例：/etc/designs/geometrixx/formlistvalues/myList

sling:Folder タイプのノードを作成します。実装するアクションを反映した名前を指定してください。

次に例を示します。

/apps/myProject/components/customFormAction

このノードで、次のプロパティを定義し、すべて保存 ​をクリックして、変更を保存してください。

• sling:resourceType - foundation/components/form/action に設定

• componentGroup - .hidden として定義

• オプション：

  • jcr:title - 選択したタイトルを指定します。これは、ドロップダウン選択リストに表示されます。設定されていない場合は、ノード名が表示されます
  • jcr:description - 任意の説明を入力します

フォルダー内に、ダイアログノードを作成します。

1. アクションを選択した後で作成者がフォームダイアログを編集できるように、フィールドを追加します。

フォルダーで、次のいずれかを作成します。

1. ポストスクリプト。

   スクリプトの名前は post.POST.<extension>例： post.POST.jsp

   フォームを処理するためにフォームが送信されると、post スクリプトが呼び出されます。このスクリプトには、フォームから到着したデータを処理するコードが含まれています POST.

2. フォームが送信されたときに呼び出される転送スクリプトを追加します。

   スクリプトの名前は forward.<extension>、例： forward.jsp

   このスクリプトは、パスを定義できます。 現在の要求が、指定されたパスに転送されます。
   必要な呼び出しは、FormsHelper#setForwardPath（2 つのバリアント）です。通常は、何らかの検証（ロジック）を実行して、ターゲットパスを見つけ、そのパスに転送し、デフォルトの Sling POST サーブレットで JCR への実際の保存を実行できるようにしてください。

また、フォームアクションと forward.jsp が「グルー」コードとしてのみ動作するような場合には、別のサーブレットで実際の処理を実行することもできます。その例として、/libs/foundation/components/form/actions/mail にあるメールアクションでは、メールサーブレットが配置されている <currentpath>.mail.html に詳細を転送します。

まとめると、次のようになります。

• post.POST.jsp は、アクション自体によって完全に実行される小さな操作に便利です。
• forward.jsp は、委任のみが必要な場合に便利です。

スクリプトは次の順序で実行されます。

• フォームのレンダリング時（GET）：

  1. init.jsp
  2. すべてのフィールドの制約に対して：clientvalidation.jsp
  3. フォームの validationRT：clientvalidation.jsp
  4. 設定されている場合は、読み込みリソースを介してフォームが読み込まれます
  5. <form></form>の内部レンダリング時にaddfields.jsp

• フォームの処理時（POST）：

  1. init.jsp
  2. すべてのフィールドの制約に対して：servervalidation.jsp
  3. フォームの validationRT：servervalidation.jsp
  4. forward.jsp
  5. 転送パスが設定されていた場合（FormsHelper.setForwardPath）、リクエストを転送し、その後、cleanup.jsp を呼び出します
  6. 転送パスを設定しなかった場合は、post.POST.jsp を呼び出します（ここで終了し、cleanup.jsp は呼び出しません）

再び必要に応じてフォルダーに以下を追加します。

1. フィールドを追加するためのスクリプト。

   スクリプトの名前は addfields.<extension>例： addfields.jsp

   addfields スクリプトは、フォーム開始のHTMLが記述された直後に呼び出されます。 これにより、カスタム入力フィールドなどの HTML をフォーム内に追加するアクションを実行できます。

2. 初期化スクリプト。

   スクリプトの名前は init.<extension>例： init.jsp

   このスクリプトは、フォームがレンダリングされると呼び出されます。 このスクリプトを使用して、アクションの詳細を初期化できます。``

3. クリーンアップスクリプト。

   スクリプトの名前は cleanup.<extension>例： cleanup.jsp

   このスクリプトを使用してクリーンアップを実行できます。

以下を使用： Forms parsys 内のコンポーネント。 この アクションタイプ ドロップダウンに新しいアクションが含まれます。

sling:Folder タイプのノードを作成します。実装する制約を反映した名前を指定します。

次に例を示します。

/apps/myProject/components/customFormConstraint

このノードで、次のプロパティを定義し、「すべて保存」をクリックして、変更を保存します。

• sling:resourceType - foundation/components/form/constraint に設定

• constraintMessage - フォームの送信時に、制約に照らしてフィールドが無効な場合に表示されるカスタマイズされたメッセージ

• 省略可能：

  • jcr:title - 選択したタイトルを指定します。これは選択リストに表示されます。設定されていない場合は、ノード名が表示されます
  • hint - ユーザーに向けたフィールドの使用方法に関する追加情報

このフォルダー内には、少なくとも次のどちらかのスクリプトが必要です。

• クライアント検証スクリプト：

  スクリプトの名前は clientvalidation.<extension>例： clientvalidation.jsp

  これは、フォームフィールドがレンダリングされると呼び出されます。 このスクリプトを使用すると、クライアントでフィールドを検証するクライアント JavaScript を作成できます。

• サーバー検証スクリプト：

  スクリプトの名前は servervalidation.<extension>例： servervalidation.jsp

  これは、フォームが送信されると呼び出されます。 この変数は、送信後にサーバー上のフィールドを検証するために使用できます。

特定のフォームコンポーネントを編集します。

選択 表示/非表示 開く 表示/非表示のルールを編集 ダイアログ：

• 最初のドロップダウンリストで、次のいずれかを選択します。 表示 または を隠す を使用して、コンポーネントの表示と非表示を条件で指定します。

• 上部行の末尾にあるドロップダウンリストで、以下を選択します。

  • すべて — コンポーネントを表示または非表示にするすべての条件が true である必要がある場合
  • 任意 - 1 つ以上の条件のみが true に設定されている場合に、コンポーネントを表示または非表示にします

• 条件行（デフォルトで表示されます）で、コンポーネント、演算子を選択し、値を指定します。

• 必要に応じて、「 」をクリックしてさらに条件を追加します。 条件を追加.

次に例を示します。

「OK」をクリックして、定義を保存します。

定義を保存した後、 ルールを編集 リンクが 表示/非表示 オプションを使用して、フォームコンポーネントのプロパティに追加します。 このリンクをクリックして、 表示/非表示のルールを編集 変更を加えるダイアログボックス

クリック OK をクリックして、すべての変更を保存します。