file 질문 유형은 응답자가 기기에서 모든 파일을 업로드할 수 있게 합니다 — 문서, 스프레드시트, PDF 또는 기타 파일 유형. 특정 캡처 도구를 실행하는 image, audio, video와 달리, file은 범용 파일 선택기를 엽니다.

기본 XLSForm 사양

typenamelabel
filedocument문서를 업로드해 주세요

표준 file 질문 유형에 대한 자세한 내용은 XLSForm 사양을 참조하세요.

용도

File 질문은 일반적으로 다음 용도로 사용됩니다:

  1. 지원 문서 수집 (영수증, 인증서, 계약서, 보고서)
  2. 스캔된 완성된 종이 양식 업로드
  3. 다른 시스템에서의 스프레드시트 또는 데이터 내보내기 수집
  4. image/audio/video가 커버하지 않는 모든 디지털 파일 유형

데이터 형식

업로드된 파일은 이진 첨부 파일로 저장됩니다:

  • 형식: 원본 형식 유지 (PDF, XLSX, DOCX 등)
  • 명명: {instanceID}-{fieldname}.{extension}
  • 저장: 제출과 함께 서버 미디어 폴더에 업로드됨
  • 액세스: 제출 관리 인터페이스에서 다운로드 가능

rtSurvey 확장

허용 파일 유형

parameters 열을 사용하여 선택할 수 있는 파일 유형을 제한합니다:

typenamelabelparameters
filereport검사 보고서를 업로드하세요accept=.pdf
filespreadsheet데이터 파일을 업로드하세요accept=.xlsx,.csv

accept 매개변수는 표준 파일 확장자 구문을 사용합니다 (쉼표로 구분).

파일 크기 안내

rtSurvey는 질문 수준에서 엄격한 파일 크기 제한을 적용하지 않지만, 서버 업로드 제한이 적용됩니다. hint를 사용하여 조사원에게 기대치를 전달합니다:

typenamelabelhint
filereceipt결제 영수증을 업로드하세요허용: PDF 또는 이미지. 최대 파일 크기: 5 MB

기기 파일 시스템 및 클라우드 저장소와 통합

Android 및 iOS에서 file 질문은 기기의 기본 파일 선택기를 열며, 다음에 대한 액세스를 포함할 수 있습니다:

  • 로컬 기기 저장소
  • SD 카드 (Android)
  • iCloud Drive (iOS)
  • Google Drive, Dropbox (설치된 경우)

웹에서는 브라우저의 표준 파일 업로드 대화 상자를 엽니다.

예시 사용

필수 PDF 업로드

typenamelabelhintrequiredrequired_message
filesigned_consent서명된 동의서를 업로드하세요PDF만 가능, 최대 2MByes동의서가 필요합니다

조건부 문서 업로드

typenamelabelrelevant
select_one yesnohas_land_title가구에 토지 소유권이 있습니까?
fileland_title_doc토지 소유권의 사진 또는 스캔을 업로드하세요${has_land_title} = 'yes'

모범 사례

  1. accept를 사용하여 파일 유형을 제한합니다 — 조사원이 실수로 잘못된 파일을 업로드하는 것을 방지합니다.
  2. 항상 hint 열에 크기와 형식 안내를 포함합니다.
  3. 사진 및 이미지의 경우 image 유형을 대신 사용합니다 — 더 나은 압축 및 일관된 형식 처리를 제공합니다.
  4. 파일 첨부가 있는 대규모 설문의 경우 데이터 저장 및 다운로드 대역폭을 계획합니다.
  5. 배포 전에 대상 기기 유형 (Android vs. iOS vs. 웹)에서 파일 선택기를 테스트합니다 — 클라우드 드라이브 액세스는 다를 수 있습니다.

데이터 처리 고려 사항

  • 파일은 원본 형식으로 저장되며 rtSurvey에 의해 변환 또는 압축되지 않습니다.
  • 다운로드 후 파일을 분석합니다 — rtSurvey는 파일 내용을 추출하거나 색인화하지 않습니다.
  • 대용량 파일 첨부는 전체 데이터셋 다운로드에 필요한 시간을 크게 늘립니다.

제한 사항

  • File 질문은 파일 내용을 유효성 검사하지 않습니다 — UI 수준에서는 accept를 통한 파일 확장자 확인만 적용됩니다.
  • 매우 큰 파일 (100 MB 이상)은 연결이 불안정한 환경에서 업로드 시 타임아웃이 발생할 수 있습니다.
  • 오프라인 조사원은 파일을 첨부할 수 있지만 연결이 복원될 때까지 업로드되지 않습니다.
  • 일부 기기 구성은 특정 저장 위치에 대한 액세스를 제한합니다 (예: 기업 MDM 정책).
이 페이지가 도움이 되었나요?