1. Nombre del Caso de Uso - Instituto Geográfico Agustín Codazzi

INSTITUTO GEOGRÁFICO AGUSTÍN CODAZZI
S E D E
C E N T R A L
Centro de Investigación y Desarrollo en Información Geográfica - Oficina CIAF
Infraestructura Colombiana de Datos Espaciales - ICDE
Grupo Geoportales y Geoservicios
Geoportal de la IDECAN
Especificación de Casos de Uso: Configurar Interfaz
de Usuario Visor de Mapas
Versión 1.0
Geoportal IDECAN
Especificacion de Casos de Uso: Configurar base de datos
Versión:
<1.0>
Fecha: <16/04/08>
Historial de Revisiones
Fecha
16/Abr/2008
Versión
1.0
Descripción
Creación del Documento
<IGAC – CIAF – ICDE>, 2008
Autor
Luis Fernando Ortiz
Reyes
2
Geoportal IDECAN
Especificacion de Casos de Uso: Configurar base de datos
Versión:
<1.0>
Fecha: <16/04/08>
Tabla de Contenido
1.
2.
Nombre del Caso de Uso
4
1.1
4
Descripción Breve
Flujo de Eventos
2.1
2.2
Flujo Básico
Flujos Alternativos
2.2.1 PostgreSQL+PostGIS no han sido configurados
2.2.2 No ha sido configurada la variable de entorno para PostgreSQL
2.2.3 Acceso a los servidores de bases de datos
2.2.4 Parámetros de la base de datos
2.2.5 Errores en la carga de archivos a la base de datos
2.2.6 Automatización del proceso de carga de archivos
3.
Requerimientos especiales
4.
Precondiciones
4.1.
4.2.
5.
6.
4
4
7
7
7
7
7
Error! Bookmark not defined.
Error! Bookmark not defined.
8
8
Tener los archivos geográficos .shp
Instalación y configuración previa de PostgreSQL+PostGIS
Error! Bookmark not defined.
8
Postcondiciones
8
5.1
8
Conexión exitosa con la base de datos
Puntos de Extensión
8
6.1
6.2
8
8
Generar Mapa Regional Andino
Cargar capas del Mapa Andino en la base de datos de PostgreSQL
<IGAC – CIAF – ICDE>, 2008
3
Geoportal IDECAN
Especificacion de Casos de Uso: Configurar base de datos
Versión:
<1.0>
Fecha: <16/04/08>
Especificación de Casos de Uso: Configurar Interfaz
de Usuario Visor de Mapas
1.
Nombre del Caso de Uso
1.1 Descripción Breve
El Administrador desea configurar la interfaz de usuario del Visor de Mapas del Geoportal de la IDECAN.
Para ello tiene en cuenta los siguientes elementos del cliente estándar IDE iGeoPortal ofrecido por
deegree, y base de este desarrollo.
2.
Flujo de Eventos
2.1 Flujo Básico
1.
El Administrador tiene en cuenta el modelo base del cliente IDE iGeoPortal de deegree, para poder llevar a
cabo la personalización de sus componentes, según las necesidades de la IDECAN.
2.
Se observa entonces la siguiente estructura de directorios del Visor de Mapas:
Los archivos de configuración del Visor de Mapas se encuentran en el directorio raíz “visorGidecan/WEBINF/”; estos son archivos XML creados para detallar funcionalidades específicas del mismo.
3.
El Administrador procede a configurar el archivo WEB.xml. Este archivo de configuración realiza el
llamado de los servicios de Java que son necesarios para el desarrollo del Visor de Mapas; entre ellos está
el llamado a la maquina virtual de java y el llamado a los servlets. Es parte de la inicialización del servlet
del cliente: recibe unos parámetros de inicialización que tienen que ser definidos en el descriptor de
despliegue ($visorGidecan_home$/WEB-INF/web.xml). El componente del cliente IDEAM del lado del
servidor está representado por el servlet RequestHandler. El servlet RequestHandler (perteneciente a la
clase control) recibe dos parámetros de inicialización (<init-param>):
<IGAC – CIAF – ICDE>, 2008
4
Geoportal IDECAN
Especificacion de Casos de Uso: Configurar base de datos
Versión:
<1.0>
Fecha: <16/04/08>

4.
Handler.configFile: es un documento XML en el que una clase java responsable y la consiguiente
página JSP / HTML se definen para cada evento que sea activado por el cliente y enviado al
servidor.
 MapContext.configFile: es un documento donde el estado y el diseño del Visor de Mapas se
