Especificacion de Casos de Uso: Acceder a Servicios Web

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: Acceder a Servicios
Web Geográficos
Versión 1.0
Geoportal IDECAN
Especificacion de Casos de Uso: Acceder a Servicios Web Geograficos
Versión:
<1.0>
Fecha: <22/04/08>
Historial de Revisiones
Fecha
22/Abr/2008
Versión
1.0
Descripción
Creación del Documento
<IGAC – CIAF – ICDE>
Autor
Luis Fernando Ortiz
Reyes
2
Geoportal IDECAN
Especificacion de Casos de Uso: Acceder a Servicios Web Geograficos
Versión:
<1.0>
Fecha: <22/04/08>
Tabla de Contenido
1.
2.
3.
4.
5.
6.
Nombre del Caso de Uso
4
1.1
4
Descripción Breve
Flujo de Eventos
4
2.1
2.2
4
6
6
6
Flujo Básico
Flujos Alternativos
2.2.1 Errores en las peticiones vía navegador
2.2.2 Acceso a los servicios por medio de un cliente
Requerimientos especiales
6
3.1
6
Tiempo de Respuesta
Precondiciones
6
4.1
4.2
4.3
4.4
6
6
6
6
Servicios web WFS y WMS configurados
Disponibilidad del cliente
Disponibilidad del Geoportal de la IDECAN
Disponibilidad del Visor de Mapas
Postcondiciones
7
5.1
5.2
7
7
Resultados del acceso a los servicios web geográficos
Mensajes de Confirmación
Puntos de Extensión
7
6.1
6.2
7
7
Acceder al Servicio WFS
Acceder Servicio WMS
<IGAC – CIAF – ICDE>
3
Geoportal IDECAN
Especificacion de Casos de Uso: Acceder a Servicios Web Geograficos
Versión:
<1.0>
Fecha: <22/04/08>
Especificación de Casos de Uso: Acceder a Servicios
Web Geográficos
1.
Nombre del Caso de Uso
1.1
Descripción Breve
El Usuario desea acceder a los servicios web geográficos WFS y WMS. Puede hacerlo por distintos
medios:



