ファイル添付コンポーネント file-attachment-adaptive-forms-core-component

送信された値のデータタイプ機能は、早期導入プログラムで利用できます。 早期導入プログラムに参加し、機能へのアクセスをリクエストするには、公式メール ID から aem-forms-ea@adobe.com にメールを送信してください。

アダプティブフォームのファイル添付コンポーネントを使用すると、ユーザーはローカルコンピューターまたはデバイスからファイルを選択してアップロードできます。ファイル添付コンポーネントは、特定のファイルタイプ、サイズ制限、複数の添付ファイルを許可するように設定できます。

例

使用方法 reasons-to-use-file-attachment

アダプティブフォームにファイル添付コンポーネントを含める方がメリットが大きい理由はいくつかあります。例えば、次のような理由があります。

  • 追加情報の収集:ユーザーはフォーム送信の一環として、ドキュメント、画像、ビデオまたはその他のタイプのファイルをアップロードできます。これは、履歴書、ポートフォリオ、サポートドキュメントなどの追加情報を収集する場合に役立ちます。

  • サイズの大きいファイルを簡単に共有:外部のファイル共有サービスに依存することなく、大きなファイルを簡単に共有できます。

  • 利便性:ユーザーはフォームから移動したり他のツールを使用したりしなくても、ローカルのコンピューターからファイルをアップロードできます。

  • データ分析:様々なソースからデータを収集して分析したり、入力として使用してさらに処理を行ったりできます。

  • ユーザーエクスペリエンス:ユーザーがファイルをアップロードする際に直感的で明確な方法を提供することで、フォームをより使いやすくすることができます。

バージョンと互換性 version-and-compatibility

アダプティブ Formsのファイル添付コアコンポーネントは、Cloud Serviceのコアコンポーネント 2.0.4 およびAEM 6.5.16.0 Forms以降のコアコンポーネント 1.1.12 の一部として 2023 年 2 月にリリースされました。 次の表に、サポートされているすべてのバージョン、AEM の互換性、対応するドキュメントへのリンクを示します。

コンポーネントのバージョン
AEM as a Cloud Service
AEM 6.5.16.0 Forms 以降
v1
リリース 2.0.4 以降と互換性あり
リリース 1.1.12 以降、2.0.0 未満と互換性があります。

コアコンポーネントのバージョンとリリースについて詳しくは、コアコンポーネントのバージョンドキュメントをご覧ください。

技術的詳細 technical-details

アダプティブフォームのファイル添付のコアコンポーネントに関する最新情報については、GitHub のテクニカルドキュメントをご覧ください。コアコンポーネントの開発について詳しくは、コアコンポーネント開発者向けドキュメントをご覧ください。

設定ダイアログ configure-dialog

設定ダイアログでは、訪問者によるファイル添付の操作を簡単にカスタマイズできます。 また、簡単にファイル添付オプションを定義して、シームレスなユーザーエクスペリエンスを実現することもできます。

「基本」タブ basic-tab

