Manual para a aplicação. Open Data Kit



Documentos relacionados
Google Drive. Passos. Configurando o Google Drive

Manual Captura S_Line

Manual de instalação e configuração da Ferramenta Android SDK

WEBSITE DEFIR PRO

PRIMAVERA EXPRESS: Funcionalidades do Produto

Portal Sindical. Manual Operacional Empresas/Escritórios

FERRAMENTAS DE COLABORAÇÃO CORPORATIVA

TUTORIAL: MANTENDO O BANCO DE DADOS DE SEU SITE DENTRO DO DOMÍNIO DA USP USANDO O SSH!

GUIA INTEGRA SERVICES E STATUS MONITOR

Manual de Administração Intranet BNI

02 - Usando o SiteMaster - Informações importantes

TUTORIAL. Como criar um blogue/página pessoal no WordPress

Manual GMI-Gabinete de Manutenção Informática

Manual - Gemelo Backup Online WEB

MANUAL PLATAFORMA WEB DE ENVIO EM MASSA SMS WEB

Acronis Servidor de Licença. Manual do Utilizador

Manual de Utilizador. Caderno. Recursos da Unidade Curricular. Gabinete de Ensino à Distância do IPP.

Tutorial Gerar arquivo PDF. Gerando um documento pdf com várias imagens 1- Inserir imagem no Word

SECUNDÁRIA DE CAMARATE Plataforma Office 365. Alojamento de ficheiros - OneDrive para Empresas

Manual do Google agenda. criação e compartilhamento de agendas

Para começarmos as configurações, primeiramente vamos habilitar o DVR Veicular para o acesso. Clique em Menu e depois entre em Geral.

Realizado por: Fábio Rebeca Nº6. Iuri Santos Nº8. Telmo Santos Nº23

Como Gerar documento em PDF com várias Imagens

1 REQUISITOS BÁSICOS PARA INSTALAR O SMS PC REMOTO

Como funciona a MEO Cloud?

Manual Administrador - Mídia System

TUTORIAL DE UTILIZAÇÃO. Rua Maestro Cardim, cj. 121 CEP São Paulo - SP (11)

Equipa PTE. Janeiro 2012

Java Mail Server. Manual do Utilizador

Manual de Utilizador Documentos de Transporte. TOConline. Suporte. Página - 1

Procedimentos para Reinstalação do Sisloc

Tutorial Plone 4. Manutenção de Sites. Universidade Federal de São Carlos Departamento de Sistemas Web Todos os direitos reservados

Ferramentas Web, Web 2.0 e Software Livre em EVT

Open Data Kit: O Que Aprendemos? Francis Smart

Manual de configuração do sistema

Projeto Competências em informação on line Tutoriais em Tecnologias Intelectuais

CONFIGURAÇÃO DO ACESSO REMOTO PARA HS-DHXX93 E HS-DHXX96

Índice. Manual Backup Online. 03 Capítulo 1: Visão Geral

Guia de instalação e Activação

Guia. PDA e SmartPhones. Windows Mobile, Pocket PC e CE.

Sistema de Registro das Atividades do RT - Tutorial de utilização

Na tela dele, clique no sinal de + ao lado do nome do seu computador, para expandi-lo. A seguir, expanda também o item "Sites da web".

ÍNDICE. GUIa DE UtIlIzaÇÃo

Tutorial: criação de uma Ficha de Voluntário online

Youtube Sign Up Sign Up Upload

Oficina de Construção de Páginas Web

Como criar e editar Blogs. Manual Básico do. Mario Roberto Barro Jerino Queiroz Ferreira Profª Drª Salete Linhares Queiroz

Tutorial exe elearning XHTML editor (versão 1.0x)

SMS App Desktop. Manual Plataforma Desktop de Envio em Massa

Manual Integra S_Line

MANUAL DO ANIMAIL Terti Software

Manual de Utilização do PLONE (Gerenciador de página pessoal)

Cadastramento de Computadores. Manual do Usuário

Aplicativo da Manifestação do Destinatário. Manual

FERRAMENTAS DE COLABORAÇÃO CORPORATIVA

CRIANDO TEMPLATES E LEGENDAS

Registo como Agente. De seguida, terá de editar a sua informação de agente, carregando em Profile e, de seguida, em Edit.

Manual AGENDA DE BACKUP

