KoboToolbox
O KoboToolbox serve para recolher no terreno os agregados, as reclamações, as reuniões e os compromissos com o código de conduta. Esta página explica como ligar uma conta Kobo e onde chegam os dados no Bemba.
Não existe ecrã KoboToolbox dedicado. Os dados Kobo passam pelo ecrã que corresponde ao seu uso.
Dois servidores KoboToolbox
O projeto dispõe do seu próprio servidor KoboToolbox, além do serviço online kobotoolbox.org, cujo plano gratuito limita as submissões mensais.
| Servidor | Endereço | Uso |
|---|---|---|
| Kobo online | https://kf.kobotoolbox.org | Formulários existentes cujas ligações já circulam |
| Servidor do projeto | https://kf.kobo.ucp-pch.org | Novos formulários, sem quota |
Cada projeto do SIG está ligado a um servidor: endereço da API e token. O SIG pode, portanto, ler os dois.
Uma conta KoboToolbox pertence a um único servidor. Os utilizadores do Kobo online não existem no servidor do projeto: é preciso criar-lhes uma conta. As ligações web já partilhadas a partir de kobotoolbox.org não podem ser redirecionadas.
Para a instalação e a exploração do servidor, ver KoboToolbox auto-alojado.
Ligar uma conta Kobo
Conta de um projeto
- Abra Administração → Projetos.
- Clique no botão Sincronização da recolha ⟳ da linha do projeto.
- No bloco KoboToolbox, preencha o URL da API e o Token API.
- Clique em Guardar e depois em Testar a ligação guardada.
O token nunca é reapresentado. Deixe o campo vazio para conservar o token já registado.
Conta global
A conta global serve os projetos que não têm conta própria.
- Abra Administração → Definições, separador Definições, secção Integrações API.
- Marque Ativar esta integração.
- Preencha o URL da API e o Token API.
- Clique em Testar a conexão e depois em Guardar.
No KoboToolbox: Definições da conta → Segurança → Chave API.
Importar agregados
Os agregados recolhidos com o Kobo importam-se com o assistente de importação comum às três fontes.
Menu: Recolha de Dados → Recolha de Dados → separador Agregados → Importar
- Fonte: escolha Kobo e depois a Instituição de recolha, o Projeto e, se necessário, o Programa.
- Questionário: escolha o formulário e clique em Carregar campos.
- Mapeamento: associe os campos do formulário aos campos do Bemba. O botão Deteção automática propõe as correspondências evidentes.
- Pré-visualização: verifique os dados.
- Importação: clique em Iniciar importação.
O mapeamento é obrigatório para o Kobo. Os agregados chegam à pré-recolha e aguardam uma validação antes de entrar no registo. O detalhe está no tutorial de importação.
Estado de validação Kobo
O assistente de importação lê todas as submissões do formulário, seja qual for o seu estado no Kobo. Controle portanto as submissões no Kobo antes da importação, ou faça a triagem depois na pré-recolha.
Quando o formulário é sincronizado automaticamente, o estado definido no Kobo é conservado com o agregado:
| Estado Kobo | Conservado como |
|---|---|
| Aprovado | Aprovado, com o nome do aprovador |
| Não aprovado | Rejeitado, com o nome do aprovador |
| Em espera | Em espera, com o nome do controlador |
Importar reclamações
Declarar o formulário de reclamações
- Abra Reclamações (MGR) → Reclamações.
- Clique em Nova reclamação e depois em Importação Kobo.
- Em Outros formulários disponíveis, clique em Configurar para reclamações em frente ao formulário.
- Clique em Sincronizar para ler as suas submissões.
Categorizar as reclamações recebidas
Menu: Reclamações (MGR) → Kobo - Reclamações
O ecrã lista as reclamações a aguardar categorização. O botão Sincronizar com Kobo relê o formulário. Para cada reclamação:
- Clique em Categorizar.
- Escolha o projeto, a categoria, a prioridade e o tipo de reclamação.
- Marque Reclamação sensível (EAS/HS) se necessário.
- Marque Enviar aviso de receção se o reclamante deve ser avisado.
- Clique em Validar e guardar.
Um aviso assinala os duplicados prováveis: mesmo reclamante e mesmo objeto que uma reclamação anterior. A categorização funciona também offline: é enviada quando a ligação volta.
Ver Reclamações.
Código de conduta
O formulário público de assinatura do código de conduta é um formulário Kobo.
Menu: Serviços Sociais → Código de conduta
O botão Sincronizar Kobo lê as novas submissões e descarrega as suas imagens. O ecrã mostra depois a lista dos signatários, estatísticas e exportações.
Sincronização automática
Dois mecanismos evitam as importações manuais:
- Serviço REST Kobo: o KoboToolbox pode avisar o Bemba a cada nova submissão. A configuração faz-se no Kobo por um administrador.
- Comando planeado: um administrador pode sincronizar um formulário com a conta de um projeto.
php bin/console app:kobo:sync <identificador_formulario> --projet=CODIGO_PROJETO
Um projeto sem conta Kobo própria é recusado por este comando.
Resolução de problemas
| Problema | Causa provável | Solução |
|---|---|---|
| Nenhum questionário proposto | Projeto não escolhido, ou conta do projeto ausente | Escolha o projeto no primeiro passo; verifique a sua sincronização |
| « Não configurada neste servidor » | Nenhuma conta Kobo, nem do projeto nem global | Preencha a conta do projeto |
| Falha no teste de ligação | Token ou URL incorretos, ou servidor errado | Verifique que o URL e o token vêm do mesmo servidor |
| Campos vazios após a importação | Mapeamento incompleto | Refaça a importação completando o mapeamento |
| Um inquiridor não tem atividade | Identificador Kobo diferente do nome de utilizador | Corrija a sua ficha em Inquiridores |
Boas práticas
- Uma conta Kobo por projeto, com um token dedicado.
- Os novos formulários no servidor do projeto.
- Uma pequena importação de teste a cada novo formulário.
- Os agregados importados tratados sem demora na pré-recolha.