Survey Solutions
A página Survey Solutions permite configurar a ligação ao servidor Survey Solutions e importar os questionários de agregados e queixas.
Acesso
Menu: Recolha → Survey Solutions
Visão geral
Página principal (Sinc)
A página apresenta:
- Estatísticas: Contadores de questionários e importações
- Ações rápidas: Botões de importação direta
- Lista dos questionários: Questionários configurados
Estatísticas apresentadas
| Indicador | Descrição |
|---|---|
| Questionários | Número total de questionários configurados |
| Agregados | Questionários de tipo "agregado" |
| Queixas | Questionários de tipo "queixa" |
| Estado | Estado da ligação ao servidor |
Ações rápidas
Importação Agregados
Clique em Importar Agregados para:
- Aceder à página de importação dos questionários de agregados
- Selecionar o questionário a importar
- Pré-visualizar os dados
- Lançar a importação
Importação Queixas
Clique em Importar Queixas para:
- Aceder à página de importação das queixas
- Selecionar o questionário de queixas
- Pré-visualizar os dados
- Lançar a importação
Configuração
Acesso
Menu: Recolha → Survey Solutions → Configuração
Ou clique no ícone Parâmetros desde a página principal.
Parâmetros de ligação
| Campo | Tipo | Descrição |
|---|---|---|
| URL do servidor | Texto | Endereço do servidor Survey Solutions |
| Workspace | Texto | Nome do workspace a utilizar |
| Utilizador API | Texto | Nome de utilizador para a API |
| Palavra-passe API | Palavra-passe | Palavra-passe do utilizador API |
Exemplo de configuração
URL do servidor: https://demo.mysurvey.solutions
Workspace: pch_guinee
Utilizador API: api_user
Palavra-passe API: ********
Parâmetros de sincronização
| Parâmetro | Opções | Descrição |
|---|---|---|
| Intervalo de sinc | 1h, 3h, 6h, 12h, 24h | Frequência de verificação automática |
| Importar apenas aprovados | Sim/Não | Filtra os questionários não validados |
Importante
Recomenda-se fortemente ativar Importar apenas os aprovados para garantir a qualidade dos dados.
Testar a ligação
- Preencha os parâmetros de ligação
- Clique em Testar a ligação
- Verifique a mensagem de confirmação
- Clique em Guardar se o teste for bem-sucedido
Gestão dos questionários
Lista dos questionários
| Coluna | Descrição |
|---|---|
| Nome | Nome do questionário Survey Solutions |
| Tipo | Agregado ou Queixa |
| Ativo | Questionário ativado para importação |
| Ações | Modificar, Eliminar |
Adicionar um questionário
- Clique em Adicionar um questionário
- Selecione o questionário desde Survey Solutions
- Escolha o tipo:
| Tipo | Descrição |
|---|---|
| Agregado | Questionário de inquérito a agregados |
| Queixa | Questionário de recolha de queixas |
- Ative ou desative conforme necessário
- Clique em Guardar
Modificar um questionário
- Clique no ícone Modificar (lápis)
- Modifique o tipo ou o estado ativo
- Clique em Guardar
Eliminar um questionário
- Clique no ícone Eliminar (caixote do lixo)
- Confirme a eliminação
Nota
Eliminar um questionário não elimina os dados já importados.
Importação dos dados
Importação dos agregados
Acesso
Menu: Recolha → Survey Solutions → Importar Agregados
Processo
- Seleção: Escolha o questionário a importar
- Pré-visualização:
- Número de entrevistas disponíveis
- Entrevistas já importadas
- Novas entrevistas
- Opções:
- Forçar a reimportação (para atualizar)
- Importação: Clique em Lançar a importação
Correspondência dos campos
O sistema faz corresponder automaticamente os campos Survey Solutions com as entidades Bemba:
| Campo Survey Solutions | Entidade Bemba |
|---|---|
| Informações agregado | Menage |
| Chefe de agregado | ChefMenage |
| Membros | Membre |
| Habitação | Logement |
| Localização GPS | Coordenadas GPS |
Importação das queixas
Acesso
Menu: Recolha → Survey Solutions → Importar Queixas
Processo
- Seleção: Escolha o questionário de queixas
- Pré-visualização:
- Queixas disponíveis
- Queixas já importadas
- Novas queixas
- Importação: Clique em Lançar a importação
Correspondência dos campos
| Campo Survey Solutions | Entidade Bemba |
|---|---|
| Descrição | Plainte.description |
| Queixoso | Plainte.plaignant |
| Contacto | Plainte.telephone |
| Categoria | Plainte.categorie |
| Data | Plainte.dateCreation |
Estados das entrevistas
Survey Solutions utiliza estados específicos:
| Estado | Código | Importável |
|---|---|---|
| Atribuído ao Supervisor | SupervisorAssigned | Não |
| Rejeitado pelo Supervisor | RejectedBySupervisor | Não |
| Aprovado pelo Supervisor | ApprovedBySupervisor | Sim (se opção ativa) |
| Rejeitado pelo QA | RejectedByHeadquarters | Não |
| Aprovado pelo QA | ApprovedByHeadquarters | Sim |
Conselho
Com a opção Importar apenas aprovados, apenas os estados "ApprovedBySupervisor" e "ApprovedByHeadquarters" são importados.
Sincronização automática
Configuração
- Aceda à Configuração
- Defina o Intervalo de sincronização:
| Intervalo | Uso |
|---|---|
| 1 hora | Acompanhamento quase em tempo real |
| 3 horas | Uso standard |
| 6 horas | Uso moderado |
| 12 horas | Verificação duas vezes ao dia |
| 24 horas | Verificação diária |
- Guarde os parâmetros
Funcionamento
- O sistema verifica automaticamente as novas entrevistas
- As entrevistas aprovadas são importadas automaticamente
- Uma notificação é enviada em caso de erro
Casos de utilização
Configuração inicial
- Aceda a Survey Solutions → Configuração
- Preencha os parâmetros de ligação
- Teste a ligação
- Guarde
- Adicione os questionários a importar
- Defina o tipo de cada questionário
- Ative a sincronização automática
Importação manual diária
- Aceda a Survey Solutions
- Verifique as estatísticas
- Clique em Importar Agregados ou Importar Queixas
- Pré-visualize os dados
- Lance a importação
- Verifique os dados importados
Reimportar após correção
Se dados foram corrigidos no Survey Solutions:
- Aceda à página de importação correspondente
- Marque Forçar a reimportação
- Selecione as entrevistas a reimportar
- Lance a importação
Resolução de problemas
Erro de ligação
| Erro | Causa | Solução |
|---|---|---|
| Ligação recusada | URL incorreto | Verifique a URL do servidor |
| Não autorizado | Credenciais incorretas | Verifique utilizador/palavra-passe |
| Workspace não encontrado | Nome incorreto | Verifique o nome do workspace |
Nenhum questionário encontrado
- Verifique que os questionários estão implementados
- Verifique as permissões do utilizador API
- Verifique o workspace selecionado
Dados em falta após importação
| Problema | Causa | Solução |
|---|---|---|
| Campos vazios | Não preenchidos no SS | Verificar os dados fonte |
| Agregado não criado | Entrevista não aprovada | Aprovar a entrevista |
| Erro de mapeamento | Campo não reconhecido | Verificar a configuração |
Boas práticas
Configuração
- Utilize uma conta API dedicada
- Ative a importação apenas dos aprovados
- Teste a ligação regularmente
Importação
- Pré-visualize sempre antes de importar
- Verifique as estatísticas pós-importação
- Documente os erros encontrados
Manutenção
- Monitorize os logs de sincronização
- Atualize os questionários se necessário
- Arquive as importações concluídas
Permissões
| Ação | Permissão necessária |
|---|---|
| Ver Survey Solutions | collecte.survey_solutions_view |
| Configurar | collecte.survey_solutions_edit |
| Importar | collecte.survey_solutions_import |