Integração da Recolha de Dados
O Bemba recebe os dados de terreno de duas plataformas de recolha: KoboToolbox e Survey Solutions. Um ficheiro Excel também pode servir de fonte.
Visão geral
| Ferramenta | Descrição | Usos no Bemba |
|---|---|---|
| KoboToolbox | Plataforma open source de recolha móvel | Recenseamento dos agregados, reclamações, código de conduta, reuniões |
| Survey Solutions | Solução do Banco Mundial | Inquéritos aos agregados, atualização dos beneficiários, reclamações |
| Excel / CSV | Ficheiro preparado a partir do modelo | Retoma de dados existentes |
Podem ser usados dois servidores KoboToolbox: o serviço online do Kobo e o servidor KoboToolbox auto-alojado do projeto. A escolha faz-se pelo URL da API, projeto a projeto. A instalação do servidor auto-alojado está descrita em KoboToolbox auto-alojado.
Onde estão os ecrãs
Não existe menu KoboToolbox nem menu Survey Solutions. Cada uso tem o seu ecrã:
| Necessidade | Ecrã |
|---|---|
| Importar agregados (Kobo, Survey Solutions ou Excel) | Recolha de Dados → Recolha de Dados, separador Agregados, botão Importar |
| Dar uma conta de recolha a um projeto | Administração → Projetos, botão Sincronização da recolha ⟳ na linha do projeto |
| Conta global KoboToolbox | Administração → Definições, separador Definições, secção Integrações API |
| Conta global e questionários Survey Solutions | Mesma secção, botão Abrir a configuração do Survey Solutions |
| Reclamações recolhidas com o Kobo | Reclamações (MGR) → Kobo - Reclamações |
| Reclamações recolhidas com o Survey Solutions | Reclamações (MGR) → Survey Solutions - Reclamações |
| Formulário público do código de conduta | Serviços Sociais → Código de conduta, botão Sincronizar Kobo |
Conta por projeto
Cada projeto recolhe com a sua própria ferramenta e a sua própria conta. A configuração faz-se projeto a projeto.
Menu: Administração → Projetos → botão Sincronização da recolha ⟳ na linha do projeto
| Ferramenta | Campos |
|---|---|
| KoboToolbox | URL da API, token API |
| Survey Solutions | URL do servidor, utilizador API, palavra-passe API, espaço de trabalho |
Cada bloco tem o botão Testar a ligação guardada. Interroga a ferramenta com a conta tal como está registada.
Recurso à conta global
Um projeto sem conta própria usa a conta global do SIG. Para o Kobo, é o token da secção Integrações das definições. Para o Survey Solutions, é a configuração aberta a partir dessa mesma secção. O ecrã de sincronização indica-o com a etiqueta conta global em uso.
Segredos
O token Kobo e a palavra-passe Survey Solutions nunca são reapresentados. O ecrã indica apenas que estão preenchidos. Deixar o campo vazio ao guardar conserva o valor existente.
Efeito na importação
No assistente de importação, o projeto escolhe-se logo no primeiro passo, com a instituição de recolha. Os questionários propostos são os da conta desse projeto.
Sincronização planeada
O servidor sincroniza periodicamente os questionários Survey Solutions de cada configuração ativa: a de cada projeto e a global. Um administrador pode também lançar uma sincronização limitada a um projeto:
php bin/console app:survey-solutions:sync --projet=CODIGO_PROJETO
php bin/console app:kobo:sync <identificador_formulario> --projet=CODIGO_PROJETO
O comando Kobo lê o formulário com a conta do projeto. Um projeto sem conta própria é recusado, em vez de ser sincronizado em silêncio com a conta global.
Fluxo de trabalho geral
- Recolha no terreno: os inquiridores preenchem os formulários em tablet ou telemóvel.
- Envio para o servidor: as submissões chegam ao KoboToolbox ou ao Survey Solutions.
- Controlo na plataforma: os supervisores aprovam ou rejeitam as submissões.
- Importação no Bemba: os agregados importados chegam à pré-recolha.
- Validação: são controlados, validados e depois integrados no registo social. Ver Pré-recolha.
Nenhum agregado importado entra diretamente no registo. É a validação na pré-recolha que lhe atribui o seu identificador.
Tipos de formulários
Formulários KoboToolbox
| Tipo | Uso |
|---|---|
| PMT - Recolha de agregados | Dados socioeconómicos para o cálculo do score PMT |
| Validação comunitária | Validação pelos comités locais |
| Acompanhamento dos beneficiários | Visitas de acompanhamento |
| Reclamação | Registo das reclamações no terreno |
Questionários Survey Solutions
| Tipo | Uso |
|---|---|
| Agregado familiar | Importação no registo social, via pré-recolha |
| Atualização | Atualização dos beneficiários existentes (principal, substituto, telefone, documentos) |
| Reclamação | Importação no mecanismo de gestão de reclamações |
Princípios da importação
Estado de validação
- Survey Solutions: a opção Importar apenas as entrevistas aprovadas da configuração limita a sincronização às entrevistas aprovadas.
- KoboToolbox: o assistente de importação lê todas as submissões do formulário, seja qual for o seu estado. A sincronização automática conserva o estado definido no Kobo: aprovado, rejeitado ou em espera.
Duplicados
Uma submissão já importada atualiza a recolha existente em vez de criar uma segunda. O resultado da importação distingue as recolhas submetidas e as recolhas atualizadas. As correspondências com os agregados do registo são controladas na validação.
Boas práticas
- Teste a ligação do projeto antes da primeira importação.
- Importe primeiro uma pequena amostra e verifique o mapeamento.
- Depois da importação, trate sem demora os agregados em pré-recolha.
- Assinale à equipa de terreno as submissões rejeitadas.
Pré-requisitos técnicos
KoboToolbox
- Uma conta KoboToolbox com acesso API, no serviço online ou no servidor do projeto
- Um token API
- Formulários implementados
Survey Solutions
- Um servidor Survey Solutions acessível
- Um espaço de trabalho
- Um utilizador API e a sua palavra-passe