definen en su inicialización. El documento cumple con el esquema XML definido por la
especificación OGC Web MapContext. El MapContext definido en el web.xml se utilizará por
defecto.
El Administrador procede a configurar el archivo de contexto MapContext, en donde se realizará el
llamado a las capas geográficas de los Servicios Web Geográficos. El elemento raíz de cada archivo de
configuración MapContext es <ViewContext>. Este contiene la definición de los espacios de nombres y
dos elementos hijos, <General> y <LayerList>. El elemento <General> contiene las definiciones del
tamaño del mapa y del extent (extensión geográfica del mapa). Además contiene información de contacto y
descripción del contenido cliente IDEAM. Esta es la información que se almacena en el elemento
<General>:
 Tamaño de la ventana del mapa en pixeles (<Window>)
 Extent geográfico del mapa, incluyendo el sistema de referencia de coordenadas que va a ser
usado (<BoundingBox>)
 Nombre del mapa/portal context (<Title>)
 Lista opcional de palabras clave que describen el mapa/postal context (<KeywordList>)
 Descripción opcional del mapa/postal context (<DescriptionURL>)
 Información de contacto (<ContactInformation>)
 Extensiones usadas por el cliente
Este archivo se divide en varias partes. Aparte de las obligatorias u opcionales, es posible utilizar elementos
llamados <Extension> para definir los elementos específicos de otros proveedores. El contenido del
elemento <Extension> se define como <xs:any> por lo que la única restricción es que tiene que ser un
fragmento de XML bien formado. La estructura general del archivo es:
MAPCONTEXT
GENERAL
LAYERLIST
INFORMACIÓN
EXTENSIÓN
EXTENSIÓN
EXTENSIÓN
GENERAL
IOSETTINGS
FRONTEND
MAPPARAMETER
LAYER
El Administrador debe configurar entonces los siguientes parámetros:
<IGAC – CIAF – ICDE>, 2008
5
Geoportal IDECAN
Especificacion de Casos de Uso: Configurar base de datos
Versión:
<1.0>
Fecha: <16/04/08>
4.1. Extensión IOSettings
El elemento <IOSettings > describe algunos directorios, donde el Visor de Mapas almacena archivos, como
archivos de impresión. Si se cambia la configuración de uno de los archivos de contexto o se define unos
propios, se debe tener en cuenta que la definición de <PrintDirectory> y <TempDirectory> es obligatoria.
Si algunos o todos los otros directorios de definiciones están desaparecidos, deegree utilizará el
<TempDirectory> en su lugar.
4.2. Extensión Frontend
El elemento definido en el elemento <Extension> asociado al diseño es el elemento <Frontend>. Se utiliza
para definir la interfaz gráfica de usuario, así como otro sistema de parámetros específicos, no vistos por el
usuario final. La idea del Visor de Mapas es encapsular diferentes funcionalidades en módulos separados.
Estos módulos de trabajo son lo más independiente posible uno del otro a pesar que todos ellos utilizan la
misma interfaz. Así por ejemplo, el mapa, su leyenda, o la lista de capas geográficas son todos realizados
por módulos separados. Cada módulo se puede localizar en cualquier parte del diseño del cliente, con
excepción del parámetro mapview. Por lo tanto, es decisión del Administrador qué funciones va a ofrecer a
los usuarios. Cada módulo está compuesto de una página HTML y uno o varios objetos JavaScript que
pueden ser incluidos página misma o se encuentran en su propio archivo. Con el fin de permitir al
Administrador influir en el diseño del cliente, a continuación se presenta la distribución de áreas y módulos
definidos en el Visor de Mapas del Geoportal de la IDECAN.
HEADER
NORTH
WEST
EAST
CENTER
SOUTH
FOOTER
Cada una de las áreas (marcadas en rojo) tiene asociado uno o más módulos (marcados en amarillo) en
donde se pueden cargar diferentes funcionalidades. La zona de pie de página se ha dejado reservada para
poner los diferentes logos asociados a los interesados. Nota: La disposición de los componentes puede
variar, según los requerimientos de diseño. Esta es solo una primera aproximación, que permite verlos por
completo.
4.3. Extensión MapParameter
<IGAC – CIAF – ICDE>, 2008
6
Geoportal IDECAN
Especificacion de Casos de Uso: Configurar base de datos
Versión:
<1.0>
Fecha: <16/04/08>
Después de la descripción del Frontend, algunos parámetros describen el comportamiento del mapa en
general. Esta sección define el formato de la petición GetFeatureInfo, el factor de zoom, el factor del paneo,
y la escala mínima y máxima permitido en la vista del mapa en general.
4.4. Lista de Capas
Después de la definición general del diseño y de haber registrado las funciones del Visor de Mapas, el
Administrador configura la definición de las capas disponibles y sus fuentes, de acuerdo a la especificación
de OGC Web Map Context. Toda la información específica se encuentra encapsulada dentro del elemento
<LayerList>. Un <LayerList> contiene cualquier cantidad de elementos <Layer>. La secuencia de las capas
en el elemento <LayerList> describe la secuencia como se visualizaran las mismas. Por debajo de todo tipo
de elementos de la especificación Web Map Context, se extiende un elemento <Extension> que puede
definir cualquier otra característica. El Visor de Mapas utiliza algunas extensiones para describir los
recursos de los datos. Cada elemento layer contiene dos atributos para determinar si la petición
GetFeatureInfo es posible o si la capa es visible desde el inicio. El primer elemento <Server> describe que
servicio web entrega una capa específica. El elemento <Server> contiene el OnlineResource con la URL
del WMS. Después de definir el WMS, hay algunas definiciones que son bastante similares a las de un
documento resultado de un GetCapabilities de un WMS. Es importante, que las declaraciones sean
idénticas a las del Capabilities o, respectivamente, sean subconjuntos de ellas. Por medio del elemento
<DataService> el Visor de Mapas conoce de donde puede obtener los datos originales para descargarlos.
5.
El Administrador da por terminada la configuración del Visor de Mapas del Geoportal de la IDECAN,
basado en los requerimientos de los interesados.
2.2 Flujos Alternativos
2.2.1 PostgreSQL+PostGIS no han sido configurados
3.a. Este caso de uso sólo especifica la forma de cargar archivos .shp a la base de datos. El Administrador
cuenta con que el sistema manejador de bases de datos PostreSQL y el complemento para soporte de
objetos geográficos PostGIS han sido instalados y configurados previamente, por él mismo o por otro
miembro del equipo, que generalmente es un Desarrollador. En caso de no encontrarlos configurados, el
Administrador debe ponerse en contacto con el encargado de dicho proceso.
2.2.2
No ha sido configurada la variable de entorno para PostgreSQL
4.a. Si la variable de entorno no ha sido configurada, esto no es impedimento para la carga de los archivos a
la base de datos. Simplemente el Administrador debe ubicarse por medio de la consola de comandos en el
directorio de los binarios de PostgreSQL, y desde allí ejecutar la sentencia descrita en el numeral 15 del
flujo de eventos. Esta ruta es por lo general: “C:\Archivos de Programa\PostgreSQL\8.2\bin”.
2.2.3
Acceso a los servidores de bases de datos
8.a. En la configuración de PostgreSQL, puede haberse configurado una contraseña para proteger los
servidores de bases de datos. Si el Administrador hace clic en los servidores, PostgreSQL puede solicitarle
dicha contraseña, que ha sido asignada por la persona que ha instalado y configurado PostgreSQL. El
Administrador debe ponerse en contacto con esta persona para adquirir dicha contraseña.
2.2.4
Parámetros de la base de datos
12.3.a. El Administrador debe seleccionar un rol de usuario existente como propietario.
12.5.a. Existen otras plantillas, pero el Administrador debe seleccionar la plantilla template_postgis, ya que
es la única que brinda el soporte de objetos geográficos.
<IGAC – CIAF – ICDE>, 2008
7
Geoportal IDECAN
Especificacion de Casos de Uso: Configurar base de datos
3.
Versión:
<1.0>
Fecha: <16/04/08>
Requerimientos especiales
Ninguno
4.
Precondiciones
4.1. Servicios Web Geográficos configurados
Estos archivos deben ser proporcionados por cada país miembro de la CAN, y deben estar
acordes con el Modelo de Datos homologado, planteado en el caso de uso Generar Mapa
Regional Andino, basado en la Especificación Global Map versión 2.3.
4.2. Instalación y configuración previa de PostgreSQL+PostGIS
La instalación y configuración previa de estos componentes es fundamental para la creación de
la base de datos y la carga de archivos. PostgreSQL permite instalar PostGIS desde su
configuración de instalación, como un paquete adicional. Sin embargo, PostGIS también puede
ser instalado así no se haya especificado en la instalación de PostgreSQL, ya que posee un
instalador propio. Es importante tener en cuenta información como nombres de usuario y
contraseñas empleadas en la configuración.
5.
Postcondiciones
5.1 Conexión exitosa con la base de datos
Una vez el Administrador ha escogido un cliente, y si se han seguido los pasos descritos en el flujo de
eventos, la conexión a la base de datos para visualizar el Mapa Regional Andino será exitosa.
6.
Puntos de Extensión
Existe dos puntos de extensión asociados a este caso de uso: Generar Mapa Regional Andino y Cargar
capas del Mapa Andino en la base de datos de PostgreSQL.
6.1 Generar Mapa Regional Andino
6.2 Cargar capas del Mapa Andino en la base de datos de PostgreSQL
<IGAC – CIAF – ICDE>, 2008
8