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ú VistaAñ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