コアコンポーネントのフォームコンテナコンポーネントを使用すれば、シンプルな送信フォームを作成できます。
フォームコンテナコンポーネントは、シンプルな WCM フォームをサポートしており、フォームコンポーネントの追加が可能なネスト構造を使用しているので、シンプルな情報送信フォームおよび機能を作成できます。
設定ダイアログを使用すると、フォーム送信でトリガーされるアクション、送信を処理する URL、ワークフローをトリガーするかどうかをコンテンツ編集者が定義できます。テンプレート作成者は、デザインダイアログを使用して、テンプレートエディターにおける標準レイアウトコンテナのデザインダイアログと同様に、許可されるコンポーネントとそのマッピングを定義できます。
コアコンポーネントのフォームコンテナコンポーネントでは、コアコンポーネントのフォームコンポーネント(ボタン、テキスト、非表示など)のみ使用できます。基盤コンポーネントのフォームコンポーネントをコアコンポーネントのフォームコンテナ内で使用すること(およびその逆の使用)はサポートされていません。
このドキュメントでは、フォームコンテナコンポーネントの現在のバージョン(2018年1月にコアコンポーネントのリリース 2.0.0 で導入された v2)について説明します。
コンポーネントのすべてのサポート対象バージョン、コンポーネントの各バージョンと互換性のある AEM バージョン、以前のバージョンのドキュメントへのリンクを次の表に示します。
コンポーネントのバージョン | AEM 6.4 | AEM 6.5 | AEM as a Cloud Service |
---|---|---|---|
v2 | リリース 2.17.4 以前と互換性あり |
互換性あり | 互換性あり |
v1 | 互換性あり | 互換性あり | 互換性あり |
コアコンポーネントのバージョンとリリースについて詳しくは、コアコンポーネントのバージョンを参照してください。
フォームコンテナコンポーネントを体験し、その設定オプションや HTML および JSON 出力の例を確認するには、コンポーネントライブラリを参照してください。
フォームコンテナコンポーネントに関する最新の技術ドキュメントについては、GitHub を参照してください。
コアコンポーネントの開発について詳しくは、コアコンポーネント開発者向けドキュメントを参照してください。
設定ダイアログでは、コンポーネントの送信時に実行されるアクションをコンテンツ作成者が定義できます。
選択したアクションタイプに応じて、コンテナ内で使用可能なオプションが変わります。使用可能なアクションタイプは次のとおりです。
タイプに関係なく、各アクションに適用される一般的な設定があります。
フォームが送信されると、「Post Form Data」アクションタイプにより、送信されたデータを JSON 形式でサードパーティに渡して処理させます。
転送されたフォームデータを処理するためにシステム管理者が調整できる追加のタイムアウトオプションが用意されています。詳しくは、GitHub の技術ドキュメントを参照してください。
アクションタイプが「Mail」の場合、フォームが送信されると、指定した受信者に電子メールが送信されます。
フォームが送信されると、フォームのコンテンツは、指定されたリポジトリの場所に保存されます。
ユーザーデータを管理しやすくしたり、問題点を分離できるようにするために、ユーザー生成コンテンツをリポジトリ内に格納することは、一般的には推奨されません。
代わりに、Post Form Data アクションタイプを使用して、ユーザーコンテンツを専用のサービスプロバイダーに渡します。
ありがとうページは、選択したアクションタイプに関係なくいつでも定義できます。
テンプレート作成者は、デザインダイアログを使用して、テンプレートエディターにおける標準レイアウトコンテナのデザインダイアログと同様に、許可されるコンポーネントとそのコンテナマッピングを定義できます。
フォームコンテナコンポーネントは、AEM スタイルシステムをサポートしています。