On this page
upload_file
File
File質問タイプは回答者が調査回答の一部としてドキュメントやその他のファイルをアップロードできるようにします。
file質問タイプは、回答者がデバイスから任意のファイル（ドキュメント、スプレッドシート、PDF、その他のファイルタイプ）をアップロードできます。特定のキャプチャツールを起動するimage、audio、videoとは異なり、fileは汎用のファイルピッカーを開きます。
基本XLSForm仕様
| type | name | label |
|---|---|---|
| file | document | ドキュメントをアップロードしてください |
標準のfile質問タイプの詳細については、XLSForm仕様を参照してください。
用途
File質問は一般的に以下に使用されます：
- 支持文書の収集（領収書、証明書、契約書、レポート）
- スキャンされた紙フォームのアップロード
- 他のシステムからのスプレッドシートやデータエクスポートの収集
- image/audio/videoがカバーしない任意のデジタルファイルタイプ
データ形式
アップロードされたファイルはバイナリ添付として保存されます：
- 形式： 元の形式を保持（PDF、XLSX、DOCXなど）
- 命名：
{instanceID}-{fieldname}.{extension} - ストレージ： 送信と一緒にサーバーのメディアフォルダーにアップロード
- アクセス： 送信管理インターフェースからダウンロード可能
rtSurveyの拡張機能
受け入れるファイルタイプ
選択できるファイルタイプを制限するにはparameters列を使用します：
| type | name | label | parameters |
|---|---|---|---|
| file | report | 検査レポートをアップロードしてください | accept=.pdf |
| file | spreadsheet | データファイルをアップロードしてください | accept=.xlsx,.csv |
acceptパラメーターは標準のファイル拡張子構文（カンマ区切り）を使用します。
ファイルサイズのガイダンス
rtSurveyは質問レベルでハードファイルサイズ制限を適用しませんが、サーバーのアップロード制限が適用されます。調査員への期待を伝えるためにhintを使用してください：
| type | name | label | hint |
|---|---|---|---|
| file | receipt | 支払い領収書をアップロードしてください | 受け入れ可能：PDFまたは画像。最大ファイルサイズ：5 MB |
デバイスのファイルシステムとクラウドストレージとの統合
AndroidとiOSでは、file質問はデバイスのネイティブファイルピッカーを開き、以下へのアクセスが含まれる場合があります：
- ローカルデバイスストレージ
- SDカード（Android）
- iCloud Drive（iOS）
- Google Drive、Dropbox（インストールされている場合）
Webでは、ブラウザの標準ファイルアップロードダイアログを開きます。
使用例
必須PDFアップロード
| type | name | label | hint | required | required_message |
|---|---|---|---|---|---|
| file | signed_consent | 署名済み同意書をアップロードしてください | PDFのみ、最大2MB | yes | 同意書が必要です |
条件付きドキュメントアップロード
| type | name | label | relevant |
|---|---|---|---|
| select_one yesno | has_land_title | 世帯に土地の所有権証書はありますか？ | |
| file | land_title_doc | 土地の所有権証書の写真またはスキャンをアップロードしてください | ${has_land_title} = 'yes' |
ベストプラクティス
- ファイルタイプを制限するために
acceptを使用してください — これにより調査員が誤ったファイルをアップロードするのを防げます。 hint列に常にサイズと形式のガイダンスを含めてください。- 写真や画像には、より良い圧縮と一貫した形式処理を提供する
imageタイプを使用してください。 - ファイル添付を含む大規模な調査では、データストレージとダウンロード帯域幅を計画してください。
- デプロイ前にターゲットデバイスタイプ（AndroidとiOSとWeb）でファイルピッカーをテストしてください — クラウドドライブへのアクセスは異なります。
データ処理の考慮事項
- ファイルは元の形式で保存されます；rtSurveyによって変換または圧縮されることはありません。
- ダウンロード後にファイルを分析してください — rtSurveyはファイルの内容を抽出またはインデックス化しません。
- 大きなファイル添付は完全なデータセットのダウンロードに必要な時間を大幅に増加させます。
制限事項
- File質問はファイルの内容を検証しません —
acceptによるファイル拡張子チェックのみがUIレベルで実行されます。 - 非常に大きなファイル（100 MB以上）は低接続環境ではアップロードがタイムアウトする場合があります。
- オフラインの調査員はファイルを添付できますが、接続が復元されるまでアップロードされません。
- 一部のデバイス設定は特定のストレージ場所へのアクセスを制限する場合があります（例：企業のMDMポリシー）。
このページは役に立ちましたか？