Os tipos de perguntas meta são campos especiais que são preenchidos automaticamente — o respondente nunca os vê. Eles capturam contexto sobre o envio: quando foi coletado, qual dispositivo foi usado e quem o coletou. Adicione-os na planilha survey como qualquer outro tipo de pergunta; eles simplesmente não aparecem na tela.

Especificação básica do XLSForm

typenamelabel
startstart
endend
deviceiddeviceid

Os rótulos são opcionais para campos meta, pois eles nunca são exibidos.

Campos meta de tempo

start

Registra a data e hora em que o formulário foi aberto. Armazenado no formato ISO 8601 (YYYY-MM-DDTHH:MM:SS.sss+HH:MM).

  type    | name  | label
start   | start |

end

Registra a data e hora em que o formulário foi enviado. Junto com start, você pode calcular o tempo gasto preenchendo o formulário:

  type      | name          | calculation
calculate | duration_min  | (decimal-date-time(${end}) - decimal-date-time(${start})) * 1440

today

Registra a data atual (sem componente de hora). Armazenado como YYYY-MM-DD. Útil quando você precisa apenas da data sem o carimbo de tempo completo.

  type  | name  | label
today | today |

Campos meta de dispositivo

deviceid

Registra o identificador único do dispositivo usado para coleta de dados. No Android, normalmente é o IMEI ou Android ID. Útil para rastrear qual dispositivo enviou cada formulário e detectar envios duplicados do mesmo dispositivo.

  type      | name     | label
deviceid  | deviceid |

devicephonenum

Registra o número de telefone do cartão SIM no dispositivo (se disponível). Pode estar vazio se o dispositivo não tiver SIM ou se o número não estiver armazenado no SIM.

  type           | name          | label
devicephonenum | devicephonenum |

simserial

Registra o número de série do cartão SIM (ICCID). Útil para identificar qual SIM/operadora foi usada.

  type      | name      | label
simserial | simserial |

subscriberid

Registra o IMSI (Identidade Internacional de Assinante Móvel) — o identificador único de assinante no cartão SIM.

  type         | name        | label
subscriberid | subscriberid |

Campos meta de entrevistador

username

Registra o nome de usuário do entrevistador conectado (a conta usada no aplicativo rtSurvey). Esta é a maneira mais confiável de rastrear quem coletou cada envio.

  type     | name     | label
username | username |

email

Registra o endereço de e-mail do entrevistador conectado.

  type  | name  | label
email | email |

phonenumber

Registra o número de telefone associado à conta do entrevistador (se configurado).

  type        | name       | label
phonenumber | phonenumber |

Log de auditoria

audit

O campo meta audit habilita o registro de auditoria detalhado — ele registra um log com carimbo de tempo de cada pergunta que o entrevistador visitou, quanto tempo passou em cada uma, e (opcionalmente) sua localização GPS em cada etapa. O log de auditoria é salvo como um arquivo audit.csv separado junto com cada envio.

  type  | name  | parameters
audit | audit | location-priority=balanced location-min-interval=30 location-max-age=60

Parâmetros de auditoria

ParâmetroDescrição
location-priorityNível de precisão do GPS: no-gps, low-power, balanced, high-accuracy
location-min-intervalSegundos mínimos entre capturas de localização
location-max-ageIdade máxima (segundos) de uma localização em cache para aceitar

O log de auditoria captura:

  • Nome da pergunta e tipo de evento (question, form.start, form.exit, form.save, form.finalize)
  • Carimbos de tempo de início e fim para cada evento
  • Coordenadas GPS (se location-priority estiver definido)

Exemplo completo

Uma pesquisa domiciliar típica pode incluir todos os campos meta de tempo e entrevistador:

typenamelabel
startstart
endend
todaytoday
deviceiddeviceid
usernameusername
emailemail
auditaudit
texthousehold_idID do domicílio
………

Práticas recomendadas

  1. Sempre inclua start e end — eles são gratuitos, automáticos e inestimáveis para monitoramento de qualidade.
  2. Sempre inclua username para rastrear entrevistadores.
  3. Inclua deviceid quando quiser detectar envios duplicados ou rastrear dispositivos de campo.
  4. Use audit em pesquisas de alta responsabilidade onde você precisa verificar que os entrevistadores realmente visitaram cada pergunta.
  5. Os campos relacionados ao SIM (simserial, subscriberid, devicephonenum) só são confiáveis em dispositivos Android com cartões SIM ativos — pule-os para implantações apenas com tablets.

Limitações

  • Todos os campos meta são somente leitura — eles não podem ser referenciados ou modificados por outros cálculos.
  • username e email requerem que o entrevistador esteja conectado; eles estarão vazios para envios anônimos.
  • Os campos meta de SIM/telefone podem retornar valores vazios em tablets apenas Wi-Fi e algumas versões do Android devido a restrições de permissão.
Esta página foi útil?