Importar Dados

Este tutorial explica como importar agregados em massa a partir de um ficheiro CSV ou via KoBoToolbox.

Metodos de importacao

O PCH-SIG suporta varios metodos de importacao:

Metodo	Fonte	Utilizacao
CSV	Ficheiro Excel/CSV	Importacao manual
KoBoToolbox	Formularios moveis	Recolha de campo
Survey Solutions	Inqueritos CAPI	Grandes inqueritos

---

Importacao CSV

Etapa 1: Descarregar o modelo

1. Va a Registo Social > Agregados
2. Clique em Importar
3. Clique em Descarregar modelo
4. Um ficheiro CSV modelo e descarregado

Etapa 2: Preencher o ficheiro

Abra o modelo em Excel e preencha as colunas:

Coluna	Obrigatorio	Exemplo
regiao	Sim	Dakar
setor	Sim	Parcelles Assainies
municipio	Sim	Parcelles Assainies
localidade	Sim	Unite 10
meio	Sim	Urbano
chefe_nome	Sim	Mamadou Diop
chefe_sexo	Nao	M
chefe_idade	Nao	45
chefe_telefone	Nao	771234567
tamanho_agregado	Sim	5
latitude	Nao	14.6937
longitude	Nao	-17.4441

Formato

• Guarde em formato CSV UTF-8
• Utilize o ponto e virgula (;) como separador
• Nao modifique os cabecalhos das colunas

Etapa 3: Importar o ficheiro

1. Clique em Importar
2. Selecione o seu ficheiro CSV
3. Clique em Carregar

Etapa 4: Verificar a pre-visualizacao

Antes da importacao definitiva:

• Verifique as primeiras linhas
• Controle o numero de registos
• Corrija os erros assinalados

Etapa 5: Lancar a importacao

1. Clique em Importar
2. Aguarde o fim do processamento
3. Consulte o relatorio de importacao

Relatorio de importacao

O relatorio indica:

• Importados: Numero de agregados criados
• Ignorados: Duplicados detetados
• Erros: Linhas com problemas

---

Importacao KoBoToolbox

Configuracao inicial

1. Va a Dados > KoBoToolbox
2. Clique em Configurar
3. Introduza as suas credenciais KoBo:
   • URL do servidor
   • Token API

Sincronizar os formularios

1. Clique em Sincronizar
2. A lista dos formularios disponiveis e apresentada
3. Selecione o formulario a importar

Importar as submissoes

1. Clique no formulario
2. Selecione o periodo
3. Clique em Importar

As novas submissoes sao importadas como agregados com estado "Pendente".

Mapeamento dos campos

Configure a correspondencia entre as perguntas KoBo e os campos PCH-SIG:

Pergunta KoBo	Campo PCH-SIG
regiao	regiao
nome_chefe	chefe_nome
gps	latitude, longitude
...	...

---

Importacao Survey Solutions

Sincronizacao

1. Va a Dados > Survey Solutions
2. Configure a ligacao ao servidor SUSO
3. Selecione o questionario
4. Clique em Sincronizar

Validacao dos dados

Antes da importacao, os dados passam por uma validacao:

• Verificacao dos campos obrigatorios
• Detecao de duplicados
• Controlo de coerencia

---

Gestao de erros

Erros comuns

Erro	Causa	Solucao
"Regiao desconhecida"	Nome de regiao incorreto	Verificar a ortografia
"Duplicado detetado"	Agregado ja existente	Ignorar ou fundir
"Campo obrigatorio"	Valor em falta	Completar o campo
"Formato invalido"	Formato de dados incorreto	Corrigir o formato

Corrigir e reimportar

1. Descarregue o relatorio de erros
2. Corrija as linhas com erro
3. Reimporte apenas as linhas corrigidas

---

Boas praticas

Antes da importacao

• Teste com uma pequena amostra
• Verifique o formato do ficheiro
• Guarde o ficheiro original

Apos a importacao

• Verifique alguns agregados aleatoriamente
• Lance uma detecao de duplicados
• Valide os agregados importados

---

Proximos passos

• Procurar um beneficiario
• Gerir duplicados