Page 1

Manual de administrador herramienta madre QueRutas

MANUAL DE ADMINISTRADOR HERRAMIENTA MADRE QUERUTAS - HERRAMIENTA PARA RUTAS TEMÁTICAS MEDIANTE APP MÓVIL, CÓDIGOS QR Y VISOR WEB

Manual de Administrador

agresta

gestión técnica ambiental y desarrollo rural

1


Manual de administrador herramienta madre QueRutas

ÍNDICE

Contenido 1.

PLATAFORMA QUERUTAS ................................................................... 3

2.

HERRAMIENTA MADRE ....................................................................... 4 2.1

LISTADO DE PRODUCTOS GENERADOS ............................................................... 5

2.1.1.

Descargar aplicación Android ...................................................................... 5

2.1.2.

Eliminar hijo .............................................................................................. 6

2.1.3.

Visitar herramienta web del hijo .................................................................. 6

2.2

GENERAR NUEVO PRODUCTO HIJO..................................................................... 7

2.2.1

Paso 1 – Nombre del proyecto y nombre de la base de datos......................... 7

2.2.2

Paso 2 – Subida del archivo shape de rutas .................................................. 8

2.2.3

Paso 3 – Subida del archivo shape de puntos de interés ...............................10

2.2.4

Paso 4 – Importar iconos para los puntos de interés ....................................11

2.2.5

Paso 5 – Usuario y contraseña del administrador del proyecto hijo ................11

2.2.6

Paso 6 – Importar imágenes de las rutas.....................................................12

2.2.7

Paso 7 – Importar imágenes de los puntos de interés...................................13

2.2.8

Paso 8 – Personalizar aplicación móvil.........................................................14

2.2.9

Paso 9 – Identificar la zona cartográfica de la aplicación móvil ......................14

2.2.10

He completado todos los pasos, ¿Qué es lo siguiente?..................................15

2.3

ICONOS DE PUNTOS DE INTERÉS ......................................................................17

2.4

MÓDULO DE USUARIOS ....................................................................................18

agresta

gestión técnica ambiental y desarrollo rural

2


Manual de administrador herramienta madre QueRutas

PLATAFORMA QUERUTAS

1.

La plataforma QueRutas es una herramienta que nos permite generar aplicaciones turísticas. QueRutas está formado por 3 elementos principales: -

Una herramienta que será utilizada por el personal de Agresta y que servirá para generar las distintas aplicaciones turísticas contratadas por los clientes. Esta herramienta será accesible vía web y recibe el nombre de herramienta madre.

-

Un portal web genérico diseñado para ser replicado por la herramienta madre. Este portal web es uno de los productos que se entregan al cliente. El portal web funciona como un pequeño gestor de contenidos (Wordpress, Joomla, Drupal etc.). Dispone de una parte back accesible vía usuario y contraseña y una parte frontal o pública. Desde la parte back o administrador podemos definir el aspecto que damos a la parte pública (es decir, a la parte que visualizan los usuarios de Internet). Esta herramienta toma el nombre de herramienta hijo-web. A diferencia de la aplicación madre, la parte administrador de hijo-web ha sido diseñada para ser utilizada por cualquier usuario (no solo por el personal de Agresta).

-

Una aplicación genérica para dispositivos móviles desarrollada con el framework Titanium Appcelerator. Las ventajas de utilizar este framework frente al código nativo es la de poder generar ejecutables para distintas plataformas a través del mismo código: Android, IOs, Blackberry… Este es el segundo producto que recibe el cliente al contratar QueRutas. La aplicación móvil recibe el nombre herramienta hijo-móvil.

De esta forma, Agresta dispone de una herramienta web de fácil manejo que permite generar con unos pocos clicks un portal web listo para ser utilizado y una aplicación móvil para distintas plataformas.

agresta

gestión técnica ambiental y desarrollo rural

3


Manual de administrador herramienta madre QueRutas

2.

HERRAMIENTA MADRE

La herramienta madre es accesible a través del siguiente enlace url: http://querutas.agresta.org/ La aplicación utiliza variables de sesión para guardar la sesión del usuario, si accedemos sin habernos identificado o si nuestra sesión ha caducado, será necesario que proporcionemos nombre de usuario y contraseña para acceder:

Imagen 1: Acceso a la herramienta madre