「基本」タブ

  • 名前 - フォームコンポーネントは、フォーム内とルールエディター内の両方で一意の名前で簡単に識別できますが、名前にスペースや特殊文字を含めることはできません。

  • タイトル - タイトルを使用すると、フォーム内のコンポーネントを簡単に識別できます。デフォルトでは、コンポーネントの上にタイトルが表示されます。 タイトルを追加しない場合、コンポーネントの名前がタイトルテキストの代わりに表示されます。

  • タイトルのリッチテキストを許可 - この機能により、ユーザーは、太字、斜体、下線付きのテキスト、様々なフォント、フォントサイズ、カラー、追加オプションなどの機能を組み込んで、プレーンテキストのタイトルを書式設定でき、視覚的なプレゼンテーションとカスタマイズが強化されます。 これにより、ドキュメント、web サイト、アプリケーション内でタイトルを目立たせる際の柔軟性とクリエイティブなコントロールが向上します。
    タイトルのリッチテキストを許可」 チェックボックスをオンにすると、コンポーネントのタイトルをスタイル設定するための書式設定オプションが表示されます。 使用可能なすべての書式設定オプションにアクセスするには、 全画面表示アイコン タブをクリックします。

    リッチテキストのサポート

  • タイトルを非表示 - コンポーネントのタイトルを非表示にする場合は、このオプションを選択します。

  • ボタンのタイトル - このオプションは、アダプティブフォームに表示されるボタンのラベルを設定するために使用されます。

  • バインド参照 - バインド参照は、外部データソースに保存され、フォーム内で使用されるデータ要素への参照です。バインド参照を使用すると、データをフォームフィールドに動的にバインドして、フォームにデータソースの最新のデータを表示できます。 例えば、フォームに入力された顧客 ID に基づいて、顧客の名前と住所をフォームに表示できます。 さらに、フォームに入力されたデータでデータソースを更新することもできます。 このようにして、AEM Forms で外部データソースとやり取りするフォームを作成し、データの収集と管理においてシームレスなユーザーエクスペリエンスを提供できます。

  • 非連結フォーム要素としてマーク:どのスキーマにもリンクされていないフォームフィールドを設定する場合は、このオプションを選択します。 このオプションを使用すると、データソースを更新せずにデータを保存できます。 また、標準のデータベース統合とは別に、カスタム方法でデータを処理できます。

  • 送信された値のデータタイプ:添付ファイルがサーバーに送信される方法を決定するためのオプションを選択します。 添付ファイルをバイナリデータとして送信するには、File オプションを選択します。 添付ファイルを Base64 でエンコードされた文字列として送信するには、String オプションを選択します。 String を選択すると、バイナリ形式のファイルがデータ URL としてサーバーに送信されます。 サーバーはデータ URL を自動的にバイナリ形式に変換し戻し、ユーザーが変更を加えなくても、メールの送信やレコードのドキュメントの生成などの既存のアクションとの互換性を確保します。 デフォルトでは、「File」オプションが選択されています。

  • コンポーネントを非表示 - フォームでコンポーネントを非表示にするには、このオプションを選択します。 このコンポーネントは、他の目的(ルールエディターでの計算に使用するなど)にも利用できます。 これは、ユーザーが表示する必要のない情報や直接変更した情報を保存する必要がある場合に役立ちます。

  • コンポーネントの無効化 - コンポーネントを無効にする場合は、このオプションを選択します。 エンドユーザーは、無効になっているコンポーネントをアクティブにしたり、編集したりすることはできません。 ユーザーはフィールドの値を表示できますが、変更することはできません。 このコンポーネントは、他の目的(ルールエディターでの計算に使用するなど)にも利用できます。

  • 読み取り専用 - コンポーネントを編集不可にするには、このオプションを選択します。 ユーザーはフィールドの値を表示できますが、変更することはできません。 このコンポーネントは、他の目的(ルールエディターでの計算に使用するなど)にも利用できます。

  • 複数の添付ファイルを許可 - 添付ファイル ​ボタンから複数の添付ファイルをアップロードできます。

  • テキストをドラッグ&ドロップ - 「添付」ボタンの上部に表示され、ファイルを添付するかドラッグ&ドロップするかをユーザーに促すテキストです。「添付」ボタンの上部に表示されるテキストをカスタマイズするオプションがあります。さらに、リッチテキストメニューを使用してテキストを書式設定できます。

「検証」タブ validation-tab

「検証」タブ

  • 必須 - コンポーネントをアダプティブフォームに表示する場合は、このオプションを選択します。 オプションを選択した後、フォームの送信を続行する前に添付ファイルを添付する必要があります。このオプションが選択されていると、「基本」タブの「コンポーネントを非表示」または「コンポーネントの無効化」は選択できません。

  • エラーメッセージ - このオプションを使用すると、「必須」チェックボックスがオンになっており、フィールドが空白の場合に表示されるメッセージを入力できます。

  • スクリプト検証メッセージ - スクリプトの検証が失敗した場合に表示するメッセージを入力できます。

  • 最大ファイルサイズ (MB) - このオプションを使用すると、最大のファイルサイズを指定できます。ファイルサイズは MB 単位で指定します。

  • 最大ファイルサイズのエラーメッセージ - このオプションでは、最大ファイルサイズ (MB) オプションで指定したファイルサイズを超えるファイルをアップロードした場合に表示されるエラーメッセージを入力できます。

  • 許可されるファイルタイプ - 「添付ファイル」ボタンからアップロードできる様々なファイルのタイプがここに追加されます。また、「追加」ボタンをクリックすると、新しいファイル形式を追加することもできます。サポートされるファイル形式は、オーディオ、ビデオ、画像、テキストまたは PDF です。以下のオプションで、許可されたファイルタイプを削除または並べ替えることもできます。

    • 削除 - ファイルタイプを削除する場合に、タップまたはクリックします。
    • 並べ替え - ファイルタイプの順序を並べ替える場合は、タップまたはクリックしてドラッグします。
  • ファイルタイプのエラーメッセージ - 「許可されるファイルタイプ」オプションに含まれないファイル形式をアップロードした場合に表示されるエラーメッセージを指定できます。

「ヘルプコンテンツ」タブ help-content-tab

「ヘルプコンテンツ」タブ

  • 短い説明 - 短い説明は、特定のフォームフィールドの目的に関する追加の情報や説明を提供する簡単な説明文です。 これにより、ユーザーは、フィールドに入力するデータの種類を理解しやすくなります。また、入力された情報が有効で目的の条件を満たしていることを確認できるように、ガイドラインや例を提供できます。 デフォルトでは、短い説明は非表示になっています。 「短い説明を常に表示」オプションを有効にすると、コンポーネントの下に説明が表示されます。

  • 短い説明を常に表示 - このオプションを有効にすると、コンポーネントの下に短い説明が表示されます。

  • ヘルプテキスト - ヘルプテキストとは、フォームフィールドの正しい入力を支援するためにユーザーに提供される追加の情報やガイダンスを指します。コンポーネントの横に配置されているヘルプアイコン(i)をクリックすると表示されます。 ユーザーがフィールドの要件や制約を理解できるように設計されているヘルプテキストは、フォームフィールドのラベルやプレースホルダーテキストよりも詳細な情報を提供できます。 また、フォームへの入力をより簡単かつ正確にするための提案や例を提供することも可能です。

「アクセシビリティ」タブ accessibility-tab

「アクセシビリティ」タブ

  • スクリーンリーダー用テキスト - スクリーンリーダー用テキストとは、視覚に障害のあるユーザーが使用する、支援テクノロジー(スクリーンリーダーなど)によって読み上げられる追加のテキストを指します。 このテキストでは、フォームフィールドの目的に関するオーディオの説明が提供され、フィールドのタイトル、説明、名前および関連するメッセージ(カスタムテキスト)に関する情報を含めることができます。 スクリーンリーダー用のテキストを使用すると、視覚に障害のあるユーザーを含むすべてのユーザーがフォームに確実にアクセスして、フォームフィールドとその要件を完全に理解できるようになります。

    • カスタムテキスト:ARIA アクセシビリティラベルにカスタムテキストを使用する場合は、このオプションを選択します。 このオプションを選択すると、「カスタムテキスト」ダイアログボックスが表示されます。 関連情報は、「カスタムテキスト」ダイアログボックスで追加できます。
    • 説明:ARIA アクセシビリティラベルの説明を使用する場合は、このオプションを選択します。
    • タイトル:ARIA アクセシビリティラベルのタイトルを使用する場合は、このオプションを選択します。
    • 名前:ARIA アクセシビリティラベルの名前を使用する場合は、このオプションを選択します。
    • なし:ARIA アクセシビリティラベルに追加しない場合は、このオプションを選択します。

デザインダイアログ design-dialog

デザインダイアログでは、添付ファイルコンポーネントの CSS スタイルを定義および管理できます。

「スタイル」タブ styles-tab

アダプティブフォームのファイル添付コアコンポーネントは、AEM のスタイルシステムをサポートしています。

デザインダイアログ

  • デフォルトの CSS クラス:アダプティブフォームのファイル添付コアコンポーネントのデフォルト CSS クラスを指定できます。

  • 許可されたスタイル:スタイルを表す名前と CSS クラスを指定してスタイルを定義します。例えば、「bold text」という名前のスタイルを作成し、CSS クラス「font-weight: bold」を指定できます。 アダプティブフォームエディターでアダプティブフォームにこれらのスタイルを使用または適用できます。 スタイルを適用するには、アダプティブフォームエディターでスタイルを適用するコンポーネントを選択し、「プロパティ」ダイアログに移動して「スタイル」ドロップダウンリストから希望のスタイルを選択します。 スタイルを更新または変更する必要がある場合は、デザインダイアログに戻り、「スタイル」タブでスタイルを更新して変更を保存します。

カスタムプロパティ

カスタムプロパティダイアログ

カスタムプロパティを使用すると、フォームテンプレートを使用してカスタム属性(キーと値のペア)をアダプティブフォームのコアコンポーネントに関連付けることができます。 カスタムプロパティは、コンポーネントのヘッドレスレンディションのプロパティセクションに反映されます。 これにより、カスタム属性値に基づいて適応する動的なフォーム動作を作成できます。 例えば、開発者は、モバイル、デスクトップ、web プラットフォーム上にヘッドレスフォームコンポーネントの様々なレンディションをデザインできるので、幅広いデバイスでのユーザーエクスペリエンスが大幅に向上します。

  • グループ名:カスタムプロパティグループを識別する名前を指定できます。 複数のカスタムプロパティグループを追加、削除または並べ替えることができます。 カスタムプロパティグループを追加すると、次のオプションが表示されます。

    • キーと値のペア:各カスタムプロパティグループの「追加」ボタンをクリックすると、複数のカスタムプロパティ名とカスタムプロパティ値を追加できます。

    • 削除:タップまたはクリックすると、カスタムプロパティ名とカスタムプロパティ値を削除できます。

    • 並べ替え:タップまたはクリックしてドラッグすると、カスタムプロパティ名とカスタムプロパティ値の順序を並べ替えることができます。

関連トピック see-also

recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c