File
Le domande file permettono ai rispondenti di caricare documenti e altri file come parte delle loro risposte al sondaggio.
Il tipo di domanda file consente ai rispondenti di caricare qualsiasi file dal loro dispositivo — documenti, fogli di calcolo, PDF o altri tipi di file. A differenza di image, audio e video che avviano strumenti di acquisizione specifici, file apre un selettore di file generico.
Specifica XLSForm di base
| type | name | label |
|---|---|---|
| file | document | Si prega di caricare il documento |
Per ulteriori dettagli sul tipo di domanda file standard, vedere la specifica XLSForm.
Utilizzi
Le domande file sono comunemente usate per:
- Raccogliere documenti di supporto (ricevute, certificati, contratti, rapporti)
- Caricare moduli cartacei completati che sono stati scansionati
- Raccogliere fogli di calcolo o esportazioni di dati da altri sistemi
- Qualsiasi tipo di file digitale che image/audio/video non copre
Formato dei dati
I file caricati vengono memorizzati come allegati binari:
- Formato: Preservato nel formato originale (PDF, XLSX, DOCX, ecc.)
- Denominazione:
{instanceID}-{fieldname}.{extension} - Archiviazione: Caricati nella cartella media del server insieme all’invio
- Accesso: Scaricabile dall’interfaccia di gestione degli invii
Estensioni rtSurvey
Tipi di file accettati
Usa la colonna parameters per limitare i tipi di file che possono essere selezionati:
| type | name | label | parameters |
|---|---|---|---|
| file | report | Carica il rapporto di ispezione | accept=.pdf |
| file | spreadsheet | Carica il file di dati | accept=.xlsx,.csv |
Il parametro accept usa la sintassi standard delle estensioni di file (separata da virgole).
Indicazioni sulle dimensioni del file
rtSurvey non impone un limite rigido sulle dimensioni del file a livello di domanda, ma si applica il limite di caricamento del server. Usa hint per comunicare le aspettative all’enumeratore:
| type | name | label | hint |
|---|---|---|---|
| file | receipt | Carica la ricevuta di pagamento | Accettati: PDF o immagine. Dimensione massima del file: 5 MB |
Integrazione con il file system del dispositivo e l’archiviazione cloud
Su Android e iOS, la domanda file apre il selettore di file nativo del dispositivo, che può includere l’accesso a:
- Archiviazione locale del dispositivo
- Scheda SD (Android)
- iCloud Drive (iOS)
- Google Drive, Dropbox (se installati)
Sul web, apre la finestra di dialogo standard di caricamento file del browser.
Esempio di utilizzo
Caricamento PDF obbligatorio
| type | name | label | hint | required | required_message |
|---|---|---|---|---|---|
| file | signed_consent | Carica il modulo di consenso firmato | Solo PDF, max 2MB | yes | È necessario un modulo di consenso |
Caricamento condizionale di documenti
| type | name | label | relevant |
|---|---|---|---|
| select_one yesno | has_land_title | La famiglia ha un titolo fondiario? | |
| file | land_title_doc | Carica una foto o scansione del titolo fondiario | ${has_land_title} = 'yes' |
Best practice
- Usa
acceptper limitare i tipi di file — questo impedisce agli enumeratori di caricare accidentalmente file errati. - Includi sempre indicazioni su dimensioni e formato nella colonna
hint. - Per foto e immagini, usa il tipo
imageinvece — offre una migliore compressione e una gestione del formato più coerente. - Per sondaggi di grandi dimensioni con allegati di file, pianifica di conseguenza lo spazio di archiviazione e la larghezza di banda per il download.
- Testa il selettore di file sul tipo di dispositivo di destinazione (Android vs. iOS vs. web) prima del deployment — l’accesso alle unità cloud varia.
Considerazioni sulla gestione dei dati
- I file vengono memorizzati nel loro formato originale; non vengono convertiti o compressi da rtSurvey.
- Analizza i file dopo il download — rtSurvey non estrae né indicizza i contenuti dei file.
- Gli allegati di file di grandi dimensioni aumentano significativamente il tempo necessario per scaricare un dataset completo.
Limitazioni
- Le domande file non validano i contenuti dei file — solo la verifica dell’estensione del file tramite
acceptviene applicata a livello di interfaccia utente. - File molto grandi (100 MB+) possono andare in timeout durante il caricamento in ambienti a bassa connettività.
- Gli enumeratori offline possono allegare file ma non verranno caricati fino al ripristino della connettività.
- Alcune configurazioni del dispositivo limitano l’accesso a determinate posizioni di archiviazione (es. politiche MDM aziendali).