El panel de administración dispone de pocos botones y elementos lo que lo convierte en una herramienta bastante sencilla e intuitiva. Dispone a priori de un listado general de productos generados, de una herramienta para generar nuevos productos y de un listado de iconos disponibles para los mapas utilizados en la aplicación móvil y web.

Imagen 2: Panel de administración de la herramienta madre

Accedemos a cada opción a través de la barra de navegación disponible en la parte superior:

Imagen 3: Barra de navegación de la herramienta madre

agresta

gestión técnica ambiental y desarrollo rural

4


Manual de administrador herramienta madre QueRutas

2.1

LISTADO DE PRODUCTOS GENERADOS

Tal y como se observa en la imagen 3, la barra de navegación de la herramienta madre dispone de 3 opciones. La primera de ellas, Inicio, nos permite administrar el total de productos generados (hijos creados). La aplicación muestra en formato de lista los diferentes hijos creados hasta la fecha y permite realizar 3 operaciones básicas sobre cada uno de ellos: -

Descargar la aplicación Android (herramienta hijo-móvil).

-

Visitar la aplicación web (herramienta hijo-web).

-

Eliminar hijo.

Para el ejemplo siguiente, nuestra herramienta madre dispone de un total de dos hijos creados. Reciben el nombre de agresta y tenerife respectivamente. Se observa las 3 opciones descritas para cada uno de los hijos:

Imagen 4: Listado de productos generados

2.1.1.

Descargar aplicación Android

Cuando terminamos el proceso de crear un nuevo hijo (un producto para un cliente específico), podemos proceder a descargar el ejecutable Android que nos permitirá instalar la aplicación Titanium sobre terminales Android.

Imagen 5: Descargar aplicación Titanium

Este proceso iniciará una descarga de un archivo con extensión .apk a nuestro equipo. Este archivo .apk puede ser añadido a tiendas de software online como Google Play1 o Aptoide. A su vez, los dispositivos Android permiten instalar aplicaciones de orígenes desconocidos2.

1

Ver manual de como subir aplicaciones a Google Play.

2

Necesario activar esta opción desde el menú de ajustes de nuestro terminal.

agresta

gestión técnica ambiental y desarrollo rural

5


Manual de administrador herramienta madre QueRutas

2.1.2.

Eliminar hijo

Podemos eliminar un producto hijo. Esta operación elimina del servidor de Agresta el portal web y el proyecto Titanium asociado. Una vez eliminado un proyecto, no podremos volver a recuperarlo.

Imagen 6: Eliminar producto

2.1.3.

Visitar herramienta web del hijo

Podemos acceder a la parte pública de la herramienta web de cualquier hijo haciendo click sobre este elemento. El proceso abre una nueva pestaña en nuestro navegador.

Imagen 7: Visitar herramienta web del hijo

agresta

gestión técnica ambiental y desarrollo rural

6


Manual de administrador herramienta madre QueRutas

2.2

GENERAR NUEVO PRODUCTO HIJO

El proceso de generar un nuevo hijo (portal web y aplicación Titanium asociada) funciona a modo de tutorial o asistente guiado. Está compuesto por 8 pasos a través de los cuales podemos ir dando forma al producto final. El tiempo estimado para completar los 8 pasos es inferior a 2 minutos. La aplicación solo permite generar un proyecto hijo de una vez, de forma que si abandonamos el proceso antes de finalizar los 8 pasos, la herramienta se encarga de eliminar cualquier rastro del proyecto en el sistema. Una vez creado un proyecto hijo, el menú de visualización de productos (descrito en el punto anterior) mostrará una tupla para el mismo. A continuación se describe paso a paso como crear un nuevo proyecto.

2.2.1 Paso 1 – Nombre del proyecto y nombre de la base de datos En el paso 1 debemos especificar el nombre que damos al proyecto y el nombre de la base de datos asociado al mismo. El sistema gestor de bases de datos que utilizamos en QueRutas es Postgresql (con extensión GIS PostGIS). Cuando asignamos un nombre de proyecto y de base de datos, el sistema busca en nuestro servidor web y servidor Postgres si ya existe un proyecto con el mismo nombre. En caso afirmativo, se nos mostrará un mensaje informativo:

Imagen 8: Nombre de proyecto en uso

Imagen 9: Nombre de la base de datos en uso

agresta

gestión técnica ambiental y desarrollo rural

7


Manual de administrador herramienta madre QueRutas

Por otro lado, solo podemos utilizar caracteres, espacios, barras bajas, guiones u otro tipo de caracteres no están permitidos. La aplicación nos avisa en caso de detectar algún carácter no apropiado:

