Fil
Filfrågor gör det möjligt för respondenter att ladda upp dokument och andra filer som en del av sina undersökningssvar.
Frågtypen file gör det möjligt för respondenter att ladda upp valfri fil från sin enhet — dokument, kalkylblad, PDF-filer eller andra filtyper. Till skillnad från image, audio och video som startar specifika fångstverktyg, öppnar file en generell filväljare.
Grundläggande XLSForm-specifikation
| type | name | label |
|---|---|---|
| file | document | Vänligen ladda upp ditt dokument |
För mer detaljer om standardfrågtypen file, se XLSForm-specifikationen.
Användningsområden
Filfrågor används vanligtvis för:
- Samla in stöddokument (kvitton, certifikat, kontrakt, rapporter)
- Ladda upp ifyllda pappersformulär som har skannats
- Samla in kalkylblad eller dataexporter från andra system
- Alla digitala filtyper som bild/ljud/video inte täcker
Dataformat
Uppladdade filer lagras som binära bilagor:
- Format: Bevaras i originalformat (PDF, XLSX, DOCX osv.)
- Namngivning:
{instanceID}-{fieldname}.{extension} - Lagring: Uppladdas till serverns mediamapp tillsammans med inlämningen
- Åtkomst: Nedladdningsbar från inlämningshanteringsgränssnittet
rtSurvey-tillägg
Accepterade filtyper
Använd kolumnen parameters för att begränsa vilka filtyper som kan väljas:
| type | name | label | parameters |
|---|---|---|---|
| file | report | Ladda upp inspektionsrapporten | accept=.pdf |
| file | spreadsheet | Ladda upp datafilen | accept=.xlsx,.csv |
Parametern accept använder standardsyntax för filtillägg (kommaseparerat).
Filstorleksvägledning
rtSurvey tillämpar ingen hård filstorleksgräns på frågenivå, men serverns uppladdningsgräns gäller. Använd hint för att kommunicera förväntningar till räknaren:
| type | name | label | hint |
|---|---|---|---|
| file | receipt | Ladda upp betalningskvittot | Accepterat: PDF eller bild. Maximal filstorlek: 5 MB |
Exempelanvändning
Obligatorisk PDF-uppladdning
| type | name | label | hint | required | required_message |
|---|---|---|---|---|---|
| file | signed_consent | Ladda upp det undertecknade samtyckesformuläret | Endast PDF, max 2 MB | yes | Ett samtyckesformulär krävs |
Villkorlig dokumentuppladdning
| type | name | label | relevant |
|---|---|---|---|
| select_one yesno | has_land_title | Har hushållet ett marktitel? | |
| file | land_title_doc | Ladda upp ett foto eller scan av marktiteln | ${has_land_title} = 'yes' |
Bästa praxis
- Använd
acceptför att begränsa filtyper — detta förhindrar räknare från att oavsiktligt ladda upp fel filer. - Inkludera alltid storleks- och formatvägledning i kolumnen
hint. - För foton och bilder, använd typen
imageistället — den erbjuder bättre komprimering och konsekvent formathantering. - För stora undersökningar med filbilagor, planera din datalagring och nedladdningsbandbredd i enlighet med detta.
- Testa filväljaren på målenhetstypen (Android vs. iOS vs. webb) innan driftsättning.
Begränsningar
- Filfrågor validerar inte filinnehåll — bara filnamnstilläggskontrollen via
accepttillämpas på UI-nivå. - Mycket stora filer (100 MB+) kan ta slut vid uppladdning i låganslutningsmiljöer.
- Offlineräknare kan bifoga filer men de laddas inte upp förrän anslutning återupprättas.