Datei (File)
Datei-Fragen ermöglichen es Befragten, Dokumente und andere Dateien als Teil ihrer Umfrageantworten hochzuladen.
Der Fragetyp file ermöglicht es Befragten, beliebige Dateien von ihrem Gerät hochzuladen — Dokumente, Tabellen, PDFs oder andere Dateitypen. Im Gegensatz zu image, audio und video, die spezifische Aufnahmetools starten, öffnet file einen allgemeinen Dateiauswahldialog.
Grundlegende XLSForm-Spezifikation
| type | name | label |
|---|---|---|
| file | document | Bitte laden Sie Ihr Dokument hoch |
Weitere Details zum Standard-Datei-Fragetyp finden Sie in der XLSForm-Spezifikation.
Anwendungsbereiche
Datei-Fragen werden häufig verwendet für:
- Erfassung von Belegen (Quittungen, Zertifikate, Verträge, Berichte)
- Hochladen ausgefüllter Papierformulare, die gescannt wurden
- Sammlung von Tabellen oder Datenexporten aus anderen Systemen
- Jeden digitalen Dateityp, der nicht durch image/audio/video abgedeckt wird
Datenformat
Hochgeladene Dateien werden als Binärdaten gespeichert:
- Format: Im Originalformat beibehalten (PDF, XLSX, DOCX usw.)
- Benennung:
{instanceID}-{fieldname}.{extension} - Speicherung: In den Server-Medienordner hochgeladen, zusammen mit der Übermittlung
- Zugriff: Über die Übermittlungsverwaltungsoberfläche herunterladbar
rtSurvey-Erweiterungen
Akzeptierte Dateitypen
Verwenden Sie die Spalte parameters, um die auswählbaren Dateitypen einzuschränken:
| type | name | label | parameters |
|---|---|---|---|
| file | report | Prüfbericht hochladen | accept=.pdf |
| file | spreadsheet | Datendatei hochladen | accept=.xlsx,.csv |
Der Parameter accept verwendet die Standard-Dateiendungssyntax (kommagetrennt).
Dateigrößenhinweise
rtSurvey erzwingt keine harte Dateigrößenbeschränkung auf Frageebene, aber das Server-Upload-Limit gilt. Verwenden Sie hint, um dem Interviewer die Erwartungen mitzuteilen:
| type | name | label | hint |
|---|---|---|---|
| file | receipt | Zahlungsbeleg hochladen | Akzeptiert: PDF oder Bild. Maximale Dateigröße: 5 MB |
Integration mit dem Gerätedateisystem und Cloud-Speicher
Auf Android und iOS öffnet die file-Frage den nativen Dateiauswahldialog des Geräts, der möglicherweise Zugang bietet zu:
- Lokalem Gerätespeicher
- SD-Karte (Android)
- iCloud Drive (iOS)
- Google Drive, Dropbox (falls installiert)
Im Web öffnet sich der Standard-Datei-Upload-Dialog des Browsers.
Beispielhafte Verwendung
Pflicht-PDF-Upload
| type | name | label | hint | required | required_message |
|---|---|---|---|---|---|
| file | signed_consent | Unterzeichnetes Einwilligungsformular hochladen | Nur PDF, max. 2 MB | yes | Ein Einwilligungsformular ist erforderlich |
Bedingter Dokument-Upload
| type | name | label | relevant |
|---|---|---|---|
| select_one yesno | has_land_title | Hat der Haushalt einen Grundbucheintrag? | |
| file | land_title_doc | Foto oder Scan des Grundbucheintrags hochladen | ${has_land_title} = 'yes' |
Empfohlene Vorgehensweisen
- Verwenden Sie
accept, um Dateitypen einzuschränken — dies verhindert, dass Interviewer versehentlich falsche Dateien hochladen. - Geben Sie immer Größen- und Formathinweise in der Spalte
hintan. - Verwenden Sie für Fotos und Bilder den Typ
imagestattdessen — er bietet bessere Komprimierung und konsistente Formatverarbeitung. - Planen Sie bei umfangreichen Umfragen mit Dateianhängen entsprechend Datenspeicher und Download-Bandbreite ein.
- Testen Sie den Dateiauswahldialog auf dem Zielgerätetyp (Android vs. iOS vs. Web) vor dem Einsatz — der Zugriff auf Cloud-Laufwerke variiert.
Überlegungen zur Datenverarbeitung
- Dateien werden in ihrem Originalformat gespeichert; sie werden von rtSurvey nicht konvertiert oder komprimiert.
- Analysieren Sie Dateien nach dem Download — rtSurvey extrahiert oder indiziert keine Dateiinhalte.
- Große Dateianhänge verlängern die Zeit, die zum Herunterladen eines vollständigen Datensatzes benötigt wird, erheblich.
Einschränkungen
- Datei-Fragen validieren keine Dateiinhalte — nur die Dateiendungsprüfung über
acceptwird auf UI-Ebene erzwungen. - Sehr große Dateien (100 MB+) können beim Upload in Umgebungen mit schlechter Konnektivität eine Zeitüberschreitung verursachen.
- Offline-Interviewer können Dateien anhängen, aber sie werden erst hochgeladen, wenn die Konnektivität wiederhergestellt ist.
- Einige Gerätekonfigurationen schränken den Zugriff auf bestimmte Speicherorte ein (z. B. unternehmenseigene MDM-Richtlinien).