ÍNDICE. Acesso para agências...3. Organização por pastas...4. Download das facturas a partir do site...5. Pesquisa de facturas...8

Plataforma de Benefícios Públicos Acesso externo

Descrição de Como Utilizar

Manual de Atualização MATERIAL DE APOIO - KB IMÓVEIS

Fluxo de trabalho do Capture Pro Software: Indexação de código de barras e separação de documentos

CONFIGURAÇÃO MINIMA EXIGIDA:

Manual do Usuário - Plataforma Simulados

MANUAL DE UTILIZAÇÃO

OneDrive: saiba como usar a nuvem da Microsoft

SAFT para siscom. Manual do Utilizador. Data última versão: Versão: Data criação:

Manual do Sistema "Vida Controle de Contatos" Editorial Brazil Informatica

Manual de Instalação EDIÇÃO 1.0

EM4590R1 Repetidor Sem Fios WPS

Guia de instalação do Player Displr Windows 7, 8.1 e 10

Como funciona? SUMÁRIO

Manual de Utilizador. Disciplina de Projecto de Sistemas Industriais. Escola Superior de Tecnologia. Instituto Politécnico de Castelo Branco

Pingwin Android Como instalar

Faturamento Eletrônico - CASSEMS

atube Catcher versão 3.8 Manual de instalação do software atube Catcher

1. Introdução pág.3 2. Apresentação do sistema Joomla! pág.4 3. Acessando a administração do site pág.4 4. Artigos 4.1. Criando um Artigo 4.2.

RASTREIE SEU NOTEBOOK (FURTADO OU ROUBADO) INTERNET

Procedimentos para Instalação do Sisloc

Configurando o DDNS Management System

Esse manual é um conjunto de perguntas e respostas para usuários(as) do Joomla! 1.5.

MANUAL DE INSTALAÇÃO E CONFIGURAÇÃO. Motor Periférico Versão 8.0

Manual do usuário. Softcall Java. versão 1.0.5

Adapti - Technology Solutions Leonor cardoso nº 331 Fone : (041) Curitiba - PR MANUAL DO USUÁRIO

Instalando software MÉDICO Online no servidor

Manual de Configuração

Polycom RealPresence Content Sharing Suite Guia rápido do usuário

Manual do Sistema de Cadastro de Cultivares Locais, Tradicionais e Crioulas

Neogrid (ezmarket) Supplier FAQ. NeoGrid (ezmarket) Fornecedor - Perguntas e Respostas

AVG Admin 2012 SQL Server 2005 Express

ZS Rest. Manual Profissional. BackOffice Mapa de Mesas. v2011

Instruções de uso do TABNET. Linha, Coluna e Conteúdo

BACKUP ONLINE PASSOS PARA CONFIGURAÇÃO INICIAL DO PRODUTO

Manual do PDFCreator Versão 1

UNIVERSIDADE FEDERAL DE GOIÁS CERCOMP (CENTRO DE RECURSOS COMPUTACIONAIS) TUTORIAL DE USO DO WEBMAIL - UFG

Manual de Utilização de Certificados Digitais. Microsoft Word 2003

Transcrição:

Manual para a aplicação Open Data Kit

MANUAL PARA A APLICAÇÃO ODK Edita: ONGAWA C/ Vizconde de Matamala, 15 28028 Madrid Tfno.: (+34) 91 590 01 90 info@ongawa.org Coordenador: Rudy Martínez Autor: Catalina Madrid Imagens: ODK Design e layout: www.puntoycoma.org MAIO 2015 Este trabalho está sujeito à licença Reconocimiento-NoComercial-SinObra Derivada 2.5 España de Creative Commons. Para ver uma cópia desta licença visite http://creativecommons.org/ licenses/by-nc-nd/2.5/es/ Indice O que é ODK e para qué é utilizado?... 3 Aplicações típicas... 3 Componentes gerais... 3 Componentes básicas... 4 Experiência piloto... 6 Elaboração do formulário... 6 Criar uma instância de App Engine... 15 Preparação dispositivo Android... 17 Visualização em ODK Aggregate... 19 Descarregamento de formulários no ODK Briefcase... 21 Recomendações... 26 Bibliografía... 27

