KoboToolbox
A página KoboToolbox permite gerir a sincronização dos formulários de recolha e a importação dos dados no Bemba.
Acesso
Menu: Recolha → KoboToolbox
Visão geral
Estatísticas globais
No topo da página, cartões apresentam os indicadores-chave:
| Indicador | Ícone | Descrição |
|---|---|---|
| Formulários ativos | Documento | Número de formulários configurados |
| Submissões totais | Base de dados | Total de submissões disponíveis |
| Última sinc | Relógio | Data da última sincronização |
| Webhooks ativos | Relâmpago | Número de webhooks configurados |
Lista dos formulários
Colunas apresentadas
| Coluna | Descrição |
|---|---|
| Nome | Nome do formulário KoboToolbox |
| Tipo | Tipo de formulário (PMT, Validação, Acompanhamento, Queixa) |
| Submissões | Número de submissões disponíveis |
| Última sinc | Data da última sincronização |
| Estado | Ativo/Inativo |
| Ações | Configurar, Sincronizar, Ver |
Tipos de formulários
| Tipo | Badge | Descrição |
|---|---|---|
| PMT | Azul | Recolha de agregados para cálculo PMT |
| Validação | Verde | Validação comunitária |
| Acompanhamento | Roxo | Acompanhamento dos beneficiários |
| Queixa | Laranja | Registo de queixas |
Configurar um formulário
Acesso
Clique no ícone Configurar (engrenagem) num formulário.
Parâmetros de configuração
| Campo | Descrição |
|---|---|
| Tipo de formulário | Selecionar: PMT, Validação, Acompanhamento, Queixa |
| Ativo | Ativar/desativar a sincronização |
| Webhook | URL do webhook (opcional) |
Tipos de formulários detalhados
PMT - Recolha de agregados
Formulário para a recolha de dados socioeconómicos:
- Informações do agregado
- Composição familiar
- Características da habitação
- Ativos e rendimentos
Validação comunitária
Formulário de validação pelos comités locais:
- Confirmação das informações
- Observações comunitárias
- Recomendações
Acompanhamento dos beneficiários
Formulário de visita de acompanhamento:
- Estado do beneficiário
- Utilização das transferências
- Dificuldades encontradas
Registo de queixas
Formulário de recolha de queixas no terreno:
- Descrição da queixa
- Informações do queixoso
- Anexos (fotos)
Sincronizar os dados
Sincronização simples
- Clique em Sincronizar num formulário
- Escolha o modo de sincronização:
| Modo | Descrição |
|---|---|
| Normal | Importa apenas as novas submissões |
| Forçar a ressincronização | Reimporta todas as submissões |
- Confirme a sincronização
Pré-visualização
Antes da importação, o sistema apresenta as estatísticas:
| Estatística | Descrição |
|---|---|
| Total submissões | Número total de submissões |
| Novas a importar | Submissões ainda não importadas |
| Já tratadas | Submissões já no Bemba |
| Agregados envolvidos | Número de agregados a criar/atualizar |
| Taxa média de preenchimento | % médio de preenchimento dos formulários |
Sincronização avançada
Acesso
Clique em Sinc avançada para abrir as opções de filtragem.
Filtros disponíveis
| Filtro | Tipo | Descrição |
|---|---|---|
| Inquiridor | Seleção | Filtrar por inquiridor |
| Região | Seleção | Filtrar por região |
| Setor | Seleção | Cascata desde a região |
| Localidade | Seleção | Cascata desde o setor |
Filtros em cascata
Selecione primeiro a região para ver os setores disponíveis, depois o setor para ver as localidades.
Opções de agrupamento
| Opção | Descrição |
|---|---|
| Ambos | Agrupa por inquiridor E zona geográfica |
| Por inquiridor | Cria um lote por inquiridor |
| Por zona | Cria um lote por zona geográfica |
Processo
- Selecione os filtros desejados
- Escolha o modo de agrupamento
- Clique em Pré-visualizar
- Verifique as estatísticas
- Clique em Lançar a sincronização
Gestão dos webhooks
O que é um webhook?
Um webhook permite receber automaticamente as novas submissões assim que são validadas no KoboToolbox.
Configurar um webhook
- Aceda à configuração do formulário
- Ative a opção Webhook
- Copie a URL gerada
- Cole a URL nos parâmetros KoboToolbox
Vantagens
- Importação automática em tempo real
- Sem necessidade de sincronização manual
- Notificação imediata de novos dados
Regras de importação
Apenas submissões aprovadas
Por defeito, apenas as submissões com o estado Aprovado são importadas. Isto garante:
- Dados validados por um supervisor
- Controlo de qualidade a montante
- Evitar erros de introdução
Deteção de duplicados
O sistema deteta automaticamente:
| Critério | Ação |
|---|---|
| Mesmo ID de submissão | Ignorada (já importada) |
| Mesmo agregado (código) | Atualização dos dados |
| Duplicado potencial | Sinalizado para verificação |
Histórico das sincronizações
Acesso
O histórico é visível na coluna Última sinc e através do botão Histórico.
Informações apresentadas
| Informação | Descrição |
|---|---|
| Data/Hora | Momento da sincronização |
| Utilizador | Quem lançou a sinc |
| Modo | Normal, Forçado, Avançado |
| Resultado | Sucesso, Parcial, Falha |
| Estatísticas | Importados, Ignorados, Erros |
Casos de utilização
Importação quotidiana das recolhas
- Aceda a KoboToolbox
- Verifique as novas submissões
- Lance uma sincronização normal
- Verifique os agregados importados
Reimportar após correção
Se erros foram corrigidos no KoboToolbox:
- Aceda ao formulário em causa
- Clique em Sincronizar
- Selecione Forçar a ressincronização
- Confirme a ação
Importação direcionada por zona
Para importar apenas os dados de uma localidade:
- Clique em Sinc avançada
- Selecione a região → setor → localidade
- Pré-visualize os dados
- Lance a importação
Importação por inquiridor
Para verificar os dados de um inquiridor específico:
- Clique em Sinc avançada
- Selecione o inquiridor
- Escolha Por inquiridor como agrupamento
- Pré-visualize e importe
Resolução de problemas
Nenhuma submissão encontrada
| Causa | Solução |
|---|---|
| Formulário não implementado | Implemente o formulário no KoboToolbox |
| Token API inválido | Verifique o token nos parâmetros |
| Nenhuma submissão aprovada | Aprove as submissões no KoboToolbox |
Erros durante a importação
| Erro | Causa | Solução |
|---|---|---|
| Dados em falta | Campos obrigatórios não preenchidos | Verificar o formulário KoboToolbox |
| Zona não encontrada | Código de localidade inexistente | Atualizar o referencial geo |
| Inquiridor desconhecido | Email não reconhecido | Criar o inquiridor no Bemba |
Dados não atualizados
- Verifique que o modo Forçar é utilizado
- Verifique as correspondências de códigos
- Consulte os logs de importação
Boas práticas
Configuração
- Configure o tipo correto para cada formulário
- Ative os webhooks para importação automática
- Teste com uma pequena amostra primeiro
Sincronização
- Efetue sincronizações regulares (diárias)
- Utilize os filtros para importações direcionadas
- Verifique sempre a pré-visualização
Qualidade dos dados
- Assegure-se de que os supervisores aprovam as submissões
- Verifique os duplicados sinalizados
- Corrija os erros no KoboToolbox antes de reimportar