Imagen 10: Validación de caracteres en el paso 1

Una vez seleccionemos un par de nombres válidos, se creara automáticamente una nueva base de datos y un nuevo directorio para nuestro nuevo producto. A medida que avanzamos en el tutorial vamos customizando ambos productos.

2.2.2 Paso 2 – Subida del archivo shape de rutas El segundo paso nos permite subir un shape conteniendo las rutas a visualizar en la aplicación Titanium y en el mapa interactivo del portal web.

Imagen 11: Subida del archivo shape de rutas

agresta

gestión técnica ambiental y desarrollo rural

8


Manual de administrador herramienta madre QueRutas

El shape debe debe mantener una estructura de tipos de datos y columnas concreta, en caso contrario, el sistema nos avisará con un mensaje informativo de que el shape no se ha podido importar. Cuando subimos un shape, el sistema genera en la base de datos Postgres y Sqlite del cliente una tabla conteniendo toda la información sobre las rutas (bases de datos para las aplicaciones web y Titanium respectivamente). Un archivo shape lo forman una serie de ficheros. La forma de subirlos al servidor es empaquetándolos en un archivo comprimido .zip. De igual modo, si intentamos subir cualquier otro tipo de archivo, el sistema nos mostrará un mensaje de error. Algunos ejemplos:

Imagen 12: Subida del archivo shape de rutas. Tipo de archivo no compatible.

Imagen 13: Subida del archivo shape de rutas. Formato de shape incorrecto.

A continuación se describe la estructura que debemos utilizar para poder importar las rutas: -

Nombre [texto 100 carácteres de longitud]

-

Descripcio [texto 254 carácteres de longitud]

-

TipoRuta [texto 100 carácteres de longitud]

-

Longitud [double]

-

Duración [número entero]

-

Dificultad [texto 50 carácteres]

-

Observ [texto 254 carácteres]

-

Foto [texto 50 carácteres]

-

Simbolo [texto 50 carácteres]

-

Grosor [número entero]

-

Coordenadas geográficas WGS 84

agresta

gestión técnica ambiental y desarrollo rural

9


Manual de administrador herramienta madre QueRutas

2.2.3 Paso 3 – Subida del archivo shape de puntos de interés El tercer paso nos permite importar en nuestras bases de datos Sqlite y Postgres un shape conteniendo puntos de interés. Al igual que en el caso anterior, este shape debe mantener una estructura de datos y columnas concreta, en caso contrario, el sistema nos avisa con un mensaje de error. Al igual que en el caso anterior, los ficheros que forman el shape deben subirse comprimidos en un archivo con extensión .zip:

Imagen 14: Subida del archivo shape de puntos de interés.

A continuación se describe la estructura y tipos de datos que debemos utilizar en el shape: -

Nombre [texto 100 carácteres]

-

Descripcio [texto 254 carácteres]

-

Tipo [texto 100 carácteres]

-

Acceso [texto 254 carácteres]

-

X [double]

-

Y [double]

-

Observ [texto 254 carácteres]

-

Foto [texto 50 carácteres]

-

Simbolo [texto 50 carácteres]

-

Coordenadas geográficas WGS 84

agresta

gestión técnica ambiental y desarrollo rural

10


Manual de administrador herramienta madre QueRutas

2.2.4 Paso 4 – Importar iconos para los puntos de interés En el cuarto paso se nos solicita subir un archivo .zip conteniendo las imágenes de los puntos de interés especificados en el shape de puntos.

Imagen 15: Subida del archivo shape de puntos de interés.

2.2.5 Paso 5 – Usuario y contraseña del administrador del proyecto hijo En el paso 4 debemos especificar algunos campos asociados al administrador del portal web hijo (recordamos que el portal web o herramienta web-hija está dividido en 2 partes: Una parte pública visible a cualquier usuario de la red y una parte privada accesible vía usuario y contraseña que permite administrar la parte pública). En este paso solicitamos al usuario los siguientes datos: -

Nombre de usuario (necesario para poder iniciar sesión en el panel de administrador).

-

Dirección de correo electrónico (necesario para recuperar contraseña en el panel de administrador así como para recibir otro tipo de avisos por correo electrónico).

-

Contraseña (necesario para poder iniciar sesión en el panel de administrador).