O que é ODK e para qué é utilizado? ODK é uma aplicação, desenvolvida por investigadores do Departamento de Ciência da Computação e Engenharia da Universidade de Washington, utilizada para a recolha de informação através de telefones móveis (ou tablet) com sistema operativo Android. A informação recolhida com os dispositivos móveis é enviada a um sistema centralizado que permite realizar relatórios com os dados agregados. ODK permite gerar um formulário adaptado que facilite a tomada de dados duma forma itinerante. Além disso, permite anexar fotografías realizadas com o mesmo dispositivo bem como a informação referente à localização fazendo uso do GPS. Para a recolha de dados não é necessário dispor de conectividade no terminal, pode-se ir ao terreno, recolher a informação e processá-la no regresso ao escritório. Aplicações típicas As aplicações que podem-se desenvolver em base à recolha itinerante de dados são muito variadas. Por exemplo, para mapear o estado das infraestruturas, pontos de abastecimento de água, acesso e estado dos sistemas de saneamento,etc. No ámbito da saúde tem sido utilizado, por exemplo, na realização de estudos epidemiológicos. No sector agropecuário têm sido desenvolvidas muitas aplicações para a tomada de dados sobre explorações agrícolas e pecuárias. Componentes gerais 1. ODK Build o XLSForm, para o desenho dos formulários. 2. ODK Collect, para a recolha de dados através dum dispositivo Android. 3. ODK Aggregate, para armazenar os formulários uma vez preenchidos e recolher os resultados dos formulários. 4. ODK Form Uploader, para carregar os formulários em branco ao ODK Aggregate sempre que seu tamanho seja superior aos 10 MB. Caso contrário, pode-se carregar directamente ao ODK Aggregate. ONGAWA - MANUAL PARA A APLICAÇÃO OPEN DATA KIT 3

