GENERACION DE
FORMULARIOS EN LA
PLATAFORMA ONA PARA
SU USO EN APLICACIONES
ANDROID CON ESTRUCTURA
APTA PARA ODK
Una estructura para la recolección y
administración de los datos digitales usado
por la Veeduría Waorani para registrar
presiones y amenazas ambientales
Financiado por Socios
1
EcoCiencia es una organización sin fines de lucro establecida en Quito en 1989. Su misión es la de
conservar la diversidad biológica mediante la investigación científica, la recuperación del conocimiento
tradicional y la educación ambiental, impulsando formas de vida armoniosas entre el ser humano y la
naturaleza. EcoCiencia ha trabajado en proyectos en los que la conservación de la biodiversidad ha estado
guiada no solo por principios científico-ecológicos, sino también por aquellos ligados a la educación
ambiental y la participación efectiva de los actores locales. Específicamente lo ha hecho en la zona del
Parque Nacional Yasuní y el Territorio Étnico Waorani desde principios de la década de 1990.
Elaborado por: Cristina Aguilar
Revisado por: Sylvia Villacís
Rodrigo Torres
Javier Vargas
Editado por: Patricio Mena Vásconez
Fotografías: Ana María Acosta.
Diseño gráfico: Aquattro
Por favor cite este documento así:
EcoCiencia. 2020. Generación de formularios en la plataforma ONA para su uso en aplicaciones ANDROID
con estructura apta para ODK. Quito: EcoCiencia/NAWE/ AMWAE.
ISBN: 978-9942-946-08-9
Este documento se ha realizado con la ayuda financiera de la Unión Europea. El contenido de este
documento es responsabilidad exclusiva de EcoCiencia y en modo alguno debe considerarse que
refleja la posición de la Unión Europea.
La presente publicación ha sido financiada por el Fondo Flamenco para el Bosque Tropical,
administrado por BOS+ tropen vzw bajo tutela y por orden de la Agencia para Naturaleza y Bosque
(ANB) del Ministerio para Medio Ambiente, Naturaleza y Energía de la Comunidad Flamenca. Las
opiniones aquí presentadas no reflejan necesariamente ni la posición del Ministerio de la Comunidad
Flamenca, ni las de BOS+ tropen.
2
Contenidos
1 GENERALIDADES DE LAS PLATAFORMAS Y APLICACIONES 4
1.1 Introducción 4
1.2 Open Data Kit (ODK) 4
1.3 ONA 5
2 GENERACIÓN DE FORMULARIOS ODK 6
2.1 XLSForm 6
2.1.1 Hoja de trabajo survey (encuesta) 6
2.1.2 Hoja de trabajo choices (opciones) 7
2.1.3 Hoja de trabajo settings (configuración) 7
2.2 Tipo de preguntas usadas 8
3 CREACIÓN DE FORMULARIOS EN PLATAFORMA PARA
PROCESAMIENTO DE DATOS (ONA) 14
3.1 Acceso a plataforma ONA 14
3.2 Creación del proyecto 15
3.3 Agregar formulario 18
4 CONFIGURACIÓN DE CELULAR PARA ACCEDER A LOS FORMULARIOS EN ODK 21
4.1 Descargar la aplicación ODK 21
4.2 Configuración de ODK en el celular 21
5 MANEJO DE FORMULARIOS DESDE EL CELULAR 23
5.1 Llenar formularios 23
5.2 Editar un formulario guardado 24
5.3 Enviar formularios 25
5.4 Borrar formularios 26
6 DESCARGA DE DATOS DESDE LA PLATAFORMA ONA 27
7 FUENTES DE INFORMACIÓN 31
3
1 GENERALIDADES DE
LAS PLATAFORMAS Y
APLICACIONES
1.1 Introducción
Este manual presenta la estructura para la recolección y administración de los datos digitales
usado por la Veeduría Waorani para registrar presiones y amenazas ambientales, y la manera de
usar esta herramienta.
Primero se presentan generalidades sobre las herramientas tecnológicas que se emplean y lue-
go se entra a las particularidades de su uso en el caso de la Veeduría Waorani.
1.2 Open Data Kit (ODK)
ODK es un kit de datos abiertos por sus siglas en inglés (Open
Data Kit), creado por programadores afines al open source (código
abierto) que desarrollan en el entorno de Google. Reúne varios
kits, software o aplicaciones de acceso libre y asequible para
todo público que tratan de usar reglas y sentencias fáciles de
generar para obtener datos en campo con el uso de equipos
móviles que usen el sistema operativo Android creado por
Google (OPEN DATA KIT, 2017) (no funciona en equipos con
sistema operativo iOS iPhone).
La comunidad que genera información, software y
aplicaciones ha creado una aplicación de libre acceso llamada
ODK Collect, la cual está disponible en el Play Store (aplicación
donde se pueden buscar y descargar aplicaciones para el
sistema operativo Android). La aplicación fue escogida
porque brinda facilidades de uso en la programación y
4
generación de formularios. Estos formularios pueden ser llenados por los diferentes usuarios
que participen en los proyectos de recolección de información de EcoCiencia.
1.3 ONA
La plataforma ONA es un sitio web para construir infraestructuras de datos y para proveer su
almacenamiento en la nube; se enlaza directamente con los servicios del ODK y los formularios
llenados en los equipos móviles. Así, interactúa en una plataforma que permite la creación de
usuarios que pueden o no editar la información según los permisos brindados por el administrador
del proyecto (ONA, 2020).
La plataforma ONA, además de su gratuidad, interactúa de manera fácil y acertada con la
aplicación de ODK, lo que permite que los datos recolectados en los formularios en campo
puedan ser subidos mediante Internet a la nube y que estos puedan ser visualizados,
editados, eliminados o aceptados por el personal de gabinete encargado de su depuración
y posterior manejo.
5
2 GENERACION DE
FORMULARIOS ODK
2.1 XLSForm
Un XLSform es un formato estándar creado para ayudar a simplificar la creación de formularios
en Microsoft Excel.
El formato básico de cada libro de Excel debe tener tres hojas de trabajo:
Survey (Encuesta) Choices (Opciones) Settings (Configuración)
2.1.1 Hoja de trabajo survey (encuesta)
Esta hoja de cálculo da al formulario la estructura general y contiene la mayor parte de su infor-
mación. Contiene la lista completa de preguntas e información sobre cómo deben aparecer en
el formulario y como la información va agrupada para su fácil manejo.
La hoja de trabajo survey (encuesta) tiene tres columnas obligatorias:
type (tipo): especifica el tipo de pregunta.
name (nombre): especifica el nombre de la variable, el vcual es único (no deberá repetirse). Los
nombres deben comenzar con letras minúsculas, dígitos, guiones, guiones bajos y puntos. No
deberán usarse tildes, ñ u otros caracteres especiales. Las palabras deberán separarse por guio-
nes bajos.
label (etiqueta): contiene el texto que se visualizará en el formulario una vez que este se haya
cargado en el dispositivo móvil.
6
Se pueden tener más columnas según las necesidades y la complejidad de los formularios crea-
dos; estos deben mantener los títulos y estructuras obligatorias que requiere el ODK para que
puedan ser leídos por la aplicación y por el ONA.
2.1.2 Hoja de trabajo choices (opciones)
Esta hoja de trabajo se utiliza para especificar las opciones de respuesta para las preguntas de
opción múltiple.
La hoja de trabajo choices (opciones) tiene tres columnas obligatorias:
list_name (lista de nombres): permite agrupar un conjunto de opciones de respuesta relaciona-
das, es decir, opciones de respuesta que deberían aparecer juntas en una pregunta.
name (nombre): especifica el nombre de la variable, el cual es único (no deberá repetirse). Los
nombres deben comenzar con letras minúsculas, dígitos, guiones, guiones bajos y puntos. No
deberán usarse tildes, ñ u otros caracteres especiales. Las palabras deberán separarse por guio-
nes bajos.
label (etiqueta): contiene el texto que se visualizará en el formulario una vez que se haya carga-
do en el dispositivo móvil.
2.1.3 Hoja de trabajo settings (configuración)
La hoja de configuración es opcional, pero permite personalizar aún más el formulario.
Los encabezados de columna de la hoja de trabajo settings que han sido utilizados son:
form_title: el título del formulario que se muestra a los usuarios.
form_id: el nombre utilizado para identificar de forma única el formulario en el servidor; no pue-
den existir o cargarse dos formularios con un mismo form_id.
7
2.2 Tipo de preguntas usadas
Tipo de pregunta Respuesta de entrada
Decimal Decimal
Text Respuesta de texto libre
select_one [options] Pregunta de opción múltiple; solo se puede seleccionar una respuesta
Para las preguntas de opción múltiple, las encuestas a menudo inclu-
Text yen una opción de marcar otras cuando su opción de respuesta no
*Especificar otro* está en la lista. Entonces, generalmente se les pide que especifiquen la
otra opción
Geopoint Recoge una sola coordenada GPS
Image Toma una fotografía o sube un archivo de imagen
Nombre columnas extras Descripción
Hints Agregar sugerencias
Required Agregar pregunta como obligatoria
Metadatos Descripción
Start Fecha y hora de inicio de la encuesta
End Fecha y hora de finalización de la encuesta
Today Día de la encuesta
Deviceid IMEI (Identidad Internacional de Equipos Móviles)
• Metadatos
En Excel
8
• select_one [options] (pregunta de opción múltiple; solo se puede seleccionar una respuesta)
En Excel
Hoja survey Hoja choices
En celular
9
• Especificar otro
En Excel
Hoja Survey Hoja Choices
En celular
10
• text (Respuesta de texto libre) En celular
En Excel
En celular
• decimal (Decimal)
En Excel
• select_one [options] (pregunta de opción múltiple; solo se puede seleccionar una respuesta)
En Excel
Hoja Survey Hoja Choices
11
En celular
• image (toma una fotografía o sube un archivo de imagen)
En celular
En Excel
En celular
• geopoint (recoge una sola coordenada GPS)
En Excel
12
En celular
• text (respuesta de texto libre)
En Excel
• image (toma una fotografía o sube un archivo de imagen) En celular
En Excel
• text (respuesta de texto libre)
En celular
En Excel
13
3 CREACION DE
FORMULARIOS EN
PLATAFORMA PARA
PROCESAMIENTO DE DATOS
(ONA)
Para cargar un formulario en la plataforma se debe contar con permisos de administrador, los
cuales son otorgados únicamente por el dueño del proyecto (en este caso, EcoCiencia).
El administrador del proyecto puede asignar los permisos a sus diferentes usuarios a través de
correos electrónicos, donde puede controlar si el usuario puede visualizar, editar, borrar o crear
formularios según sean sus competencias en el proyecto.
3.1 Acceso a plataforma ONA
Para efectos de ejemplificar se ha creado una cuenta de correo electrónico para los usuarios
waorani que participaron en el curso de formación de la OPIAC (Organización Nacional de los
Pueblos Indígenas de la Amazonia Colombiana), desarrollado en el año 2019; así mismo, se otor-
garon permisos de solo visualización en la plataforma ONA.
Para ingresar y trabajar en la plataforma ONA, se hace lo siguiente:
14
Se ingresa al sitio web https://ona.io/login
3.2 Creación del proyecto
Hacer clic en New Project
Escribir el nombre del proyecto en Project Name
15
Seleccionar la categoría del proyecto
Seleccionar Create New Project
16
Hacer clic en Private, para que el proyecto sea privado
Hacer clic en Done
Hacer clic en el proyecto creado para abrirlo
17
3.3 Agregar formulario
Hacer clic en Add a form
Hacer clic en Choose file to upload
Seleccionar el archivo que del formulario que se desea subir
Hacer clic en Abrir
18
Seleccionar Upload Selected File
Seleccionar Save form
19
De existir algún problema con el formulario, en esta etapa se desplegarán advertencias. Si el for-
mulario está bien, la ficha quedará ya subida en la plataforma y estará disponible para descarga
y uso en el celular.
La forma quedará guardada
20
4 CONFIGURACION DEL
CELULAR PARA ACCEDER
A LOS FORMULARIOS EN
ODK
4.1 Descargar la aplicación ODK
En el celular desde Google Play descargar:
ODK Collect
ODK Counter
4.2 Configuración de ODK en el celular
Entrar a la App ODK Collect
ODK Collect
Una vez en el menú principal, seguir los siguientes pasos para la configuración de ODK en el
celular:
Presionar los 3 Seleccionar Seleccionar Se podrá visualizar la
puntos de la parte Cambiar Servidor-Usuario pantalla de Configuración
superior derecha configuración del Servidor
21
En Nombre de Usuario
En URL del Servidor Seleccionar Nombre
Seleccionar URL escribir uno de los
escribir: https://ona.io de Usuario
usuarios miembros
En contraseña, digitar la Una vez realizada la Esperar a que se
Seleccionar configuración, volver al conecte con el
contraseña del usuario
Contraseña menú principal servidor
respectivo
Seleccionar el o Hacer clic en
los formularios a De acuerdo
utilizar
22
5 MANEJO DE
FORMULARIOS DESDE
EL CELULAR
5.1 Llenar formularios
En el Menú Principal, Seleccionar el Llenar el formulario y hacer clic en guardar luego
seleccionar Llenar formulario que se va de cada pregunta. (Para pasar a la siguiente pregunta
Nuevo Formulario a llenar se debe deslizar el dedo en la pantalla)
Llenar el formulario y hacer clic en guardar luego de cada pregunta
23
Llenar el formulario y hacer clic en guardar luego de cada pregunta (para pasar a la siguiente
pregunta se debe deslizar el dedo en la pantalla)
Llenar el formulario y hacer clic en guardar Una vez llenado el formulario, seleccionar
luego de cada pregunta. (Para pasar a la Guardar Formulario y Salir
siguiente pregunta se debe deslizar el dedo en
la pantalla)
5.2 Editar un formulario guardado
En el Menú Principal, Seleccionar el Seleccionar la
seleccionar Editar formulario guardado pregunta que se Editar la pregunta
Formulario que se desea editar desea editar
24
Una vez corregida la pregunta, ir hasta la
última pantalla del formulario y seleccionar
Guardar Formulario y Salir
5.3 Enviar formularios
En el Menú Principal, Seleccionar el formulario Esperar a que el o Luego de enviarse
seleccionar Enviar que se desea enviar los formularios se presionar en
formulario Finalizado y Hacer clic en Enviar envíen De acuerdo
seleccionado
25
5.4 Borrar formularios
En el Menú Principal,
seleccionar Borrar Si se desea borrar uno o varios formularios guardados…
Formularios Guardados
Si se desea borrar uno o varios formularios vacíos…
26
6 DESCARGA DE DATOS
DESDE LA PLATAFORMA
ONA
Una vez que los formularios hayan sido enviados, se podrán descargar los datos recolectados
desde la plataforma ONA siguiendo estos pasos:
Ingresar a ONA
Con los mismos datos de usuario y contraseña que se utilizaron para la creación del formulario
se ingresa a la plataforma.
Hacer clic en el proyecto Escuela de Formación OPIAC
27
Hacer clic en la forma de la que se deseen descargar los datos
• Una vez dentro de la forma seleccionada se podrá visualizar cuántos formularios cargados
hay, hace cuantos días se subió el último formulario y cuántos contribuidores hay.
• Para visualizar los datos directamente desde la plataforma, seguir los siguientes pasos:
Hacer clic en Table
28
A continuación, los datos podrán ser visualizados.
• Para descargar los datos, seguir los siguientes pasos:
Hacer clic en Overview
Hacer clic en Prepare Data Export
Hacer clic en para despegar los tipos de formatos en los que se puede descargar los datos
29
Seleccionar el formato para descargar los datos
Hacer clic en Export Excel file
Hacer clic en el vínculo generado, el cual permite la descarga de un archivo
Abrir el archivo generado
• Al abrir el archivo descargado, se podrán visualizar los datos.
30
7 FUENTES DE
INFORMACION
XLSForm en ODK
ONA. (01 de 01 de 2020). ona.io. Obtenido de https://ona.io/features.html
OPEN DATA KIT. (2017). XLSForm.org. Obtenido de http://xlsform.org/en/#the-survey-worksheet
OpenDataKit. (01 de 01 de 2020). opendatakit.org. Obtenido de https://docs.opendatakit.org/
31
32
33
San Ignacio E12 - 143 y Humboldt
Correo electrónico: [email protected]
Quito - Ecuador
www.ecociencia.org
Financiado por Socios
34