El sistema nos mostrará con un mensaje de error si alguno de los campos introducidos no es correcto: Falta rellenar algún campo, dirección de e-mail no válida, contraseñas diferentes, longitud de las contraseñas demasiado corta o larga etc.

agresta

gestión técnica ambiental y desarrollo rural

11


Manual de administrador herramienta madre QueRutas

Imagen 16: Usuario y contraseña del panel de administración del proyecto web hijo.

2.2.6 Paso 6 – Importar imágenes de las rutas En el paso 2 se solicita un archivo .zip (shape) que contiene toda la información de las rutas turísticas. Se recuerda que uno de los campos necesarios en el shape es Foto (tipo de dato texto con una longitud de 50 caracteres). En el paso 5 debemos subir un archivo .zip conteniendo las fotos indicadas en el shape de las rutas. El usuario de la herramienta madre es responsable de que los nombres de las fotos indicados en el shape de rutas importado en el paso 2 y los nombres de las fotos incluidas en el archivo .zip subido en el paso 5 sean coherentes. El sistema permite subir un archivo .zip al servidor conteniendo imágenes, las reduce a un tamaño mínimo aceptable para la aplicación y las adjunta en las aplicaciones web y móvil. Así pues, y a modo de ejemplo, vamos a suponer que el shape de rutas importado en el paso 2 ha generado la siguiente tabla de rutas en nuestra base de datos Postgres:

Imagen 17: Importar imágenes de rutas al servidor.

agresta

gestión técnica ambiental y desarrollo rural

12


Manual de administrador herramienta madre QueRutas

Se observa que de las 10 rutas visibles, 5 de ellas tienen asociada una imagen. La columna de imágenes o fotos esta resaltada en rojo. En el paso 5, el archivo .zip que se nos solicita subir debería contener únicamente 5 imágenes con estos mismos nombres de archivo.

Imagen 18: Importar imágenes de rutas al servidor II.

El sistema se encarga de reducir el tamaño de las imágenes a un tamaño óptimo para las aplicaciones Titanium y web. En cualquier caso, tal y como se ha explicado, es responsabilidad del usuario importar las imágenes correctas.

Imagen 19: Importar imágenes de rutas al servidor III.

2.2.7 Paso 7 – Importar imágenes de los puntos de interés El paso 6 funciona exactamente igual que el paso 5 pero en este caso el archivo .zip que solicitado debe incluir las imágenes de los puntos de interés. Al igual que en el caso anterior, deberían incluirse solo los archivos de imagen indicados en el shape de puntos de interés.

agresta

gestión técnica ambiental y desarrollo rural

13


Manual de administrador herramienta madre QueRutas

2.2.8 Paso 8 – Personalizar aplicación móvil El paso 7 nos permite personalizar la apariencia de nuestra aplicación móvil. Para ello, disponemos de 3 opciones: -

Nombre de la aplicación móvil

-

Icono de la aplicación móvil

-

Icono de carga de la aplicación móvil

El nombre es un campo obligatorio, las imágenes por el contrario no lo son. La aplicación base lleva asociados un icono y una imagen de carga de la plataforma QueRutas de forma que no es necesario que utilicemos un icono e imagen de carga específicos para cada nuevo producto.

Imagen 20: Personalizando la aplicación móvil.

2.2.9 Paso 9 – Identificar la zona cartográfica de la aplicación móvil La aplicación móvil está diseñada para funcionar en modo off-line. Al utilizar tecnología web, los tiles o mapas suelen ser cargados por defecto a través de la red (en el caso de los dispositivos móviles, a través de wifi o conexión 3G). Para permitir a la aplicación funcionar en modo offline, se deben descargar los mapas o archivos tiles y ser precargados en local. D especificar el área geográfica y el nivel de zoom deseado. Se debe tener en cuenta que cuanto mayor sea el área geográfica y el nivel de zoom utilizado, mayor será el tamaño final de la aplicación. Lo ideal es encontrar una relación calidad/tamaño a la hora de descargar los tiles.

agresta

gestión técnica ambiental y desarrollo rural

14


Manual de administrador herramienta madre QueRutas

El paso 8 permite seleccionar un área geográfica sobre el mapa e indicar los niveles de zoom deseados. El mapa visualizado muestra las líneas y puntos importados en los pasos 2 y 3, de forma que resulta más sencillo seleccionar un área que incluya toda la zona geográfica sobre la que van a trabajar los usuarios. Sobre el zoom, deben especificarse un par de valores comprendidos entre 1 y 18 (siendo 1 el nivel de zoom más alejado y 18 el nivel de zoom más cercano a la superficie). Los niveles 17 y 18 solo son recomendables para zonas urbanas. Por ejemplo, para campo sería suficiente con asignar un nivel de zoom 3:15. Los tiles de niveles de zoom más cercano al 18 son los que más tamaño ocupan.

