Upload
Upload は1 つ以上のファイルをアップロードし、返されたメタデータを Form にバインドします。このフィールドは Form の状態、検証、送信範囲に含まれます。
1. 利用場面
主な用途：
- 添付・証明資料
- 画像・文書アップロード
- 形式、件数、サイズ制限付き入力
2. 追加と設定
- Form Section の Fields に Upload を追加します。
- バックエンド DTO のプロパティと一致する、安定した一意の Field Key / Name を設定します。
- 以下の固有プロパティを設定し、必要に応じて Required、Help Text、Full row、条件式を追加します。
- Design Preview で初期値とレイアウトを確認し、Form の Validate / Submit でデータ経路全体をテストします。
3. 主なプロパティ
| プロパティ | 役割 |
|---|---|
| Multiple | この動作を有効または無効にします。 |
| Form Upload / Upload URL | 選択データの取得元とマッピング方法を定義します。 |
| Component Style | Design Preview と Runtime での表示方法を制御します。 |
| Upload Format Filter | 許可する件数、長さ、または値の範囲を制限します。 |
| Upload Count / Size Limit | 許可する件数、長さ、または値の範囲を制限します。 |
| Enable Image Cropping | この動作を有効または無効にします。 |
Field Key、Required、Help Text、Full row、Visible When などの共通設定は Form フィールド契約から提供されます。表には Upload で特に重要な設定を示します。
4. フォーム値とバックエンド契約
送信される値： アップロード応答とマッピングで定義されるファイルメタデータ配列で、ブラウザーのバイナリオブジェクトではありません。
[
{"id": "file-1024", "name": "evidence.pdf", "url": "/files/file-1024"}
]
例はデータ形状のみを示します。API 側では業務 DTO に基づく型、範囲、権限の検証が必要です。
5. 検証・条件・インタラクション
すべてのフィールドで Required、Visible When、Disabled When、Required When、Dependencies、Clear When Hidden を利用できます。条件式は操作性を高めますが、バックエンドの検証や権限管理の代わりにはなりません。
コンポーネント機能： setValue をサポートし、成功スクリプトとアップロード状態でサーバー応答を処理します。
6. 設定上の注意
推奨事項： 先に要求・応答 JSON 契約を固定し、配列要素、ファイルメタデータ、サーバーエラーパスを一貫してテストしてください。
レイアウト、検証、送信、下書き、バックエンドプロトコルは Form の概要 を参照してください。