Por peticiones por medio de un navegador.
Por medio de un cliente.
Por medio del Visor de Mapas del Geoportal de la IDECAN.
2.
Flujo de Eventos
2.1
Flujo Básico
1.
Peticiones vía navegador
1.1. El usuario accede directamente a su navegador de internet (Internet Explorer o Mozilla Firefox), y allí
en la barra de direcciones proporciona la url con la petición al servicio deseado.
Existen distintos tipos de petición, dependiendo del servicio web solicitado.
Peticiones soportadas servicio WFS:
DescribeFeatureType
GetCapabilities
GetFeature
GetFeatureWithLock
GetGMLObject
LockFeature
Peticiones soportadas servicio WMS:
GetCapabilities
GetMap
GetFeatureInfo
GetLegendGraphic
1.2. El usuario observa en pantalla los resultados de la petición que ha ejecutado, si se trata de la petición
de una imagen, o descarga el archivo que ha solicitado con información geográfica.
<IGAC – CIAF – ICDE>
4
Geoportal IDECAN
Especificacion de Casos de Uso: Acceder a Servicios Web Geograficos
2.
Versión:
<1.0>
Fecha: <22/04/08>
Acceso por medio de un cliente
2.1. El usuario accede al cliente de su preferencia. Para este caso, se ha escogido gvSIG como cliente de
prueba para los servicios web, así que este flujo de eventos no es estándar, dependiendo del cliente
escogido, aunque los parámetros en general son los mismos a tener en cuenta.
2.2. Una vez iniciado, gvSIG mostrará la pantalla de inicio. Allí el Usuario selecciona en el Gestor de
Proyectos la opción Vista, y hace clic en el botón Nuevo.
2.3. Esto desplegará una nueva Vista que se podrá configurar, para tener acceso a los servicios web. El
Usuario hace clic en el botón de Propiedades para configurar las propiedades de la Vista.
2.4. El Usuario tiene acceso a configurar las propiedades de Nombre de la Vista, Propietario, Unidades del
Mapa, Unidades de Medida, Proyección Actual, Comentarios, Color de fondo.
2.5. Una vez configurada la vista, el Usuario la selecciona y hace clic en el botón Abrir, para desplegar la
Vista vacía.
2.6. El Usuario puede añadir a la Vista una capa desde diferentes opciones, seleccionando en el menú
VistaAñadir capa, o directamente desde el botón Añadir Capa de la barra de herramientas de gvSIG.
2.7. Las opciones para añadir una capa son:
Archivo: Desde un archivo local (shape, imagen, KML, DGN, DWG, DXF).
GeoBD: Haciendo referencia a una ubicación de una base de datos
Georeferenciación.
Anotación.
WMS.
WCS.
ArcIMS.
WFS.
El Usuario puede seleccionar la pestaña de alguno de los servicios soportados (WMS o WFS).
2.8. El Usuario se conecta a alguno de los servicios soportados.
2.9. gvSIG despliega las capas geográficas especificadas.
3.
Acceso a los servicios por medio del Visor de Mapas del Geoportal de la IDECAN:
3.1. El Usuario accede vía internet al Geoportal de la IDECAN.
3.2. Selecciona el vínculo al Visor de Mapas.
3.3. El geoportal despliega el Visor de Mapas.
3.4. El Visor viene configurado consumiendo los servicios WFS y WMS.
3.5. El Usuario puede seleccionar la opción Ver Capas (activa por defecto), para ver las capas que ofrece el
<IGAC – CIAF – ICDE>
5
Geoportal IDECAN
Especificacion de Casos de Uso: Acceder a Servicios Web Geograficos
Versión:
<1.0>
Fecha: <22/04/08>
servicio WMS.
3.6. El Usuario puede seleccionar las capas geográficas que desea visualizar dentro de la Lista de Capas.
Existen unas capas que se ven por defecto.
3.7. El Usuario puede seleccionar la opción Ver Leyenda, para ver la simbología de las capas
seleccionadas.
3.8. El Usuario puede seleccionar alguna funcionalidad del visor, que se apoyará en peticiones de tipo WFS
y WMS.
3.9. Las funcionalidades del Visor de Mapas son descritas en otro caso de uso.
2.2
Flujos Alternativos
2.2.1
Errores en las peticiones vía navegador
1.1.a. Existen distintos parámetros para la configuración de una petición por navegador. Para ello lo mejor
es ver la especificación OGC del servicio WFS y del servicio WMS. Sin embargo, se cometen errores
frecuentes en estas peticiones. Dependiendo del servicio, esto será especificado en el caso de uso
correspondiente al acceso a cada uno de estos servicios.
2.2.2
Acceso a los servicios por medio de un cliente
2.8.a. El acceso al servicio WFS será especificado en el caso de uso correspondiente.
2.8.b. El acceso al servicio WMS será especificado en el caso de uso correspondiente.
3.
Requerimientos especiales
3.1
Tiempo de Respuesta
Por cualquier medio de acceso a los servicios web geográficos, el tiempo de respuesta del contenedor de
servlets (Tomcat) debe ser rápido (dentro de 2 segundos). Sin embargo, esto depende también de las
capacidades del equipo desde donde se acceda a los servicios (memoria RAM, procesador, etc.).
4.
Precondiciones
4.1
Servicios web WFS y WMS configurados
Los servicios web WFS y WMS deben haber sido configurados previamente por el Administrador.
4.2
Disponibilidad del cliente
Para el acceso a los servicios mediante un cliente, éste debe estar previamente instalado en el equipo desde
el cual se va a acceder a los mismos.
4.3
Disponibilidad del Geoportal de la IDECAN
Para el acceso a los servicios por medio del Visor de Mapas, el Geoportal de la IDECAN debe estar
disponible, además de que el Usuario debe tener conexión a Internet.
4.4
Disponibilidad del Visor de Mapas
Se debe garantizar la disponibilidad del Visor de Mapas para garantizar a su vez el acceso a los servicios
web por este medio.
<IGAC – CIAF – ICDE>
6
Geoportal IDECAN
Especificacion de Casos de Uso: Acceder a Servicios Web Geograficos
Versión:
<1.0>
Fecha: <22/04/08>
5.
Postcondiciones
5.1
Resultados del acceso a los servicios web geográficos
Si se ha realizado exitosamente el acceso a los servicios web, y se ha seguido el flujo básico de eventos (y
como complemento, los del acceso a cada servicio de forma individual), estos servicios WFS y WMS
podrán ser consumidos por los diferentes medios que se han mencionado, y el Usuario podrá tomar los
productos que necesita de ellos, de tipo gráfico (mapas generados mediante las configuraciones
personalizadas), o de tipo informativo (información de los servicios cargados).
5.2
Mensajes de Confirmación
Los principales mensajes de confirmación son los resultados obtenidos. Si las capas de información no se
pueden cargar o las peticiones no responden, simplemente los resultados (en el formato requerido) no serán
desplegados.
6.
Puntos de Extensión
Existen dos puntos de extensión de este caso de uso: Acceder al Servicio WFS y Acceder al Servicio WMS.
6.1
Acceder al Servicio WFS
Este punto de extensión describe el acceso específico al servicio WFS. Es descrito en otro caso de uso.
6.2
Acceder Servicio WMS
Este punto de extensión describe el acceso específico al servicio WMS. Es descrito en otro caso de uso.
<IGAC – CIAF – ICDE>
7