Survey Solutions
O Survey Solutions, a ferramenta de inquérito do Banco Mundial, alimenta o Bemba de três formas: importação de agregados, atualização dos beneficiários e importação de reclamações.
Acesso
Não existe menu Survey Solutions. Os ecrãs abrem-se assim:
| Ecrã | Caminho |
|---|---|
| Configuração Survey Solutions | Administração → Definições → separador Definições → secção Integrações API → Abrir a configuração do Survey Solutions |
| Página Survey Solutions (visão geral) | Botão Voltar do ecrã de configuração |
| Importação de agregados | Recolha de Dados → Recolha de Dados → separador Agregados → Importar, fonte Survey Solutions |
| Atualização de agregados | Página Survey Solutions → Atualização de agregados |
| Importação de reclamações | Reclamações (MGR) → Survey Solutions - Reclamações |
| Conta de um projeto | Administração → Projetos → botão Sincronização da recolha ⟳ |
Página Survey Solutions
A página mostra o estado da ligação, os contadores de questionários e três ações:
| Ação | Efeito |
|---|---|
| Importação de agregados | Abre o assistente de importação da recolha |
| Atualização de agregados | Atualiza os beneficiários existentes (principal, substituto) |
| Importação de reclamações | Importa e categoriza as reclamações recolhidas |
Lista também os questionários configurados, com o seu tipo, o número de submissões e a última sincronização.
Configuração
Cada projeto pode recolher com o seu próprio servidor e a sua própria conta. A configuração descrita aqui é a conta global do SIG, usada pelos projetos que não têm a sua. Para dar uma conta a um projeto, ver Conta por projeto.
Parâmetros de ligação
| Campo | Descrição |
|---|---|
| URL do servidor | Endereço do servidor, por exemplo https://a-sua-instancia.mysurvey.solutions |
| Workspace | Espaço de trabalho; deixe vazio para o espaço predefinido |
| Utilizador API | Conta API criada no Survey Solutions |
| Palavra-passe API | Palavra-passe dessa conta |
Parâmetros de sincronização
| Parâmetro | Opções | Descrição |
|---|---|---|
| Intervalo de sincronização | 1, 3, 6, 12 ou 24 horas | Frequência da sincronização planeada |
| Importar apenas as entrevistas aprovadas | Sim / Não | Limita a sincronização às entrevistas aprovadas pela sede |
Testar e guardar
- Preencha os parâmetros de ligação.
- Clique em Testar Ligação.
- Se o teste for bem-sucedido, clique em Guardar.
Gestão dos questionários
Adicionar um questionário
- Na configuração, clique em Adicionar Questionário.
- Selecione o questionário publicado no servidor.
- Escolha o Tipo de dados:
| Tipo | Destino |
|---|---|
| Agregado familiar | Registo social, via pré-recolha |
| Atualização | Atualização dos beneficiários existentes |
| Reclamação | Mecanismo de gestão de reclamações |
- Para um questionário Agregado familiar, indique se necessário uma Região predefinida. Só é usada se o dado faltar na entrevista.
- Clique em Adicionar.
Os campos região, setor, inquiridor e outros são detetados automaticamente no questionário.
Remover um questionário da lista não apaga os dados já importados.
Importação dos agregados
Os agregados Survey Solutions importam-se com o assistente comum a todas as fontes.
Menu: Recolha de Dados → Recolha de Dados → separador Agregados → Importar
- Fonte: escolha Survey Solutions e depois a instituição de recolha, o projeto e, se necessário, o programa.
- Questionário: escolha o questionário.
- Mapeamento: nenhum mapeamento manual é necessário para esta fonte. O questionário é lido segundo a sua própria estrutura:
- os membros vêm do roster, e a dimensão do agregado é o seu número;
- o chefe do agregado é o membro cuja relação de parentesco é « chefe »;
- região, setor e localidade são traduzidos a partir dos códigos do questionário, o GPS a partir da pergunta de coordenadas.
- Pré-visualização e depois Iniciar importação.
Os agregados chegam à pré-recolha, ligados ao projeto e à instituição escolhidos. Só entram no registo depois da validação. Ver Pré-recolha.
Atualização dos agregados
Acesso: página Survey Solutions → Atualização de agregados
Este módulo atualiza os beneficiários já registados a partir de um questionário do tipo Atualização.
| Categoria | Dados atualizados |
|---|---|
| Beneficiário | Seleção do principal e do substituto, nome |
| Contacto e pagamento | Telefone MTN, conta Mobile Money, assinatura do contrato |
| Documentos | BI Antigo, BI CEDEAO, cartão de eleitor, outros documentos |
| Localização | Coordenadas GPS, data de atualização |
- Escolha um questionário, ou deixe Todos os questionários.
- Clique em Iniciar a sincronização.
- Leia o resultado: beneficiários atualizados, não encontrados, erros.
A atualização substitui os valores existentes. Uma correção feita à mão no Bemba é substituída pelo dado do questionário.
Importação das reclamações
Menu: Reclamações (MGR) → Survey Solutions - Reclamações
- Escolha um questionário do tipo Reclamação, ou Todos os questionários.
- Clique em Iniciar a sincronização. O resultado conta as reclamações importadas, os duplicados e os erros.
- Em Reclamações a aguardar categorização, clique em Categorizar.
- Escolha a categoria, a prioridade e o tipo.
- Marque Enviar um aviso de receção por SMS se necessário.
- Clique em Validar.
Estados das entrevistas
| Estado Survey Solutions | Significado |
|---|---|
| SupervisorAssigned | Atribuída ao supervisor |
| Completed | Terminada pelo inquiridor |
| RejectedBySupervisor | Rejeitada pelo supervisor |
| ApprovedBySupervisor | Aprovada pelo supervisor |
| RejectedByHeadquarters | Rejeitada pela sede |
| ApprovedByHeadquarters | Aprovada pela sede |
Com a opção Importar apenas as entrevistas aprovadas, a sincronização planeada só retém as entrevistas aprovadas pela sede.
Sincronização planeada
O servidor sincroniza os questionários de cada configuração ativa, a de cada projeto e a global, segundo o intervalo escolhido. Um administrador pode lançar a sincronização de um só projeto:
php bin/console app:survey-solutions:sync --projet=CODIGO_PROJETO
Resolução de problemas
| Erro | Causa | Solução |
|---|---|---|
| Falha de ligação | URL incorreto | Verifique o URL do servidor |
| Não autorizado | Credenciais incorretas | Verifique o utilizador e a palavra-passe API |
| Nenhum questionário | Workspace incorreto ou questionário não publicado | Verifique o espaço de trabalho e os direitos da conta API |
| Beneficiários « não encontrados » na atualização | O agregado não existe no Bemba | Importe primeiro o agregado |