Imagen 21: Descarga de tiles.

2.2.10 He completado todos los pasos, ¿Qué es lo siguiente? Una vez completados todos los pasos, la aplicación nos redirecciona al panel inicial de la herramienta madre (a la lista de proyectos). El paso 8 descarga los tiles seleccionados y empaqueta la aplicación en un archivo .apk para poder ser lanzada desde terminales Android o subirla a tiendas online como Google Play. El proceso de descarga de los tiles y el empaquetado del .apk puede llevar algún tiempo (depende de la máquina, el número de tiles a descargar etc). Este proceso se realiza en background o segundo plano y avisa al usuario enviándole un e-mail a la cuenta de correo proporcionada en el paso 4. Mientras la aplicación Android está siendo empaquetada y los tiles descargados, el panel inicial muestra para el proyecto correspondiente el mensaje 'Generando aplicación. Te enviaremos un e-mail cuando esté terminada'.

agresta

gestión técnica ambiental y desarrollo rural

15


Manual de administrador herramienta madre QueRutas

Imagen 22: Empaquetando aplicación Android

El sistema no notifica que nuestra aplicación móvil esta lista a través de un correo electrónico:

Imagen 23: Aviso por correo electrónico

agresta

gestión técnica ambiental y desarrollo rural

16


Manual de administrador herramienta madre QueRutas

2.3

ICONOS DE PUNTOS DE INTERÉS

El tercer elemento de la barra de navegación muestra una serie de enlaces donde poder descargar gratuitamente algunos iconos para nuestros puntos de interés. Los nombres de los iconos deben utilizarse en el shape de puntos de interés a importar en el paso 3. De esta forma podemos indicar para cada tipo de punto de interés el icono asociado. Las aplicaciones web y móvil muestran para cada tipo de punto de interés el icono asociado. Es responsabilidad del usuario de la herramienta madre asignar correctamente las imágenes de los puntos de interés a cada tipo de punto. A modo de ejemplo, vamos a suponer que se importa un shape de puntos de interés que contiene 30 puntos, 10 de los cuales son de tipo Iglesia. Es responsabilidad de la persona que utiliza la herramienta madre asignar a las 10 iglesias el mismo icono (de forma que la aplicación sea coherente). El icono se asigna en el campo símbolo. Un ejemplo incorrecto de la tabla puntos sería el siguiente:

Imagen 24: Inconsistencia entre tipos de puntos e iconos asociados

En la imagen superior podemos ver que de los 14 puntos visualizados, 9 de ellos son de tipo Ermita y 5 de ellos de tipo Recreativo. Sin embargo, el icono utilizado para todos ellos es el 10 (se utiliza el mismo icono para distintos tipos de puntos de interés). El sistema no detecta este comportamiento y el resultado sobre el mapa de los usuarios es el siguiente:

Imagen 25: Inconsistencia entre tipos de puntos e iconos asociados II

Mismo tipo de icono para distintos tipos de puntos de interés. Mapa confuso y pérdida de usabilidad. Es responsabilidad del usuario de la herramienta madre evitar este comportamiento.

agresta

gestión técnica ambiental y desarrollo rural

17


Manual de administrador herramienta madre QueRutas

2.4

MÓDULO DE USUARIOS

El cuarto elemento de la barra de navegación permite gestionar los diferentes usuarios que tienen acceso a la herramienta madre. Existen dos tipos de usuarios: El usuario administrador y el usuario normal.

EL módulo está dividido en 3 apartados: -

Gestión de mi cuenta

-

Gestión de otros usuarios

-

Crear nuevos usuarios

La segunda y tercera opción solo están disponibles para usuarios administradores. Los usuarios administradores no pueden crearse directamente desde la interfaz de QueRutas, deben ser creados por el personal técnico de la herramienta. Un usuario normal (no administrador) solo puede gestionar sus datos, no podrá en ningún caso añadir o eliminar otros usuarios.

Imagen 26: Módulo de Usuarios

agresta

gestión técnica ambiental y desarrollo rural

18

Manual de administrador madre  
Read more
Read more
Similar to
Popular now
Just for you