5. ODK Briefcase, como alternativa ao Aggregate para o armazenamento dos formulários quando não existe ligação a Internet. Também, pode-se fazer o descarregamento de dados desde o Aggregate ao Briefcase para evitar problemas de compatibilidade. 6. ODK Validate, para comprovar se o formulário originado no ODK Build é válido. 7. ODK Sensor, para simplificar o desenvolvimento das aplicações móveis baseadas nos sensores através da criação duma abstração comum que permita o acesso a todos os sensores através duma detecção unificada. Componentes básicas Para a entrada em funcionamento do ODK são precisas 3 componentes básicas das 7 explicadas anteriormente. ODK BUILD, PARA O DESENHO DOS FORMULÁRIOS Para facilitar o processo de elaboração do formulário dispõe-se duma ferramenta on line (http://build.opendatakit.org) a qual gera um arquivo com o formulário em branco que depois vai-se carregar ao dispositivo móvil. A ferramenta build.opendatakit.org é útil para gerar formulários de pequeno tamanho. No entanto, se os formulários são grandes é preferível utilizar outro método que consiste em compor uma planilha de cálculo (por exemplo, Excel) na qual estão definidos todos os campos. Posteriormente será utilizada outra aplicação (http://opendatakit.org/xiframe/) a qual processa o arquivo no formato.xls(formato de Excel) e o converte num arquivo de formato.xlm. No desenho do formulario é definido o conjunto de variáveis (ou características) que vão se tomar em cada amostra. Estas variáveis podem ser textos, campos a selecionar de uma lista, dados numéricos, datas... Para além, o formulário pode-se complementar com fotografías e detalhe da localização geográfica do lugar onde são tomados os dados. ODK COLLECT, PARA A RECOLHA DE DADOS Para a recolha de dados é preciso um dispositivo móvil com sistema operativo Android. Através do Google Play faz-se o descarregamento da aplicação ODK Collect (https://play.google.com/store/apps/details?id=org.odk.collect.android). Uma vez instalada a aplicação, podem-se carregar um ou vários formulários (em branco) dos criados anteriormente.. 4 MANUAL PARA A APLICAÇÃO OPEN DATA KIT - ONGAWA

Para o proceso de tomada de dados não é preciso dispor de acesso a internt já que os dados ficam armazenados no dispositivo. Isto permite deslocarmos aos diferentes pontos de recolha de informação, preencher os formulários e, quando voltarmos ao escritório, procede-se ao envio dos dados recolhidos para sua agregação e processamento. Se ficar alguma informação pendente de preencher por desconhecimento, o formulário pode ser armazenado SEM FINALIZAR e finalizá-lo quando soubermos a informação. ODK AGGREGATE, PARA A AGREGAÇÃO DA INFORMAÇÃO Quando quisermos armazenar os formulários no computador existem duas alternativas, local instance ou cloud instance. A opção local instance é a mais complicada, já que exige ter um servidor no qual serão instaladas as aplicações às que serão ligados depois os dispositivos utilizados para a recolha de informação. Nos dispositivos móveis deverá-se configurar a URL 1 deste servidor. A opção cloud instance não requer de um servidor e, portanto, é mais simples de implementar. Faz-se uso da Google App Engine (https://appengine.google.com/). Os dispositivos móveis ligarão-se à URL https://xxxx.appspot.com onde XXXXé o nome da aplicação criada através da App Engine. Assim que o servidor estiver configurado correctamente desde os termináis móveis e preciso carregar no servidor (desde o computador) os formulários em branco (.xml). Depois disto tudo está pronto para poder ver e preencher os formulários e, depois de recolher os dados, enviar os formulários preenchidos desde o terminal. (Este processo explica-se mais detalhadamente no caso prático). Se tiver sido escolhida a opção cloud instance poderão-se ver os dados no servidor (https://xxxxxx.appspot.com). A visulização de dados pode-se realizar bem numa tabela, exportar os dados a um arquivo.csv, mostrar gráficos ou localizar a informação em um mapa (.kml). 1 URL é o endereço de um recurso disponível em uma rede, seja a rede internet ou intranet, e significa em inglês Uniform Resource Locator, e em português é conhecido por Localizador Padrão de Recursos.Em outras palavras, URL é um endereço virtual com um caminho que indica onde está o que o usuário procura, e pode ser tanto um arquivo, como uma máquina, uma página, um site, uma pasta etc. URL também pode ser o link ou endereço de um site. ONGAWA - MANUAL PARA A APLICAÇÃO OPEN DATA KIT 5

Experiência piloto Com o fim de mostrar um exemplo de aplicação prática expõe-se a continuação a Experiência Piloto levada a cabo no Municipio da Manhiça (Moçambique). 1. ELABORAÇÃO DO FORMULÁRIO Tem sido elaborado fazendo uso duma planilha de cálculo Excel. Para maior facilidade recomenda-se descarregar o exemplo fornecido pela web oficial de ODK: https://opendatakit.org/use/xlsform/ (sample Excel file). Ilustração1: Interfaceda web de Open Data Kit (ODK), parágrafo doxlsform. Ilustração 2: ArquivoExcel modelo para a elaboração do formulário. 6 MANUAL PARA A APLICAÇÃO OPEN DATA KIT - ONGAWA

Este exemplo mostra 3 entradas (tabs): SURVEY, CHOICES e SETTINGS. SURVEY Survey é a tab correspondente às perguntas que vão compor o formulário. Hà 3 colunas principais: type (tipo de campo: se é texto, número inteiro, número decimal, coordenadas,...todos os tipos possíveis estão na primeira coluna da tab survey do arquivo exemplo), name é o nome que terá o campo na base de dados futura uma vez seja feito o descarregamento de dados; os nomes não podem levar espaços e têm que ser simples, que identifiquem a informação desse campo com 2 ou 3 palavras máximo. Se for possível deveriam evitarse os sinais de pontuação e qualquer outra sinal que não seja _. A terceira coluna é label, que é a pergunta tal como a gente quer que apareça no formulário final. Para ver o resto das funções das colunas recomenda-se visitar o seguinte link: http://xlsform.org/, embora seja explicado o usa das utilizadas na presente experiência piloto. Ilustração3: Interfaz do tutorial para a elaboração do formulário. ONGAWA - MANUAL PARA A APLICAÇÃO OPEN DATA KIT 7

CHOICES Há perguntas cuja resposta será um número, um texto, etc., mas a vantagem do ODK é a rapidez na recolha de dados e para isso, normalmente, as perguntas terão respostas já estipuladas e serão de escolha única ou múltipla. Na tab choices escrevem-se todas as possíveis respostas e relacionam-se com as perguntas na coluna type da tab survey, escrevendo select_one XXXX ou select_multiple XXXX e depois na tab choices, na coluna list_ name, escreve-se a palavra escrita depois de select_one ou select_multiple (XXXX). A coluna name dá o nome às respostas tal como aparecerão no armazenamento de dados (ODK Aggregate) e na coluna label escreve-se a resposta tal como nós queremos que apareça no formulário. Ver o exemplo (ilustrações 4 e 5): Ilustração4: Tab survey. Ilustração5: Tab choices. 8 MANUAL PARA A APLICAÇÃO OPEN DATA KIT - ONGAWA

Se o objetivo é criar uma base de dados nova é preciso definir bem a informação que queremos armazenar em cada campo e o tipo de resposta (se será escolha única, múltipla, número inteiro, decimal,...). Nesta experiência o objetivo é actualizar uma BDD existente na qual há campos nos que podemse escolher várias respostas. Pretendeu-se fazer mais simples escrevendo no formulário a opção duma pergunta com escolha múltipla (select_multiple), masno momento de fazer o descarregamento de dados no Aggregate, estes campos agrupam numa célula da tabela todas as respostas marcadas, facto que complica o tratamento posterior dos resultados. (Ver o exemplo na ilustração 6). Ilustração6: Agrupamento das respostasno descarregamento de dados de uma pergunta de escolha múltipla. Coluna AC, campo WP_seasonality_months. Para a solução deste problema tem se recorrido a uma das opções oferecidas nas diferentes colunas da tab survey (opção appearance ). A explicação da função de Appearance está na página a seguir, no parágrafo Appearance. ONGAWA - MANUAL PARA A APLICAÇÃO OPEN DATA KIT 9

SETTINGS Nesta tab escreve-se o nome do formulário para sua identificação quer no dispositivo Android quer no ODK Aggregate. Como tem sido comentado anteriormente, vão-se explicar as colunas da tab survey usadas nesta experiência prática: Required : para marcar uma pregunta com resposta obrigatória e que não passe à seguinte. Só é preciso escrever yes no caso seja uma resposta obrigatória. Appearance : usa-se para que no formulário a preencher apareça uma pergunta que possa ter várias respostas, mas não queremos que todas estejam agrupadas na mesma célula na tabela final quando a gente descarrega os dados (problema explicado anteriormente). O objetivo é que no output apareçam em campos diferentes. Para fazer isto cria-se um grupo de respostas que contenha todos os campos das possíveis respostas, e a pergunta será de escolha única sim/ não (select one) (yes/no). É preciso aplicar ao grupo, abaixo da coluna appearance, a função table-list, dessa maneira no output seriam obtidas quatro colunas com as respostas sim ou não. Com esta função também conseguimos que este grupo apareça numa sola ecrã no momento de preencher o formulário no dispositivo Android. Para criar um grupo escreve-se na coluna type da tab survey as palavras begin group e na coluna name o nome do grupo, que será o nome do campo na tabela futura da BDD. Na coluna label escreve-se a pergunta. Abaixo de begin group escrevem-se o tipo de pergunta (neste caso de escolha única (select_one)) e a referência para a posterior identificação (recordar que é a mesma que vamos ter que escrever na coluna list name da tab choices, select_one XXXX). ATENÇÃO! Os nomes dos campos (na coluna name ) têm que ser diferentes, mas na coluna type tem que aparecer select_one XXXX) EM TODAS AS CÉLULAS DO GRUPO! 10 MANUAL PARA A APLICAÇÃO OPEN DATA KIT - ONGAWA

Na coluna appearance, na mesma linha de begin group temos que escrever table-list. Ver o exemplo (ilustrações 7 e 8): Ilustração 7: Criação de um grupo, primeira captura de imagem. Ilustração8:Criação de um grupo, segunda captura de iamgem. ONGAWA - MANUAL PARA A APLICAÇÃO OPEN DATA KIT 11

Na tab choices é preciso escrever na primeira coluna a referência escrita como identificação na primeira coluna de survey e na segunda coluna yes e no, pois é de escolha única. Na terceira coluna label a gente tem que escrever o que quera que apareça no formulário. Ilustração 9: Tab choices, definição das respostas de um grupo. Relevant : usa-se para enlaçar perguntas relacionadas que dependem da resposta anterior. Por exemplo, na captura de imagem seguinte temos a pergunta C2. Quém faz a gestão do sistema? Com as respostas: não há gestão, Comité de Gestão, Individual/Privado, Municipio/Governo, Instituição, Outro. Se a resposta é Comité de Gestão continua-se com as perguntas C3 a C7, se não, automáticamente pulará à C8. 12 MANUAL PARA A APLICAÇÃO OPEN DATA KIT - ONGAWA

Isto consegue-se escrevendo um comando na coluna relevant, com a seguinte estrutura: selected (${ nome do campo da pergunta da qual depende o resto tal como está escrito na coluna name }, Resposta que enlaça ao resto de perguntas tal como está escrito na columna name da tab choices ). Exemplo: selected(${wp_manager}, C_Comité_de_Gestão ) Ilustração10: Cadeia de perguntas ONGAWA - MANUAL PARA A APLICAÇÃO OPEN DATA KIT 13

Depois de ter o formulário pronto, o seguinte passo é converter o arquivo.xls ao formato.xml qué é o aceitado pelo ODK. Para isso temos que abrir a página: https://opendatakit.org/use/xlsform/ clicar no ponto 2 do parágrafo Using the application e aparece esta página: http://opendatakit.org/xiframe/. O seguinte passo é selecionar o Excel onde temos feito o formulário e clicar em submit. Se tudo for escrito correctamente não dará nenhum erro, se há alguma coisa que temos escrito mal, dará erro, e temos que olhar onde é que está o erro e tentar solucioná-lo. Uma vez esteja tuodo correto, podemos descarregar o arquivo.xml clicando em Download. Ilustração11: Conversão de.xls a.xml, ilustração 1. Ilustração 12: Conversão de.xls a.xml, ilustração 2. 14 MANUAL PARA A APLICAÇÃO OPEN DATA KIT - ONGAWA

2. CRIAR UMA INSTÂNCIA DE APP ENGINE O seguinte passo é criar uma instância de App Engine, que é o servidor online, para o descarregamento dos formulários quando estiverem preenchidos. Neste caso, tem sido criada já, URL://waterpointongawa2.appspot.com. Mesmo assim explica-se no presente manual cómo fazé-lo. CÓMO CRIAR UMA INSTANCIA DE APP ENGINE 1. Em primeiro lugar, será preciso configurar uma conta de Google App Engine (https://appengine.google.com/start). 2. Após o login, clicar em Create an Application (Criar uma aplicação). Ilustração 13: Interface da criaçãoda Google App engine. 3. Atribuir um identificador à aplicação. Este identificador formará parte da URL da instância da App Engine (por exemplo, myurl.appspot.com ). 4. Descarregar a versão mais recente de ODK Aggregate na página de descarregamentos de ODK. 5. Descomprimir o arquivo (clicar no arquivo incluido na pasta Downloads do computador ou fazer right click e descomprimí-lo no PC). O arquivo ficará descomprimido como uma pasta nomeada ODKAggregateversión-SO-installer. 6. Fazer duplo click para executar a aplicação. Aparecerá no assistente de configuração de ODK Aggregate. Clicar em Next (Seguinte). 7. Aceitar o acordo de licença de ODK Aggregate. A continuação, selecionar a localização no computador onde queremos armazenar os arquivos do programa de instalação do software que será executado na Google App Engine. ONGAWA - MANUAL PARA A APLICAÇÃO OPEN DATA KIT 15

8. Executar o assistente de configuração. Introduzir o nome da instância de ODK (por exemplo, odktutorial para odktutorial.appspot.com) e a conta de Google associada a essa instância. 9. Quando o assistente de configuração tenha finalizado a configuração do ODK Aggregate, será pedida a execução da seqüência de comandos da instalação. 10. Voltar a introduzir a conta de Google e a senha asociadas à instância de App Engine. 11. A seqüência de comandos pode demorar na sua execução entre 3 e 10 minutos. Quando tenha finalizado, aparecerá uma messagem que confirmará a correta instalação. Se tem havido um erro na introdução da informação no assitente de configuração, para voltar a executar o assistente de configuração, voltar à pasta em que esteja instalado ODK Aggregate e clicar duas vezes no programa de instalação para voltar a executá-lo. 12. Quando a seqüência de comandos fique executada, aceder à URL de App Engine para comprovar que a configuração foi correta. 16 MANUAL PARA A APLICAÇÃO OPEN DATA KIT - ONGAWA

3. PREPARAÇÃO DISPOSITIVO ANDROID O seguinte passo é preparar o dispositivo para utilizá-lo na recolha de informação. Para isso é preciso seguir 4 passos: 1. Descarregar a aplicação na Google Play: https://play.google.com/store/apps/details?id=org.odk.collect.android 2. Transferir o arquivo.xml na pasta odk/forms do cartão SD do dispositivo (quando instalarmos o ODK Collect esta pasta é criada automáticamente). 3. Configurar no ODK Collect do terminal os parâmetros da Google App Engine na opção Configurações da Plataforma de ODK Collect no dispositivo. A App Engine criada tem os seguintes dados: URL://waterpointongawa2.appspot.com Nome de Usuário: ongawa Password: ongawa Ilustração14: Configuração do dispositivo Android com os dados do servidor. ONGAWA - MANUAL PARA A APLICAÇÃO OPEN DATA KIT 17

4. Ir ao menú principal de ODK, seleccionar Preencher Novo Formulário. Quando estejam os formulários preenchidos na sua totalidade podem-se enviar ao servidor online (App Engine) e verão-se neste link: http://waterpointongawa2.appspot.com Ilustração 15: Exemplos das perguntas do formulário carregado na aplicação do dispositivo Android. Ilustração16: Quando finalizarmos, se ainda fica algum dado por preencher NÃO se marca o formulario como finalizado, e será armazenado automáticamente na tab Editar Formulário Guardado. Ilustração 17: Quando tenha-se finalizado o formulário, marcase a janela Marcar formulário como finalizado e armazenará-se automáticamente em Enviar Formulário Finalizado. Uma vez marcada esta tab não pode-se editar de novo o formulário. 18 MANUAL PARA A APLICAÇÃO OPEN DATA KIT - ONGAWA

4. VISUALIZAÇÃO EM ODK AGGREGATE CARREGAR OS FORMULÁRIOS À INSTANCIA DE APP ENGINE Este é o último passo antes de começar a recopilação de dados no terreno. A interface de ODK Aggregate tem 3 tabs principais: Submissions (Envíos), Form Management (Gestão de formulários) e Site Admin (Administrador do campo ). Para carregar formulários: 1. Aceder a http://waterpointongawa2.appspot.com 2. Clicar na tab Form Management (Gestão de formulários) Ilustração18: Carregar formulários na App Engine. 3. Seleccionar o formulario (en.xml) que quer-se carregar no servidor e clicar em Upload (Carregar)). 4. Se o formulário tem-se carregado corretamente, é preciso fechar a janela Upload Forms (carregar formulários). Os formulários aparecerão agora na tab Form Management (Gestão de formulários) e o servidor aceitará os envios feitos desde ODK Collect no dispositivo Android. ONGAWA - MANUAL PARA A APLICAÇÃO OPEN DATA KIT 19

Quando estiverem os formulários enviados, aparecem da seguinte forma (ver ilustração 19). Se tiver sido carregado mais de um modelo de formulário, é preciso escolher na tab Form (em vermelho) o formulário que precisemos. Desde aqui podem-se visualizar e exportar dados clicando nas tabs correspondentes. (Estão asinaladas em vermelho na seguinte ilustração). Ilustração 19: Interfacetab Submissions da App Engine. 20 MANUAL PARA A APLICAÇÃO OPEN DATA KIT - ONGAWA

5. DESCARREGAMENTO DE FORMULÁRIOS NO ODK BRIEFCASE Desde o ODK Aggregate podem-se exportar os resultados a um arquivo em formato.csv mas este facto causa problemas de compatibilidade em alguns tipos de campos como datas, coordenadas, imagens, etc. Para solucionar o problema recomenda-se o uso de ODK Briefcase. Para a sua utilização o primeiro passo é fazer a descarga do ODK Briefcase e instalá-lo no computador: https://opendatakit.org/downloads/download-category/briefcase É preciso ter JAVA JRE 1.7 instalado no computador: https://java.com/en/download/ CONFIGURAÇÃO DE ODK BRIEFCASE 1. Abrir o ODK Briefcase. 2. Escolher o diretório dentro do computador onde serão armazenados os dados tratados no ODK Briefcase. Neste diretório, ODK Briefcase, criará automáticamente uma pasta nomeada ODK Briefcase Storage. ONGAWA - MANUAL PARA A APLICAÇÃO OPEN DATA KIT 21

EXTRAÇÃO DOS RESULTADOS DOS FORMULÁRIOS DESDE O SERVIDOR 1. No ODK Briefcase, ir a tab Pull. 2. Clicar na flecha situada à dereita de Pull data from: e escolher Aggregate 1.0 3. Clicar no botão Connect para inserir as configurações do nosso servidor. 4. Introduzir os dados do servidor, neste caso: URL://waterpointongawa2.appspot.com Nome de Usuário: ongawa Password: ongawa 5. Clicar no botão Connect para conectar com o servidor e ver a lista com os formulários disponíveis. 22 MANUAL PARA A APLICAÇÃO OPEN DATA KIT - ONGAWA

6. Selecionar o formulário do qual querermos obter os resultados e clicar em Pull, na parte de abaixo da ecrã. 7. Esperar até aparecer a messagem SUCCESS na applicação. (Isto pode demorar uns minutos se estão a serem carregados muitos formulários). 8. Agora os dados estão já no ODK Briefcase Storage dentro do PC. O arquivo de armazenamento está no formato.xml pelo que o seguinte passo é exportá-lo a.csv ONGAWA - MANUAL PARA A APLICAÇÃO OPEN DATA KIT 23

EXPORTAR DESDE.XML A.CSV DESDE ODK BRIEFCASE 1. Ir à tab Export no ODK Briefcase. 2. Expandir a barra de Form e escolher o formulário a converter em.csv 3. No Export Directory escolher a pasta onde serão armazenados os arquivos exportados. Recomenda-se criar uma pasta com o nome output no mesmo directório no qual tenha sido criada a ODK Briefcase Storage. 24 MANUAL PARA A APLICAÇÃO OPEN DATA KIT - ONGAWA

4. Clicar em Export na parte de abaixo à dereita. 5. Aparecerá a messagem SUCCEEDED! 6. Os dados exportados estarão na pasta de ODK Output. ONGAWA - MANUAL PARA A APLICAÇÃO OPEN DATA KIT 25

Recomendações Antes de exportar os dados de.xml a.csv quando o ODK Briefcase é usado, recomenda-se mudar a configuração de Região no Painel de Controle. Na tab Formatos > Congifuração Adicional > Escolher como Símbolo decimal o ponto (. ) e como Símbolo de separação de milhares a vírgula (, ). Se tiver problemas de compatibilidade de caracteres ao pasar os resultadosde.xml a.csv (por exemplo, não reconoce a ç, nem os acentos,...) para mudar a codificação há uma ferramenta na página de ODK que permite a transformação de.csv à codificação que seja selecionada (ODK CsvConverter v1.4.5 Production.jar). Antes de passar os dados a uma Base de Dados, por exemplo, Access, é preciso elaborar uma planilha Excel com os títulos ( headings ) da tabela da BDD e copiar abaixo dos títulos os dados da planilha.csv obtidos. Se aoenviar os formulários a partir do telefone aparece o seguinte erro: Bad Request (400) at https://waterpointongawa2.appspot.com/submissi on?deviceid=imei% A356899060287211 Pode ser por: > Problema com a configuração do servidor no telephone, às vezes por padrão vem https:// e o servidor usa http://. > Problemas com a Internet. Com um mau sinal de wifi não funciona bem, pelo que é recomendado o uso de dados móveis. 26 MANUAL PARA A APLICAÇÃO OPEN DATA KIT - ONGAWA

Bibliografía https://opendatakit.org/ https://www.google.es/intl/es/earth/outreach/tutorials/odk_gettingstarted.html http://www.ongawa.org/compromiso-y-desarrollo/tic-para-el-desarrollo-humano/ http://odk.acf-e.org/odk/linkeddocuments/annex%2012%20a%20odk%20 ACF-E%20ODK%20Briefcase%20INTERNET.pdf ONGAWA - MANUAL PARA A APLICAÇÃO OPEN DATA KIT 27

Esta guia é parte do projeto que ONGAWA esta a realizar em Manhiça (Moçambique) para melhorar o acesso a água e ao saneamento a traves do fortalecimento da gestão municipal e da concertação de agentes públicos e privados. O projeto integra-se no programa Compromisso e Desenvolvimento de ONGAWA que conta com o financiamento da Agência Espanhola de Cooperação Internacional para o Desenvolvimento (AECID) e da Agência de Extremadura de Cooperação Internacional para o Desenvolvimento (AEXCID). Com financiamento do: