O3 GIS - Cliente Web

Se describe cómo configurar O3 GIS para su uso mediante el Cliente Web, es decir, desde cualquier navegador Web.

La ejecución Web del componente GIS requiere un componente adicional llamado GeoServer (componente de código abierto y sin costo), por razones de licenciamiento este componente no puede ser distribuido junto con O3 y por lo tanto debe ser descargado e instalado de forma independiente.

En este componente deben declararse los layers del mapa que va a ser utilizados, de forma similar a como se declararon en el archivo XML de asociación.

Instalación de GeoServer

A continuación se presentan los pasos a seguir para instalar GeoServer:

Descargar war de GeoServer
1. Ir al sitio de GeoServer: http://geoserver.org
2. Ir a página de Downloads: http://geoserver.org/display/GEOS/Download
3. Ir a página de All Release: http://geoserver.org/display/GEOS/All+Releases
4. Seleccionar la versión a descargar (Testeada por IdeaSoft: GeoServer 2.0.0a).
5. Seleccionar el link Web Archive de la versión oficial (Stable) de GeoServer.
Instalación GeoServer en el directorio jboss/server/default/deploy/gserver/geoserver.war bajo la instalación de O3. Para esto es recomendable:
1. Detener el servidor de O3 si estaba en ejecución
2. Crear un directorio con nombre geoserver.war bajo jboss/server/default/deploy/gserver
3. Descomprimir el contenido del archivo geoserver-2.0.0a-war.zip en una carpeta temporal, entre los archivos descomprimidos se incluye geoserver.war.
4. Descomprimir el contenido de geoserver.war en la carpeta jboss/server/default/deploy/gserver/geoserver.war, puede ser necesario renombrar el archivo geoserver.war a geoserver.zip, para poder utilizar la herramienta de descompresión.

Configuración del mapa en GeoServer

Iniciar servidor JBoss de O3
Acceder a la url http://<host>:<port>/geoserver donde <host> y <port> corresponden al servidor y puerto de instalación de O3 respectivamente (por ejemplo http://localhost:8080/geoserver).
Logearse al sitio, ingresando como usuario/contraseña: admin/geoserver

Administración de usuarios y roles consulte el siguiente enlace:
http://docs.geoserver.org/latest/en/user/security/index.html
Configurar Espacios de Trabajo, Almacén de Datos y Estilos
1. Seleccionar el link Espacios de Trabajo, y luego el link Agregar un nuevo espacio de trabajo: Crear un Espacio de Trabajo con el Name o3 y URI http://<host>:<port>/o3portal donde <host> y <port> corresponden al servidor y puerto de instalación de O3 respectivamente.
  
  Atención
  
  En caso de que la URI del espacio de nombres sea correcta pero no válida para geoserver, sera necesario definir el espacio con otra URI, por ejemplo 'http://www.ideasoft.biz' y luego editarla con la URI anteriormente invalidada.
2. Seleccionar el link Almacenes de Datos, y luego el link Agregar nuevo almacénpara configurar los archivos shp (ShapeFiles)
  1. Elegir el valor 'Shapefile' en las opciones del campo Feature Data Set Description
  2. Seleccionar en Espacio de trabajo o3
  3. Ingresar el valor countries en el campo Nombre del origen de datos
  4. Ingresar en Parámetros de conexión la url donde está el archivo country.shp (por ej: file:data/worldcities/country.shp en caso que el archivo country.shp se encuentre ubicado en el directorio data/data/worldcities bajo el war de GeoServer). También pueden estar ubicados en otro directorio/carpeta, referenciados en una ubicación absoluta del filesystem, por ej. file:/Ideasoft/gis/country.shp).
3. Seleccionar el link Capas, y luego el link Agregar nuevo recurso
  1. Seleccionar nueva capa, indicando o3:countries en Agregar capa de
  2. Elegir el link de country
  3. Modificar country por countries
  4. En el campo SRS declarado, Buscar el valor 4326, elegirlo.
  5. Elegir el link Calcular desde los datos y luego Calcular desde el encuadre nativo
  6. Pasar a la etiqueta de Publicación y verificar que el Estilo por defecto sea polygon
  7. Hacer click en Guardar
4. Los 7 pasos anteriores fueron necesarios para configurar el shapefile del layer de countries; se deben ejecutar análogamente para configurar el shapefile del layer de WorldCities:
  1. Utilizar worldcities
  2. La ubicación de worldcities.shp
  3. worldcities como nombre y alias de la capa
5. Para confirmar que los mapas fueron configurados correctamente, lo puede comprobar en la opción de Previsualización de capas.

Configuración del mapa en O3

Se debe declarar la url interna del servidor para conexión con O3 Portal en el archivo GServer.properties (o custom), en la property gis.o3portal.url (por defecto el valor es http://localhost:8080/o3portal)