Arquivo
As perguntas de arquivo permitem que os respondentes façam upload de documentos e outros arquivos como parte de suas respostas de pesquisa.
O tipo de pergunta file permite que os respondentes façam upload de qualquer arquivo do seu dispositivo — documentos, planilhas, PDFs ou outros tipos de arquivo. Ao contrário de image, audio e video que iniciam ferramentas de captura específicas, file abre um seletor de arquivo de uso geral.
Especificação básica do XLSForm
| type | name | label |
|---|---|---|
| file | document | Por favor, faça upload do seu documento |
Para mais detalhes sobre o tipo padrão de pergunta de arquivo, consulte a especificação do XLSForm.
Usos
As perguntas de arquivo são comumente usadas para:
- Coletar documentos de suporte (recibos, certificados, contratos, relatórios)
- Fazer upload de formulários em papel preenchidos que foram digitalizados
- Reunir planilhas ou exportações de dados de outros sistemas
- Qualquer tipo de arquivo digital que image/audio/video não abrange
Formato de dados
Os arquivos enviados são armazenados como anexos binários:
- Formato: Preservado no formato original (PDF, XLSX, DOCX, etc.)
- Nomenclatura:
{instanceID}-{fieldname}.{extension} - Armazenamento: Enviados para a pasta de mídia do servidor junto com o envio
- Acesso: Baixáveis a partir da interface de gerenciamento de envios
Extensões do rtSurvey
Tipos de arquivo aceitos
Use a coluna parameters para restringir quais tipos de arquivo podem ser selecionados:
| type | name | label | parameters |
|---|---|---|---|
| file | report | Faça upload do relatório de inspeção | accept=.pdf |
| file | spreadsheet | Faça upload do arquivo de dados | accept=.xlsx,.csv |
O parâmetro accept usa sintaxe de extensão de arquivo padrão (separada por vírgulas).
Orientação sobre tamanho de arquivo
O rtSurvey não impõe um limite rígido de tamanho de arquivo no nível da pergunta, mas o limite de upload do servidor se aplica. Use hint para comunicar as expectativas ao entrevistador:
| type | name | label | hint |
|---|---|---|---|
| file | receipt | Faça upload do comprovante de pagamento | Aceitos: PDF ou imagem. Tamanho máximo do arquivo: 5 MB |
Integração com o sistema de arquivos do dispositivo e armazenamento em nuvem
No Android e iOS, a pergunta file abre o seletor de arquivo nativo do dispositivo, que pode incluir acesso a:
- Armazenamento local do dispositivo
- Cartão SD (Android)
- iCloud Drive (iOS)
- Google Drive, Dropbox (se instalados)
Na web, abre o diálogo padrão de upload de arquivo do navegador.
Exemplo de uso
Upload de PDF obrigatório
| type | name | label | hint | required | required_message |
|---|---|---|---|---|---|
| file | signed_consent | Faça upload do formulário de consentimento assinado | Somente PDF, máx. 2MB | yes | Um formulário de consentimento é obrigatório |
Upload condicional de documento
| type | name | label | relevant |
|---|---|---|---|
| select_one yesno | has_land_title | O domicílio tem um título de terra? | |
| file | land_title_doc | Faça upload de uma foto ou digitalização do título de terra | ${has_land_title} = 'yes' |
Práticas recomendadas
- Use
acceptpara restringir os tipos de arquivo — isso evita que os entrevistadores façam upload acidentalmente de arquivos errados. - Sempre inclua orientação sobre tamanho e formato na coluna
hint. - Para fotos e imagens, use o tipo
image— ele oferece melhor compressão e manipulação de formato consistente. - Para pesquisas grandes com anexos de arquivo, planeje seu armazenamento de dados e largura de banda de download adequadamente.
- Teste o seletor de arquivo no tipo de dispositivo de destino (Android vs. iOS vs. web) antes da implantação — o acesso a drives em nuvem varia.
Considerações sobre manipulação de dados
- Os arquivos são armazenados em seu formato original; eles não são convertidos ou comprimidos pelo rtSurvey.
- Analise os arquivos após o download — o rtSurvey não extrai ou indexa o conteúdo dos arquivos.
- Anexos de arquivo grandes aumentam significativamente o tempo necessário para baixar um conjunto de dados completo.
Limitações
- As perguntas de arquivo não validam o conteúdo do arquivo — apenas a verificação de extensão de arquivo via
accepté aplicada no nível da interface do usuário. - Arquivos muito grandes (100 MB+) podem expirar no upload em ambientes de baixa conectividade.
- Os entrevistadores offline podem anexar arquivos, mas eles não serão enviados até que a conectividade seja restaurada.
- Algumas configurações de dispositivos restringem o acesso a determinados locais de armazenamento (por exemplo, políticas MDM corporativas).