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 から受け取ったデータを処理するコードを含みます。

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）。
   このスクリプトを使用して、クリーンアップを実行できます。

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）
  これは、フォームを送信すると呼び出されます。このスクリプトを使用すると、フォームの送信後にサーバーでフィールドを検証できます。

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

「表示／非表示」を選択して、表示／非表示のルールを編集 ​ダイアログを開きます。

• 最初のドロップダウンリストで、「表示」または「非表示」を選択して、条件に応じてコンポーネントを表示するか、非表示にするかを指定します。

• 一番上の行の末尾にあるドロップダウンリストで、次のどちらかを選択します。

  • すべて - すべての条件を満たした場合に、コンポーネントが表示または非表示になります。
  • いずれか - 1 つでも条件を満たした場合に、コンポーネントが表示または非表示になります。

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

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

次に例を示します。

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

定義を保存すると、フォームコンポーネントプロパティの「表示／非表示」オプションの横に「ルールを編集」リンクが表示されます。そのリンクをクリックすると、表示／非表示のルールを編集 ​ダイアログボックスが開いて、変更できます。

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