Manual de Desarrollo Visor de Mapas.doc - Instituto Geográfico ...

bossprettyingData Management

Nov 28, 2012 (4 years and 10 months ago)

847 views




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


Manual de
Desarrollo
del Visor de Mapas del
Geoportal de la IDECAN

Versió
n 1.0



Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


2


Historial de Revisiones

Fecha

Versión

Descripció
n

Aut
or

Marzo
28
,
2
008

1.0

Versión
Final

Luis Fernando Ortiz
Reyes














Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


3


Tabla de Contenido

1.

Introducción

5

2.

Alcance

5

3.

Base Tecnológica

5

3.1

PostgreSQL

5

3.2

PostGIS

5

3.3

Apache

5

3.4

Tomcat

5

3.5

deegree

6

4.

Instalación y Configuración del Visor de Mapas

6

4.1

Estructura de directorios

6

4.1.1

El archivo web.xml

7

4.1.2

El archivo mapcontext.xml

7

5.

Instalación y Configuración de los Servicios Web Geográficos

9

6.

Configuración de la Base de Datos

29

6.1

Creación y configuración de la Base de Datos en PostgreSQL

29

6.2

Generación del Mapa Regional Andino

35





























Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


4









TABLA DE FIGURAS


F
IGURA
1.

E
STRUCTURA DE DIRECTO
RIOS DEL
V
ISOR DE
M
APAS

................................
................................
.......................

6

F
IGURA
2.

E
STRUCTURA DEL ARCHIV
O MA
PCONTEXT
.
XML

................................
................................
................................
.

7

F
IGURA
3.

E
STRUCTURA DE LOS COM
PONENTES FRONTEND EN

LA INTERFAZ DE USUAR
IO DEL
V
ISOR DE
M
APAS

.................

8

F
IGURA
4.

E
STRUCT
URA GENERAL DE LOS S
ERVICIOS WEB GEOGRÁF
ICOS

................................
................................
..........

9

F
IGURA
5.

P
ANTALLA DE INICIO DE

P
OSTGRE
SQL

................................
................................
................................
..........

30

F
IGURA
6.

S
ERVICIOS DE
P
OSTGRE
SQL

................................
................................
................................
.........................

31

F
IGURA
7.

P
ARÁMETROS DE UNA NUE
VA BASE DE DATOS

................................
................................
................................
.

32

F
IGURA
8.

C
ONSOLA DE
W
INDOWS

................................
................................
................................
................................
.

33

F
IGURA
9.

S
ENTENCIA DE CÓDIGO P
ARA SUBIR UN ARCHIVO

DE EXTENSIÓN
.
SHP A LA BD

................................
.................

33

F
IGURA
10.

E
JECUCIÓN DE LA SENTE
NCIA DE CÓDIGO

................................
................................
................................
....

34

F
IGURA
11.

V
ERIFICACIÓN DE LA NU
EVA TABLA EN LA BD

................................
................................
...............................

35

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


5


Manual de
Desarrollo

del Visor de Mapas del
Geoportal de la IDECAN

1.

Introduc
ción

Este Manual de
Desarrollo

es una guía de referencia para los
usua
rios del Visor de Mapas del Geoportal de la
IDECAN que deseen saber cómo fue construido el Visor. Este manual
proporciona información sobre la instalación
de la base tecnológica, el
visor

y los servicios
w
eb
g
eográficos de

l
a

IDE
CAN
.


2.

Alcance

Este document
o pretende servir de una guía ágil para los usuarios del Visor de Mapas del Geoportal de la IDECAN
en el caso que se desee desarrollar un visor con características similares para otras finalidades.


3.

Base Tecnológica

La base tecnológica hace referencia a l
os componentes que se utilizan para la instalación, configuración y despliegue
del visor y de los Servicios Web Geográficos de la IDECAN.


3.1

PostgreSQL

PostgreSQL es un potente, sistema de bases de datos relacionales de código abierto. Cuenta con más de 15 a
ños de
desarrollo activo y una probada arquitectura que se ha ganado una sólida reputación de fiabilidad, integridad de
datos y corrección. Se ejecuta en todos los principales sistemas operativos, incluyendo Linux, UNIX (AIX, BSD,
HP
-
UX, SGI IRIX, Mac OS X
, Solaris, Tru64), y Windows. Es plenamente compatible con ACID, tiene soporte
para claves foráneas, uniones, vistas, disparadores y procedimientos almacenados (en varios idiomas). Incluye la
mayoría de SQL92 y tipos de datos SQL99, incluyendo INTEGER, NUM
ERIC, boolean, CHAR, VARCHAR,
DATE, INTERVAL, y TIMESTAMP. También apoya el almacenamiento de grandes objetos binarios, incluyendo
imágenes, sonidos o vídeo. Tiene interfaces de programación nativas para C / C + +, Java, .Net, Perl, Python, Ruby,
Tcl, ODBC
, entre otros, y documentación excepcional. PostgreSQL dispone de sofisticadas funciones como el
control de concurrencia Multi
-
Version de Control (MVCC), punto de recuperación, tablespaces, la replicación
asíncrona, las transacciones anidadas (savepoints).

Es altamente escalable, tanto en la enorme cantidad de datos que
puede manejar y en el número de usuarios concurrentes que puede acomodar.


3.2

PostGIS

PostGIS adiciona soporte espacial a la base de datos de PostgreSQL. PostGIS sigue la especificación de la O
GC
"
Simple Features Specification for SQL
" y está certificada que cumple con el perfil para “Tipos y Funciones”.


3.3

Apache

El servidor HTTP Apache es un software (libre) servidor HTTP de código abierto pa
ra plataformas Unix (BSD,
GNU/Linux, etc.), Windows, Macintosh y otras, que implementa el protocolo HTTP/1.1 y la noción de sitio virtual.
El servidor Apache se desarrolla dentro del proyecto HTTP Server (httpd) de la Apache Software Foundation.
Apache pre
senta entre otras características mensajes de error altamente configurables, bases de datos de
autenticación y negociado de contenido.


3.4

Tomcat

Tomcat (también llamado Jakarta Tomcat o Apache Tomcat) funciona como un contenedor de servlets desarrollado
bajo

el proyecto Jakarta en la Apache Software Foundation. Tomcat implementa las especificaciones de los servlets
y de JavaServer Pages (JSP) de Sun Microsystems. Tomcat puede funcionar como servidor Web por sí mismo. Dado
que Tomcat fue escrito en Java, funci
ona en cualquier sistema operativo que disponga de la máquina virtual Java.

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


6


3.5

d
eegree

Deegree es un Framework Java que ofrece los principales componentes para construir Infraestructuras de Datos
Espaciales. Toda esta arquitectura fue desarrollada usando está
ndares de la Open Geospatial Consortium (OGC) y el
Comité Técnico ISO 211


Información geográfica / Geoinformatica (ISO/TC 211). Deegree abarca los servicio
s

web OGC así como los clientes. Deegree es un software libre protegido por GNU LGPL y es accesibl
e a través de
www.deegree.org
.


4.

Instalación y Configuración del Visor de Mapas


El
Visor de Mapas

será entregado en un archivo llamado “
visorGidecan
.war”. Para desplegar este archivo será
necesario tener instalado un se
rvidor de aplicaciones, que en este caso será Apache Tomcat. El archivo
visorGidecan
.war deberá ser copiado en la carpeta
webapps

de Tomcat. Una vez puesto allí aparecerá una carpeta
con el mismo nombre del archivo en donde encontraremos todos los archivos

de configuración del
visor
.


Instalación del visor fuera de los directorios
:

Sólo se debe crear un nuevo documento XML (en $ TOMCAT_HOME $ / conf / Catalina / localhost),
si no desea
desplegar el visor

como un archivo .war en la carpeta webapps de Tomcat.


4.1

Estructura de directorios

La estructura de directorios de desarrollo para el
visor,

que se encuentra en el archivo
visorGidecan
.war es la
siguiente:



Figura
1
. Estructura de directorios del Visor de Mapas


Los archivos de conf
iguración del
Visor de Mapas

se encuentran en el directorio raíz “
visorGidecan/
WEB
-
INF
/

;

esto
s

son archivos XML creados para detallar funcionalidades espec
í
ficas del mismo.

Los directorios más
importantes en el árbol de directorios del cliente son:



css: D
irectorio que contiene el archivo
de estilo usado por el visor
.



images: en este directorio se almacenan las imágenes o banners usados en las platillas y en la interfa
z
grafica del visor
.



WEB
-
INF: directorio donde se encuentran los archivos XML de configura
ción del
visor
.


Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


7



4.1.1

El archivo web.xml

Este a
rchivo 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.

E
s 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
visor

del lado del servidor
está representad
o por el servlet RequestHandler.
El servlet RequestHandler (perteneciente a la clase control) recibe
dos parámetros de inicialización (<init
-
param>):



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 definid
o por la especificación OGC Web
MapContext. El MapContext definido en el web.xml se utilizará por defecto.

4.1.2

El archivo mapcontext.xml

En este archivo 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áf
ica del mapa). Además contiene información de contacto y
descripción del contenido
visor de mapas.

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 e
l 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 (<Descript
ionURL>)



Información de contacto (<ContactInformation>)



Extensiones usadas por el
visor

Este archivo se divide en varias partes. Aparte de las obligatorias u opcionales, es posible utilizar elementos
llamados <Extension> para definir los elementos específi
cos 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:


Figura
2
. Estru
ctura del archivo mapcontext.xml



Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


8


4.1.2.1

Extensión OISettings

El elemento <
O
I
Settings> 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
defi
ne 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.1.2.2

Extensión Fro
ntend

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 ge
ográ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
A
dministrador qu
é

funciones va a ofrecer a los usuarios.

Cada

módulo está compuesto de una
página HTML y uno

o varios

objeto
s

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
.


Figura
3
. Estructura de los componentes frontend en la interfaz de usuario del Visor de Mapas


Cada una de l
as á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
aproximación, que permite ver todos los componentes.



HEADER

NORTH

CENTER

WEST

EAST

SOUTH

FOOTER

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


9


4.1.2.3

Extensión MapParameter

Después de la descripción del Frontend, algunos parámetros describen el compor
tamiento 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.1.2.4

Lista de Capas

Después de la definición general del d
iseño y de haber registrado las funciones del
Visor de Mapas
,
el
Administrador configura

la definición de l
a
s
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 de
ntro del elemento <LayerList>. Un
<LayerList> contiene cualquier cantidad de elementos <Layer>.
La secuencia de la
s
capas

en el elemento
<LayerList> describe la s
ecuencia como se visualizaran la
s
mismas
. Por debajo de todo tipo de elementos de la
especific
ació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 s
i la petición
GetFeatureInfo es posible o si la capa es

visible desde el
inicio. El primer elemento <Server> describe que servicio web entrega un
a

capa

específi
ca
. El elemento <Server>
contiene el OnlineResource con la URL del WMS. Después de definir el WM
S, 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.

Instalación y
Configuración

de
los
Servicios Web Geográficos

El Administrador

desea configurar los ser
vicios web geográficos Web Feature
S
ervice

y W
eb Map
S
ervice

que
ofrecerá el
Visor de Mapas del Geoportal de la

IDECAN, basado en las plantillas respectivas de
l
framework

deegr
e
e
, que
se

ha
n

desplegado

previamente

en el contenedor de servlets Tomcat.

Dicho
s servicios están basados en
la especificación
OGC WFS Implementation Specification versión 1.1.0
, y
OGC WMS Implementation Specification
versión 1.1.1
, respectivamente.
La siguiente es la estructura general de los servicios web geográficos:



Figura
4
. Estructura general de los servicios web geográficos

1.

El Administrador

descarga las plantillas de deegree de su sitio web
,

de cada servicio web geográfico.

2.

Se deben colocar estas plantillas (archivos deegree
-
wfs.
war

y deegree
-
wms.w
ar) en el contenedor de
servlets Tomcat, dentro de la carpeta webapps, ubicada en la ruta:
Directorio de Instalación de Tomcat
(ej.: C:/Archivos de Programa/Apache Software Foundation/Tomcat 6.0) /webapps
.

3.

El Administrador

reinicia el

contenedor de servlet
s Tomcat.

4.

Automáticamente, Tomcat desplegará los archivos .war y se generarán unos directorios.

5.

El Administrador

toma los archivos de configuración de los servicios web geográficos, ubicados en la ruta:
Directorio de Instalación de Tomcat (ej.: C:/Archivos

de Programa/Apache Software
Foundation/Tomcat 6.0) /webapps
, y crea una nueva carpeta con lo necesario de las plantillas de deegree
(archivos deegree
-
wfs.war y deegree
-
wms.war desplegados en Tomcat) para configurar los servicios wfs y
wms, que para este c
aso será GIDECAN
-
OWS, construida y configurada con base en estándares OGC.
Esta
carpeta, según el estándar OGC y el contenido de las plantillas de los servicios WFS y WMS debe tener los
siguientes directorios, mostrados aquí por niveles (se mostrarán a fon
do sólo los niveles importantes en la
configuración):

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


10


1er nivel:



META
-
INF:
Su propósito es contener
meta información

sobre los archivos contenidos dentro del archivo
.war. Es generado por la plataforma Java para configurar aplicaciones, extensiones, ca
rgadores de clases y
servicios.
Contiene los archivos:



MANIFEST.MF
: C
on
tiene

información de quién ha creado el archivo
.
war, con qu
é

máquina
virtual de java

se ha construido, el nombre la aplicación y el número de versión.




context.xml
:

C
on
tiene

informaci
ón necesaria para inte
grar la aplicación en un Tomcat.

SLDImages:

Contiene las imágenes para la simbología utilizada en algunas capas con geometría de punto,
y otras imágenes solicitadas como referencia externa, según el estándar OGC Styled Layer Descript
or.

requestHandler.jsp:

Manejador de peticiones KVP o XML.

WEB
-
INF:

Contiene los directorios de información sobre los servicios web.

El siguiente nivel pertinente es el de los directorios contenidos en la carpeta WEB
-
INF.

2do nivel:


conf:

Contiene las
carpetas wfs y wms, con los archivos propios de su configuración.

lib:
Contiene todas las librerías necesarias para la ejecución de los servicios web (archivos .jar

propios de
deegree
)
.

web.xml:
Contiene la guía general de los parámetros de inicializació
n de los servicios web WFS y WMS,
que será interpretada por el contenedor de servlets.

A continuación se muestran los parámetros claves del archivo de configuración web.xml:

<?xml version="1.0" encoding="ISO
-
8859
-
1"?>

<!DOCTYPE web
-
app PUBLIC "
-
//Sun Micr
osystems, Inc.//DTD Web
Application 2.3//EN" "http://java.sun.com/dtd/web
-
app_2_3.dtd">

<web
-
app>

<!
-

Nombre de los servicios ofrecidos
--
>

<display
-
name>OGC
-
GIDECAN</display
-
name>

<!
-

Descripción
--
>

<description>Servicios web bajo especificaciones OGC para

el Geoportal
de la IDECAN</description>



<servlet>

<!

Controlador de servlets
--
>



<servlet
-
name>services</servlet
-
name>

<servlet
-
class>org.deegree.enterprise.servlet.OGCServletController</servlet
-
class>

<!
-

Parámetros del servlet
--
>

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


11


<init
-
param>

<!
-
-
Nombre del servlet
--
>




<param
-
name>services</param
-
name>

<!
--
Valores de los servicios del servlet
--
>




<param
-
value>wfs,wms</param
-
value>

<!
--
Descripción de los servicios
--
>




<description>Servicios soportados</description>



</init
-
param>

<!
--
Parámetros de inicialización del servicio WMS
--
>



<init
-
param>

<!
--
Nombre del manejador del servicio WMS
--
>




<param
-
name>wms.handler</param
-
name>

<!
--
Valor del manejador del servicio WMS
--
>



<param
-
value>org.deegree.enterprise.s
ervlet.WMSHandler</param
-
value>



</init
-
param>



<init
-
param>

<!
--
Nombre del parámetro de configuración del servicio WMS
--
>




<param
-
name>wms.config</param
-
name>

<!
--
Valor del archivo de configuración del servicio WMS
--
>




<param
-
value>WE
B
-
INF/conf/wms/wms_GIDECAN_configuration.xml</param
-
value>



</init
-
param>

<!
--
Pará
metros de inicialización del servicio WFS
--
>



<init
-
param>

<!
--
Nombre del manejador del servicio WFS
--
>




<param
-
name>wfs.handler</param
-
name>

<!
--
Valor del man
ejador del servicio WMS
--
>

<param
-
value>org.deegree.enterprise.servlet.WFSHandler</param
-
value>



</init
-
param>



<init
-
param>

<!
--
Nombre del parámetro de configuración del servicio WFS
--
>





<param
-
name>wfs.config</param
-
name>


<!
--
Valor del ar
chivo de configuración del servicio WFS
--
>




<param
-
value>WEB
-
INF/conf/wfs/wfs_GIDECAN_configuration.xml</param
-
value>



</init
-
param>




<load
-
on
-
startup>1</load
-
on
-
startup>



</servlet>

<!
-

Mapeo de Servlet
--
>

<servlet
-
mapping>

<!
--
Nombre del
servlet
--
>



<servlet
-
name>services</servlet
-
name>

<!
-

Parámetro url de direccionamiento a los servicios
--
>



<url
-
pattern>/GIDECANservicios</url
-
pattern>


</servlet
-
mapping>


<!

Archivos de bienvenida
--
>


<welcome
-
file
-
list>


<welcome
-
file>/in
dex.jsp</welcome
-
file>


</welcome
-
file
-
list>

<!
-

Pagina de errores
--
>



<error
-
page>



<error
-
code>500</error
-
code>



<location>/error.jsp</location>

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


12




</error
-
page>



<error
-
page>

<!

Control de excepciones
--
>

<exception
-
type>org.deegree.ogcw
ebservices.OGCWebServiceException</exception
-
type>



<location>/error.jsp</location>



</error
-
page>

</web
-
app>


El siguiente nivel pertinente es el de los directorios contenidos en la carpeta
conf
.

3er nivel:


El siguiente nivel pertinente es el de l
os directorios contenidos en la carpeta
wfs
.

4to nivel:


featuretypes:

Esta carpeta contiene los archivos XSD, que describen la información de la característica que
va a ser implementada en el mapa, es decir, la capa que va a ser añadida desde la base de
datos.

A continuación se muestran los parámetros claves del archivo de configuración
capadeinformación
.xsd (para este caso, el ejemplo se realiza con una capa de drenaje, tipo línea):

<?xml version="1.0" encoding="ISO
-
8859
-
1" ?>

<!
--
Dominio de nombres: ide
ntifica cada elemento wfs
--
>

<xsd:schema
xmlns:gidecanwfs=
http://www.gidecan.com/wfs


targetNamespace="http://www.gidecan.com/wfs"

xmlns:gml="http://www.opengis.net/gml"
xmlns="http://www.w3.org/2001/XMLSchema"
xm
lns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:deegreewfs="http://www.deegree.org/wfs"
xmlns:ogc="http://www.opengis.net/ogc" elementFormDefault="qualified"
attributeFormDefault="unqualified">

<import
namespace="
ttp://www.opengis.net/gml"
schemaLocation="http://schemas.ope
ngis.net/gml/3.1.1/base/feature.xsd"/>

<import
namespace="
ttp://www.opengis.net/gml"
schemaLocation="http://schemas.ope
ngis.net/gml/3.1.1/base/geometry
Aggregates.xsd"/>


<!
--
Configuración de la persistencia de los datos que serán usados
--
>


<xsd:annotation>



<xsd:appinfo>

<!
--
Prefijo para identificación de elementos wfs
--
>

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


13





<deegreewfs:Prefix>gidecanwfs</deegreewfs:Prefix>

<!
--
Manejador de Base de Dat
os
--
>




<deegreewfs:Backend>POSTGIS</deegreewfs:Backend>

<!

Sistema espacial de referencia SRS por defecto
--
>



<deegreewfs:DefaultSRS>EPSG:4326</deegreewfs:DefaultSRS>


<!
--
Gestor JDBC de la conexión a la Base de Datos
--
>




<JDBCConnection xmlns="http:/
/www.deegree.org/jdbc">

<!
--
Driver de conexión
--
>





<Driver>org.postgresql.Driver</Driver>

<!
--
Especificación del origen de los datos:
jdbc:postgresql://localhost, ip o nombre de equipo/nombre base de datos
--
>





<Url>jdbc:postgresql://172.17.120.214:5
432/icde</Url>

<!
--
Usuario Propietario de la Base de Datos
--
>





<User>igac</User>

<!
--
Contraseña Propietario de la Base de Datos
--
>





<Password>igac</Password>





<SecurityConstraints/>

<!
--
Sistema de Codificación de la Base de Datos
--
>





<Encoding>
LATIN1</Encoding>




</JDBCConnection>


<deegreewfs:SuppressXLinkOutput>false</deegreewfs:SuppressXLinkOutput>



</xsd:appinfo>


</xsd:annotation>


<!
--
================================================================
--
>

<!
--
Nombre del elemento / Tipo del e
lemento / Soporte GML
--
>

<xsd:element name="Drenaje" type="gidecanwfs:DrenajeType"
substitutionGroup="gml:_Feature">



<xsd:annotation>




<xsd:appinfo>

<!
--
Nombre de la tabla en la Base de Datos
--
>





<deegreewfs:table>drenaje</deegreewfs:table>

<!
--
Pref
ijo para identificación GML
--
>





<deegreewfs:gmlId prefix="Dre">

<!
--
Mapeo campo identificador de la tabla y su tipo de dato para
identificación GML
--
>

<deegreewfs:MappingField field="gid" type="INTEGER"/>





</deegreewfs:gmlId>





<deegreewfs:visible>
true</deegreewfs:visible>




<deegreewfs:transaction update="false" delete="false"
insert="false"/>




</xsd:appinfo>



</xsd:annotation>


</xsd:element>


<!
--
================================================================
--
>

<!
--
Definición de campos que
serán tomados de la tabla
--
>


<xsd:complexType name="DrenajeType">



<xsd:complexContent>




<xsd:extension base="gml:AbstractFeatureType">





<xsd:sequence>

<xsd:element name="identificador"
type="xsd:integer">







<xsd:annotation>








<xsd:appinfo>

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


14










<deegreewfs:IdentityPart>true</deegreewfs:IdentityPart>









<deegreewfs:Content>

<!
--
Mapeo campo identificador de la tabla (gid) y su tipo de dato
(INTEGER)
--
>



<deegreewfs:MappingField field="gid" type="INTEGER"/>









</deegreewfs:Conten
t>








</xsd:appinfo>







</xsd:annotation>






</xsd:element>






<xsd:element name="tipo" type="xsd:string">







<xsd:annotation>








<xsd:appinfo>









<deegreewfs:IdentityPart>true</deegreewfs:IdentityPart>









<deegreewfs:Content>

<
!
--
Mapeo campo nombre de la tabla (nmg) y su tipo de dato (VARCHAR)
--
>



<deegreewfs:MappingField field="nmg" type="VARCHAR"/>









</deegreewfs:Content>








</xsd:appinfo>







</xsd:annotation>






</xsd:element>






<xsd:element name="area"
typ
e="gml:GeometryPropertyType">







<xsd:annotation>








<xsd:appinfo>









<deegreewfs:Content>










<deegreewfs:SRS>EPSG:4326</deegreewfs:SRS>

<!
--
Mapeo campo tipo de geometría de la tabla (the_geom) y su tipo de
dato (GEOMETRY)
--
>

<deegreewfs:
MappingField field="the_geom" type="GEOMETRY"
srs="4
32
6"/>









</deegreewfs:Content>








</xsd:appinfo>







</xsd:annotation>






</xsd:element>





</xsd:sequence>




</xsd:extension>



</xsd:complexContent>


</xsd:complexType>


<!
--

===========
====================================================
--
>

</xsd:schema>


6.

El Administrador

configura los anteriores archivos según las necesidades de la información que se desean
mostrar a través del WFS o las peticiones que se quieran consultar
por medio de
un

navegador. Cabe
resaltar que el servicio WMS también se apoyará en el servicio WFS para consumir los datos, y por
consiguiente en los archivos .XSD.

Algunos parámetros a tener en cuenta de los archivos
.
XSD

son:



Cada
archivo XSD

se asigna a una fuente
de datos física (por ejemplo
, una
base de datos).



La configuración de un
archivo XSD

es un “GML3 application schema”
,

donde la información sobre las
Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


15


fuentes da datos físicas asignadas, tablas y campos
es

almacenada

en las anotaciones de los elementos del

schema

.



Un tipo complejo XML es asignado a una entidad (por ejemplo
,

una tabla de una base de datos).



En una parte del archivo se define la configuración del acceso a los datos.
Para esto hay que definir, por lo
menos los siguientes parámetros:

o

<
Prefix
>
:
P
refijo del
espacio de nombres

en
e
l que se engloba
el FeatureType (
en este caso
,

gidecan
wfs
)
.

o

<
Backend
>
:
T
ipo de almacenamiento donde se sirven los datos

(
en este caso
,

P
ostg
reSQL+PostGIS)
.

o

<
DefaultSRS
>
: Sistema de coordenadas por defecto.

o

<
Driver
>
: Clase

java que permite el acceso al
<B
ackend
> (
en

este caso
,

el driver de java para
postgis
)
.

o

<URL>: Dirección

de conexión a
la base de datos
.

o

<
User
>: Usuario propietario de la base de datos

donde están las tablas a las que
se
necesita
acceder.

o

<
Password
>
:
Cont
raseña

correspondiente al usuario de
base de datos

donde están las tablas a las
que

se

necesita acceder.



Una vez definidos los parámetros de conexión a los datos, hay que incluir un elemento XML en el que el
atributo
name

tiene que coincidir con el valor
del elemento
<wfs:Name>
sin el prefijo del elemento
<wfs:FeatureType>

correspondiente
,

dentro del
<wfs:FeatureList>

de

l
as
capa
cidades del servicio WFS,
dentro del archivo wfs_configuration.xml
.



El valor del atributo
type

debe corresponder al de un tipo X
ML que defina un tipo de capa dentro de este
mismo documento (en este caso el tipo
DrenajeType
). Dentro de la definición del elemento hay que indicar
la tabla donde se encuentra
n los datos de la capa,

mediante el elemento
<deegreewfs:table>

y un campo de
l
a tabla que perm
ita identificar a cada una de lo
s
campos
de

l
a

capa,

mediante el elemento
<deegreewfs:MappingField>
.



Después hay que definir el tipo al que
se ha
hecho referencia en la definición del elemento
,

mediante la
instrucción <xsd:complexType> en l
a que el atributo
name

debe contener como valor el nombre del tipo
con el prefijo del
espacio de nombres

definido en el esquema. Posterioremente se define el tipo XML
complejo
,

que es una extensión del tipo gidecanwfs
,

que extiende al tipo GML AbstractFeat
ureType y que
es condición necesaria para que el tipo pueda ser considerado un
tipo de capa
.



A continuación se pasa a definir el mapeo de los elementos o propiedades de la capa, con los campos de la
tabla de la base de datos. Por cada elemento hay que defi
nir su nombre y tipo XML (atributos
name

y
type
),
su cardinalidad (
minOccurs

y
maxOccurs
) y el valor que se debe obtener de la base de datos dentro del
elemento
<deegreewfs:MappingField>
, en el que se especifica el nombre del campo de la tabla del que se
t
iene que obtener el valor para el elemento (atributo
field
), y el tipo de campo de base de datos (atributo
type
).

/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
/////////////////
///////////////////

wfs_GIDECAN_configuration.xml:

Define parámetros importantes del servicio WFS como: Directorio de
los archivos XSD; Identificación del Servicio; Información del Proveedor del Servicio; Metadatos de las
Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


16


operaciones servidas en el Servici
o; Lista de Características (o capas); Filtros.

A continuación se muestran los parámetros claves del archivo de configuración
wfs_configuration.xml
:

<?xml version="1.0" encoding="UTF
-
8"?>

<!
--
Dominio de nombres: identifica cada elemento wfs
--
>

<wfs:WFS_Ca
pabilities
xmlns:gidecanwfs=
http://www.gidecan.com/wfs

xmlns:deegree="http://www.deegree.org/wfs"
xmlns:ows="http://www.opengis.net/ows"
xmlns:ogc="http://www.opengis.net/ogc"
xmlns:wfs="http://www.opengis.net/wfs
"

xmlns:gml="
ttp://www.opengis.net/gml"
xmlns:xlink="http://www.w3.org/199
9/xlink" version="1.1.0" updateSequence="0">


<!
--
================================================================
--
>


<!
--
Parámetros de de
egree
--
>


<!
--
================================================================
--
>


<deegree:deegreeParams>

<!
--
Parámetro URL de conexión al servicio WFS
--
>

<deegree:DefaultOnlineResource
xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple"
xlink:
href="http://172.17.120.214:8080/GIDECAN
-
OWS/GIDECANservcios" />

<!
--
opcional; tamaño del caché disponible para almacenamiento de
instancias de las capas en memoria
--
>



<deegree:CacheSize>250</deegree:CacheSize>

<!
--

opcional; tiempo máximo permitido para

la ejecución de una
petición (en segundos)
--
>



<deegree:RequestTimeLimit>120</deegree:RequestTimeLimit>

<!
--

Directorio de los archivos XSD, que contienen las capas que serán
servidas por el WFS
--
>



<deegree:DataDirectoryList>

<deegree:DataDirectory>C:
/Archivos de programa/Apache
Software Foundation/Tomcat 6.0/webapps/GIDECAN
-
OWS/WEB
-
INF/conf/wfs/featuretypes</deegree:DataDirectory>



</deegree:DataDirectoryList>


</deegree:deegreeParams>


<!
--
============================================================
====
--
>


<!
--

Identificación del Servicio
--
>


<!
--
================================================================
--
>


<ows:ServiceIdentification>

<!
--
Tipo de Servicio Web
--
>




<ows:ServiceType>WFS</ows:ServiceType>

<!
--
Versión del Servicio
--
>



<ows:Ser
viceTypeVersion>1.1.0</ows:ServiceTypeVersion>



<ows:Fees>None</ows:Fees>

<!

Restricciones de Acceso
--
>



<ows:AccessConstraints>None</ows:AccessConstraints>


</ows:ServiceIdentification>


<!
--
==============================================================
==
--
>


<!
--
Información del proveedor del Servicio
--
>


<!
--
================================================================
--
>


<ows:ServiceProvider>



<ows:ProviderName>IGAC</ows:ProviderName>



<ows:ProviderSite xlink:href="http://www.igac.gov.co" />



<o
ws:ServiceContact>

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


17


<ows:IndividualName>CIAF
-
ICDE
-
Geoservicios</ows:IndividualName>




<ows:PositionName>Soporte</ows:PositionName>




<ows:ContactInfo>





<ows:Phone>






<ows:Voice>0057+1+3694089</ows:Voice>






<ows:Facsimile>+0057+1+3694089</ows:Facs
imile>





</ows:Phone>





<ows:Address>

<ows:DeliveryPoint>Carrera 30 N 45
-
25 Edifico
Ciaf</ows:DeliveryPoint>






<ows:City>Bogota</ows:City>






<ows:AdministrativeArea>Cundinamarca</ows:AdministrativeArea>






<ows:PostalCode>53177</ows:PostalCode
>






<ows:Country>Colombia</ows:Country>

<ows:ElectronicMailAddress>lortiz@igac.gov.co</ows:ElectronicMailAddres
s>





</ows:Address>





<ows:OnlineResource
xlink:href="http://www.igac.gov.co/" />

<ows:HoursOfService>24 horas siete dias a la
semana</ows
:HoursOfService>





<ows:ContactInstructions></ows:ContactInstructions>




</ows:ContactInfo>




<ows:Role>Punto de Contacto</ows:Role>



</ows:ServiceContact>


</ows:ServiceProvider>


<!
--
================================================================
--
>


<!
--
Metadatos de las peticiones soportadas en el WFS
--
>


<!
--
================================================================
--
>


<ows:OperationsMetadata>



<ows:Operation name="
GetCapabilities
">




<ows:DCP>





<ows:HTTP>

<ows:Get
xlink:href="http://1
72.17.120.214:8080/GIDECAN
-
OWS/GIDECANservicios?"
/>





</ows:HTTP>




</ows:DCP>




<ows:Parameter name="AcceptVersions">





<ows:Value>1.1.0</ows:Value>





<ows:Value>1.0.0</ows:Value>




</ows:Parameter>




<ows:Parameter name="AcceptFormats">





<o
ws:Value>text/xml</ows:Value>




</ows:Parameter>




<ows:Parameter name="Sections">





<ows:Value>ServiceIdentification</ows:Value>





<ows:Value>ServiceProvider</ows:Value>





<ows:Value>OperationsMetadata</ows:Value>





<ows:Value>FeatureTypeList</o
ws:Value>





<ows:Value>ServesGMLObjectTypeList</ows:Value>





<ows:Value>SupportsGMLObjectTypeList</ows:Value>





<ows:Value>Filter_Capabilities</ows:Value>

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


18





</ows:Parameter>



</ows:Operation>



<ows:Operation name="
DescribeFeatureType
">




<ows:DCP
>





<ows:HTTP>

<ows:Get
xlink:href="http://172.17.120.214:8080/GIDECAN
-
OWS/GIDECANservicios?"
/>

<ows:Post
xlink:href="http://172.17.120.214:8080/GIDECAN
-
OWS/GIDECANservicios" />





</ows:HTTP>




</ows:DCP>




<ows:Parameter name="outputFormat">





<o
ws:Value>text/xml; subtype=gml/3.1.1</ows:Value>




</ows:Parameter>



</ows:Operation>



<ows:Operation name="
GetFeature
">




<ows:DCP>





<ows:HTTP>

<ows:Get
xlink:href="http://172.17.120.214:8080/GIDECAN
-
OWS/GIDECANservicios?"
/>

<ows:Post
xlink:href="
http://172.17.120.214:8080/GIDECAN
-
OWS/GIDECANservicios" />





</ows:HTTP>




</ows:DCP>




<ows:Parameter name="resultType">





<ows:Value>results</ows:Value>





<ows:Value>hits</ows:Value>




</ows:Parameter>




<ows:Parameter name="outputFormat">





<ows:Value>text/xml; subtype=gml/3.1.1</ows:Value>




</ows:Parameter>



</ows:Operation>



<ows:Operation name="
GetFeatureWithLock
">




<ows:DCP>





<ows:HTTP>

<ows:Get
xlink:href="http://172.17.120.214:8080/GIDECAN
-
OWS/GIDECANservicios?"
/>

<ows:Post
x
link:href="http://172.17.120.214:8080/GIDECAN
-
OWS/GIDECANservicios" />





</ows:HTTP>




</ows:DCP>




<ows:Parameter name="resultType">





<ows:Value>results</ows:Value>





<ows:Value>hits</ows:Value>




</ows:Parameter>




<ows:Parameter name="outputF
ormat">





<ows:Value>text/xml; subtype=gml/3.1.1</ows:Value>




</ows:Parameter>



</ows:Operation>



<ows:Operation name="
GetGMLObject
">




<ows:DCP>





<ows:HTTP>

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


19


<ows:Post
xlink:href="http://172.17.120.214:8080/GIDECAN
-
OWS/GIDECANservicios" />





</
ows:HTTP>




</ows:DCP>




<ows:Parameter name="outputFormat">





<ows:Value>text/xml; subtype=gml/3.1.1</ows:Value>





<ows:Value>text/xhtml</ows:Value>




</ows:Parameter>




<ows:Parameter name="LocalTraverseXLinkScope">





<ows:Value>0</ows:Value>





<ows:Value>*</ows:Value>




</ows:Parameter>




<ows:Parameter name="RemoteTraverseXLinkScope">





<ows:Value>0</ows:Value>





<ows:Value>*</ows:Value>




</ows:Parameter>



</ows:Operation>



<ows:Operation name="
LockFeature
">




<ows:DCP>





<ows:H
TTP>

<ows:Post
xlink:href="http://172.17.120.214:8080/IGAC
-
OWS/IGAC/OGCservicios" />





</ows:HTTP>




</ows:DCP>




<ows:Parameter name="lockAction">





<ows:Value>ALL</ows:Value>





<ows:Value>SOME</ows:Value>




</ows:Parameter>



</ows:Operation>



<ows:Parameter name="srsName">




<ows:Value>EPSG:4326</ows:Value>



</ows:Parameter>



<ows:Constraint name="DefaultMaxFeatures">




<ows:Value>10000</ows:Value>



</ows:Constraint>



<ows:Constraint name="LocalTraverseXLinkScope">




<ows:Value>0</ows:Va
lue>




<ows:Value>*</ows:Value>



</ows:Constraint>



<ows:Constraint name="RemoteTraverseXLinkScope">




<ows:Value>0</ows:Value>




<ows:Value>*</ows:Value>



</ows:Constraint>



<ows:Constraint name="DefaultLockExpiry">




<ows:Value>5</ows:Value>



</
ows:Constraint>


</ows:OperationsMetadata>


<!
--
================================================================
--
>


<!
--
Lista de Capas o Features
--
>


<!
--
================================================================
--
>


<wfs:FeatureTypeList xmlns:gidec
anwfs="http://www.gidecan.com/wfs">



<wfs:FeatureType>




<wfs:Name>gidecanwfs:Drenaje</wfs:Name>




<wfs:Title>Drenaje</wfs:Title>




<wfs:Abstract>Drenaje</wfs:Abstract>

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


20





<ows:Keywords>





<ows:Keyword>Drenaje</ows:Keyword>




</ows:Keywords>




<wfs
:DefaultSRS>EPSG:4326</wfs:DefaultSRS>




<wfs:OtherSRS>EPSG:4258</wfs:OtherSRS>




<wfs:OutputFormats>





<wfs:Format>text/xml; subtype=gml/3.1.1</wfs:Format>





<wfs:Format>ZIPPEDSHAPE</wfs:Format>




</wfs:OutputFormats>




<ows:WGS84BoundingBox>





<ows:LowerCorner>
-
59.68787
-
4.86335</ows:LowerCorner>





<ows:UpperCorner>
-
89.41444 14.35593</ows:UpperCorner>




</ows:WGS84BoundingBox>



</wfs:FeatureType>


</wfs:FeatureTypeList>


<!
--
================================================================
--
>


<!
--
Filtros servidos (OGC:Filter Encoding)
--
>


<!
--
================================================================
--
>


<ogc:Filter_Capabilities>



<ogc:Spatial_Capabilities>




<ogc:GeometryOperands>





<ogc:GeometryOperand>gml:Envelope</ogc:GeometryOp
erand>





<ogc:GeometryOperand>gml:Point</ogc:GeometryOperand>





<ogc:GeometryOperand>gml:LineString</ogc:GeometryOperand>





<ogc:GeometryOperand>gml:Polygon</ogc:GeometryOperand>




</ogc:GeometryOperands>




<ogc:SpatialOperators>





<ogc:SpatialOp
erator name="BBOX" />





<ogc:SpatialOperator name="Equals" />





<ogc:SpatialOperator name="Disjoint" />





<ogc:SpatialOperator name="Intersects" />





<ogc:SpatialOperator name="Touches" />





<ogc:SpatialOperator name="Crosses" />





<ogc:Spatial
Operator name="Within" />





<ogc:SpatialOperator name="Contains" />





<ogc:SpatialOperator name="Overlaps" />





<ogc:SpatialOperator name="Beyond" />




</ogc:SpatialOperators>



</ogc:Spatial_Capabilities>



<ogc:Scalar_Capabilities>




<ogc:Logical
Operators>





<ogc:LogicalOperator>And</ogc:LogicalOperator>





<ogc:LogicalOperator>Or</ogc:LogicalOperator>





<ogc:LogicalOperator>Not</ogc:LogicalOperator>




</ogc:LogicalOperators>




<ogc:ComparisonOperators>





<ogc:ComparisonOperator>LessThan<
/ogc:ComparisonOperator>





<ogc:ComparisonOperator>GreaterThan</ogc:ComparisonOperator>





<ogc:ComparisonOperator>LessThanEqualTo</ogc:ComparisonOperator>

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


21






<ogc:ComparisonOperator>GreaterThanEqualTo</ogc:ComparisonOperator>





<ogc:ComparisonOperat
or>EqualTo</ogc:ComparisonOperator>





<ogc:ComparisonOperator>Like</ogc:ComparisonOperator>





<ogc:ComparisonOperator>Between</ogc:ComparisonOperator>





<ogc:ComparisonOperator>NullCheck</ogc:ComparisonOperator>




</ogc:ComparisonOperators>




<ogc:
ArithmeticOperators>





<ogc:SimpleArithmetic />




</ogc:ArithmeticOperators>



</ogc:Scalar_Capabilities>



<ogc:Id_Capabilities>




<ogc:EID />




<ogc:FID />



</ogc:Id_Capabilities>


</ogc:Filter_Capabilities>

</wfs:WFS_Capabilities>

7.

El Administrador

configura
e
l anterior archivo según las necesidades de la información que se desean
obtener

a través del WFS o las peticiones que se quieran consultar
por medio de un

navegador

web
.

Algunos parámetros a tener en cuenta del archivo
wfs_configuration.xml

s
on:



La sección más importante es la contenida dentro del tag <deegree:deegreeParams> donde se define
primero el elemento DefaultOnlineResource, que se usa como valor por defecto para todos los recursos
usados en el documento de capa
cidades del servicio
.



E
l elemento CacheS
ize define el tamaño de la caché

disponible para almacenar instancias de
las capas
servidas

en memoria. Para e
vitar que el servicio se bloquee

con peticiones muy costosas en tiempo, se
puede definir un tiempo límite máximo para el procesam
iento de una petición utilizando el elemento

RequestTimeLimit.



Es

importante también la lista de directorios que el WFS escaneará en busca de
archiv
os de configuración
XSD

(con definiciones de

FeatureTypes
” o tipos de capa
)
,

que se define mediante el ele
mento
DataDirectoryList y los subelementos DataDirectory
.



Definición de operaciones disponibles a través del WFS: En la versión actual se soportan las operaciones
obligatorias GetCapabilities, DescribeFeatureType y GetFeature.



La sección <FeatureTypeList>

lista todos los
tipos de capas

disponibles a través del WFS. La configuración
para búsqueda automática de
tipos de capas

durante la inicialización consiste en dejar el elemento vacío.

En
este caso todos los
tipos de capas

disponibles y su meta
-
información

asociada se extraerá de la
configuración de los
archivos XSD

encontrados en los <DataDirectories> definidos. Alternativament
e
existe la opción de añadir uno

o más
tipos de capas

manualmente a la lista. Esto puede ser útil si la meta
-
información del
tipo d
e capa

no puede ser extraída adecuadamente de la configuración de

l
os archivos
XSD
.



Cada uno de estos tipos de capas tiene que estar definido y configurado en un archivo XSD, los cuales son
descritos con mayor profundidad en el caso de uso
Configurar Archi
vos XSD
.
En esta configuración
del
servicio WFS
vemos primero el elemento <wfs:Name>
,

que constituye el nombre con el cual vamos a
identificar al
tipo de capa

en las peticiones al WFS. Otra parte importante es el sistema de referencia de
coordenadas en
e
l
que
se definen
las geometrías correspondientes al
tipo de capa
, defin
ido

mediante los
elementos <wfs:DefaultSRS>, que define el sistema por defecto
y
que coincidirá con el sistema del
archivo
XSD,

y los elementos <wfs:OtherSRS>
,

que permite configurar

en q

otros sistemas
se
permite devolver
las geometrías (contando
que
cada petición conlleva un tiempo de transformación que ralentizará la
misma). Por último, se define el rectángulo geométrico
o “bounding box”
en coordenadas geográficas
Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


22


(WGS
-
84)
,
que englob
a a todas las
capas,

mediante el elemento <ows:WGS84BoundingBox>.



Después de la definición de la Lista de Capas se definen las capacidades de las implementaciones de
filtrado de código disponibles. Esto incluye la lista de tipos de geometrías soportados co
mo operandos,
además de una lista de opresores lógicos y espaciales soportados.

/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
///////////////////////////////////////////

El nive
l paralelo

al 4to

tenemos los directorios contenidos en la carpeta
wms
.


featureinfo2gml.xsl:

Script de Conversión por Defecto para transformar la respuesta GML en una petición
GetFeatureInfo.

featureinfo2html.xsl:

Script de Conversión por Defecto para tr
ansformar la respuesta GML en una petición
GetFeatureInfo, en formato HTML.

LOCALWFS_capabilities.xml:

Capacidades del servicio WFS local, suministradas como apoyo al servicio
WMS.

styles.xml:

Define la simbología con que se mostrará cada una de las capas
de información, según la
geometría de dicha capa (polígono, punto o línea), con parámetros OGC implementados mediante la
especificación Styled Layer Descriptor.

A continuación se muestran los parámetros claves del archivo de configuración styles.xml (para
este
caso, el ejemplo se realiza con una capa de drenaje, tipo línea):

<?xml version="1.0" encoding="UTF
-
8"?>

<sld:StyledLayerDescriptor

<!
--
Dominio de nombres: identifica cada elemento wfs
--
>

xmlns:gidecanwfs="http://www.gidecan.com/wfs"
xmlns:sld="http:
//www.opengis.net/sld" xmlns:java="java"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:wfs="http://www.opengis.net/wfs"
xmlns:xsi="http://www.w3.org/2001/XMLSchema
-
instance"
xmlns:xslutil="de.latlon.deejump.plugin.style.XSLUtility"
xmlns:deegreewfs="htt
p://www.deegree.org/wfs"
xmlns:fo="http://www.w3.org/1999/XSL/Format"
xmlns:gml="http://www.opengis.net/gml"
xmlns:ogc="http://www.opengis.net/ogc"
xmlns="http://www.opengis.net/sld" version="1.0.0">

<!
--
Comienzo de la capa
--
>

<sld:NamedLayer>

<!
--
Nombre d
e la capa: Debe ser el mismo del XSD
--
>



<sld:Name>Drenaje</sld:Name>

<!
--
Estilo
--
>



<sld:UserStyle>

<!
--
Nombre de la capa: Debe ser el mismo del parámetro Named Layer
--
>




<sld:Name>default:Drenaje</sld:Name>

<!
--
Título de la capa
--
>




<sld:Title>def
ault:Drenaje</sld:Title>

<!
--
Activa por defecto (1:0)
--
>




<sld:IsDefault>1</sld:IsDefault>

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


23


<!
--
Tipo de estilo de la capa
--
>




<sld:FeatureTypeStyle>

<!
--
Nombre por defecto del estilo
--
>





<sld:Name>default:Drenaje</sld:Name>

<!
--
Definición reglas del

estilo
--
>





<sld:Rule>

<!
--
Nombre regla
--
>






<sld:Name>DrenajeLinea</sld:Name>

<!
--
Parámetros de escala
--
>


<sld:MaxScaleDenominator>2000000</sld:MaxScaleDenominator>






<sld:MinScaleDenominator>250000</sld:MinScaleDenominator>

<!
--
Simbología según

la geometría (ver especificación
OGC
SLD

1.0
)
--
>






<sld:LineSymbolizer>







<ogc:Geometry>








<ogc:PropertyName>gidecanwfs:area</ogc:PropertyName>







</ogc:Geometry>







<sld:Fill>

<sld:CssParameter
name="fill">#00CCFF</sld:CssParameter>

<sl
d:CssParameter name="fill
-
opacity">0.4</sld:CssParameter>







</sld:Fill>







<sld:Stroke>

<sld:CssParameter
name="stroke">#3399FF</sld:CssParameter>

<sld:CssParameter name="stroke
-
linecap">butt</sld:CssParameter>

<sld:CssParameter name="stroke
-
linejoi
n">mitre</sld:CssParameter>

<sld:CssParameter name="stroke
-
opacity">1.0</sld:CssParameter>

<sld:CssParameter name="stroke
-
width">1.0</sld:CssParameter>

<sld:CssParameter name="stroke
-
dashoffset">0.0</sld:CssParameter>







</sld:Stroke>






</sld:LineSym
bolizer>





</sld:Rule>

</sld:FeatureTypeStyle>



</sld:UserStyle>


</sld:NamedLayer>

</sld:StyledLayerDescriptor>

8.

El Administrador

configura los anteriores archivos según las necesidades de la información que se desean
mostrar a través del WMS o las peti
ciones que se quieran consultar vía navegador. Cabe resaltar que el
servicio WMS se apoyará por completo en el archivo styles.xml para tomar de allí la simbología de las
capas, y en los archivos .XSD para consumir los datos.



/////////////////////////////
/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
//////////////

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


24



wms_GIDECAN_configuration.xml:
Define parámetros importantes del servicio WMS como: Referencia
al archivo de estilo
s; Identificación del Servicio; Información del Proveedor del Servicio; Metadatos de las
operaciones servidas en el Servicio; Lista de Características (o capas).

A continuación se muestran los parámetros claves del archivo de configuración
wms_configuratio
n.xml
:


<?xml version="1.0" encoding="UTF
-
8"?>

<WMT_MS_Capabilities xmlns:deegree=
http://www.deegree.org/wms

xmlns:gml="http://www.opengis.net/gml" version="1.1.1"
updateSequence="1.1.0">


<deegree:DeegreeParam>

<
deegree:DefaultOnlineResource
xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple"
xlink:href="http://pixie.cps.unizar.es:8080/GIDECAN
-
OWS/GIDECANservicios" />


<!
--

Tamaño del Caché
--
>



<deegree:CacheSize>100</deegree:CacheSize>

<!
--

Máximo ti
empo de vida de los procesos en el WMS (segundos)
--
>



<deegree:MaxLifeTime>3600</deegree:MaxLifeTime>

<!
--

Máximo tiempo para la ejecución de una petición hasta que una
excepción de exceso de tiempo es lanzada
--
>



<deegree:RequestTimeLimit>55</deegree:R
equestTimeLimit>

<!
--

Determina la calidad de la imagen del mapa generado a partir de
una petición GetMap. El rango de valores es de 0 ... 1, donde 1 es la
mejor y 0 la peor.
--
>



<deegree:MapQuality>1.00</deegree:MapQuality>


<!
--

Máxmimo ancho del mapa
que puede ser solicitado
--
>



<deegree:MaxMapWidth>5000</deegree:MaxMapWidth>


<!
--

Máxmima altura del mapa que puede ser solicitado
--
>



<deegree:MaxMapHeight>5000</deegree:MaxMapHeight>



<deegree:AntiAliased>true</deegree:AntiAliased>

<!
--

Nota de der
echos de autor que será dibujada al lado izquierdo del
fondo del mapa
--
>

<Copyright>"file://C:/Archivos de programa/Apache Software
Foundation/Tomcat 6.0/webapps/GIDECAN
-
OWS/SLDImages/Igac.gif"</Copyright>

<!
--

devuelve el URl donde el DTD para las capaci
dades OGC WMS están
localizadas.
--
>



<deegree:DTDLocation>

<deegree:OnlineReso
urce
xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple"
xlink:href="http://schemas.opengis.net/wms/1.1.1/WMS_MS_Capabilities.dt
d" />



</deegree:DTDLocation>

<!
--

d
efinición de proxy para servicios remotos

--
>


<!
--

Proxy proxyHost="131.220.106.104" proxyPort="1234" /
--
>


</deegree:DeegreeParam>


<Service>



<Name>GIDECAN
-
WMS</Name>



<Title>WMS</Title>


<!
--

Abstract y palabras clave son opcionales
--
>



<Abstract>W
eb Map Service sirviendo informacion para el
Geoportal de la IDECAN</Abstract>

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


25




<Keywords>




<Keyword>WMS</Keyword>




<Keyword>Deegree</Keyword>




<Keyword>IGAC</Keyword>




<Keyword>IDECAN</Keyword>




<Type>String</Type>



</Keywords>



<OnlineResour
ce xmlns:xlink=
http://www.w3.org/1999/xlink

xlink:type="simple" xlink:href="http://172.17.120.214:8080/GIDECAN
-
OWS"
/>


<!
--

Información de Contacto (opcional)
--
>



<ContactInformation>




<ContactPersonPrimary
>

<ContactPerson>Luis Fernando Ortiz
Reyes</ContactPerson>

<ContactOrganization>Instituto Geografico Agustin
Codazzi IGAC</ContactOrganization>




</ContactPersonPrimary>




<ContactPosition>Pasante Universidad Distrital
-

Grupo Geoservicios</ContactPositi
on>




<ContactAddress>





<AddressType></AddressType>





<Address>Carerra 30 N 48
-

51</Address>





<City>Bogota</City>





<StateOrProvince>Cundinamarca</StateOrProvince>





<PostCode></PostCode>





<Country>Colombia</Country>




</ContactAddress>




<ContactVoiceTelephone>+571 3694000</ContactVoiceTelephone>




<ContactFacsimileTelephone>+57
-
1
3694100</ContactFacsimileTelephone>

<ContactElectronicMailAddress>lortiz@igac.gov.co</ContactElectronicMail
Address>



</ContactInformation>



<Fees></Fees>



<AccessConstraints></AccessConstraints>


</Service>


<Capability>



<Request>


<!
--

por defecto disponible
--
>




<GetCapabilities>

<!
--

por defecto y obligatorio = application/vnd.ogc.wms_xml
--
>





<Format>application/vnd.ogc.wms_xml</Format>





<DCPTy
pe>






<HTTP>







<Get>

<OnlineResource
xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple"
xlink:href="http://172.17.120.214:8080/GIDECAN
-
OWS/GIDECANservicios/GIDECANservicios?" />







</Get>


<!
--

POST no es soportado
--
>






</HTTP>





</DCPType>




</GetCapabilities>

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


26



<!
--

por defecto disponible
--
>




<GetMap>


<!
--

por defecto = image/gif; image/png; image/jpg
--
>


<!
--

obligatorio = image/png
--
>





<Format>image/gif</Format>





<Format>image/png</Format>





<Format>image/jpg</F
ormat>





<Format>image/tif</Format>





<Format>image/bmp</Format>





<DCPType>






<HTTP>







<Get>

<OnlineResource
xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple"
xlink:href="http://172.17.120.214:8080/GIDECAN
-
OWS/GIDECANservicios?"
/>







</Get>







<Post>

<OnlineResource
xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple"
xlink:href="http://172.17.120.214:8080/GIDECAN
-
OWS/GIDECANservicios?"
/>







</Post>






</HTTP>





</DCPType>




</GetMap>


<!
--

por defecto di
sponible
--
>




<GetFeatureInfo>

<!
--

por defecto y obligatorio = application/vnd.ogc.wms_xml
--
>





<Format>application/vnd.ogc.gml</Format>





<Format>text/plain</Format>





<Format>text/html</Format>





<DCPType>






<HTTP>







<Get>

<OnlineResou
rce
xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple"
xlink:href="http://172.17.120.214:8080/GIDECAN
-
OWS/GIDECANservicios?"
/>







</Get>


<!
--

POST no es soportado
--
>






</HTTP>





</DCPType>




</GetFeatureInfo>




<GetLegendGraphic>


<!
--

por defecto = image/gif; image/png; image/jpg
--
>


<!
--

obligatorio = image/png
--
>





<Format>image/gif</Format>





<Format>image/png</Format>





<Format>image/jpeg</Format>





<Format>image/jpg</Format>





<Format>image/tif</Format>





<Format
>image/bmp</Format>





<DCPType>






<HTTP>

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


27








<Get>

<OnlineResource
xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple"
xlink:href="http://172.17.120.214:8080/GIDECAN
-
OWS/ogcwebservice?" />







</Get>


<!
--

POST no es soportado
--
>






</HTTP>





</DCPType>




</GetLegendGraphic>



</Request>



<Exception>

<!
--

por defecto y obligatorio = application/vnd.ogc.wms_xml
--
>




<Format>application/vnd.ogc.se_xml</Format>




<Format>application/vnd.ogc.se_inimage</Format>




<Format>applicati
on/vnd.ogc.se_blank</Format>



</Exception>


<!
--

opcional; por defecto = todo falso
--
>

<UserDefinedSymbolization SupportSLD="1" UserLayer="1"
UserStyle="1" RemoteWFS="0" />


<!
--

Capas o Features
--
>


<Layer queryable="0" cascaded="0" noSubsets="0">





<Title>Drenaje</Title>





<Abstract>Drenaje</Abstract>





<KeywordList>






<Keyword>Drenaje</Keyword>





</KeywordList>


<!
--

Bounding Box
--
>





<LatLonBoundingBox minx="
-
86.81245" miny="
-
5.19699" maxx="
-
65.83648" maxy="16.35793" />


<!
--

Escala
--
>





<ScaleHint min="0" max="8000000" />


<!
--

Disponibilidad de la capa
--
>





<Layer queryable="1" noSubsets="0"
fixedWidth="0" fixedHeight="0">


<!
--

Nombre (el mismo del WFS)
--
>






<Name>Drenaje</Name>


<!
--


tulo (
definido por el Administrador
)
-
-
>






<Title>Drenaje</Title>


<!
--

Sistema de Referencia Espacial
--
>






<SRS>EPSG:4326</SRS>






<deegree:DataSource failOnException="0"
queryable="1">


<!
--
Referencia al objeto Drenaje de la Base de Datos mapeado al XSD
--
>


<deegree:Name>gidecanwfs:
Drenaje</deegree:Name>







<deegree:Type>LOCALWFS</deegree:Type>


<!
--

Campo de la geometría (como fue nombrado en el XSD)
--
>


<deegree:GeometryProperty>gidecanwfs:area</deegree:GeometryProperty>


<!
--

Escala
--
>

<deegree:ScaleHint min="0.0"
max="999999
99" />






</deegree:DataSource>


<!
--

Definición de la ubicación del Estilo para la simbología
--
>






<Style>







<Name>default:Drenaje</Name>







<Title>Drenaje</Title>

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


28








<LegendURL height="10" width="10">


<!
--

Formato de salida
--
>








<F
ormat>image/jpeg</Format>








<OnlineResource
xmlns:xlink="http://www.w3.org/1999/xlink"

xlink:href="http://172.17.120.214:8080/GIDECAN
-
OWS/GIDECANservicios?service=WMS&amp;request=GetLegendGraphic&amp;versi
on=1.1.1&amp;width=25&amp;height=25&amp;format
=image/gif&amp;layer=Dren
aje&amp;style=default:Drenaje"









xlink:type="simple" />







</LegendURL>


<!
--

Archivo fuente del estilo
--
>


<deegree:StyleResource>styles.xml</deegree:StyleResource>






</Style>





</Layer>




</Layer>



</Layer>


</Ca
pability>

</WMT_MS_Capabilities>

9.

El Administrador

configura
e
l anterior archivo según las necesidades de la información que se desean
mostrar a través del WMS o las peticiones que se quieran consultar
por medio de un

navegador.

Algunos parámetros a tener
en cuenta del archivo
wms_configuration.xml

son:



En los parámetros de capacidades del servicio
se hace una referencia a l
a
s
peticiones soportadas por el
servicio WMS, y la lista de
capas que
servirá
el servicio WMS.



A c
ada capa se le debe indicar un estilo

de visualización específico,
ya que d
eegree no tiene simbología
propia. Por consiguiente
,

esto exige la creación
y configuración
de un archivo de simbología (
descrito en el
caso de uso
Configurar

Style Layer Descriptor
).



El archivo
LocalWFS.xml

es una r
éplica de la configuración del WFS local. Por esta razón, si se configura
el archivo wfs_configuration .xml de forma apropiada, lo único que se debe hacer es crear una copia con el
nombre
LocalWFS.xml
, y pegarla en el directorio correspondiente.


10.

El Admini
strador

configur
a

los anteriores archivos
según las necesidades de la información que se desean
mostrar a través del WMS o las peticiones que se quie
ran consultar a través del WFS. Algunos parámetros
a tener en cuenta del archivo
web.xml

son:



El nombre del

servlet y la clase java que lo representa se deben indicar en los tags <servlet>.



El nombre del servlet puede ser definido por el
Administrador
, teniendo
en cuenta
que
debe ser el
mismo que se utiliza en el parámetro

serlvet
-
mapping.



El tag <init
-
par
a
m> d
efine los parámetros que serán analizados por el servlet en la inicialización. En el
caso de GIDECAN
-
OWS son:

o

“services”. El valor de este parámetro contiene una lista separada por comas de los servicios
OWS disponibles a través

de archivos de

contexto
.

E
n

este

caso
,

los

servicio
s

WFS y el
WMS.

o

Para cada servicio listado en el parámetro “services” se debe referenciar la clase java
manejadora y un archivo de configuración. El nombre del init
-
param para definir esta clase
java, empieza con el nombre del servi
cio (WFS) seguido de “.handler”. El valor del parámetro
es el nombre de la clase java a usar. El tag <servlet
-
mapping> define el alias del servlet. No es
necesario que <servlet
-
name> y <url
-
pattern> sean idénticos. <url
-
pattern> es el nombre con
el que el
servlet será llamado en la URL.

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


29


11.

El Administrador

re
inicia el contenedor de servlets Tomcat.

12.

Cualquier usuario puede acceder ahora a los servicios WFS y WMS de las siguientes formas:

-

H
aciendo peticiones
por medio de un
navegador

web estándar como Intern
et Explorer o Mozilla Firefox
(recomendado)
, con los parámetros
OGC

establecidos

en las especificaciones de los servicios. Dichas
peticiones serán vistas con mayor profundidad en los casos de uso de acceso a cada uno de estos servicios.

-

A
través de un cl
iente que soporte dichos servicios
.


-

Por medio

del Visor de Mapas del Geoportal de la IDECAN.

La dirección
de conexión general para acceder a ellos es:

http://localhost:8080/GIDECAN
-
OWS/
GIDECANservicios
.

localhost puede ser remplazado por la dirección ip o por el nombre del equipo. El 8080 es el puerto que
utiliza por defecto Tomcat, que puede ser configurado en su instalación. Además, puede ser ocultado
mediante la instalación del cone
ctor JK.

6.

Configuración de la Base de Datos

6.1

Creación y configuración de la Base de Datos en PostgreSQL

1.

El Administrador

recibe el modelo de datos unificado, proveniente de la Homologación del Catálogo de
Objetos llevada a cabo en el Taller Desarrollo del M
apa integrado escala 1:1’000,000 de los Países
Miembros de la Comunidad Andina, en el marco de desarrollo de la IDECAN. Este modelo es un archivo
en Excel, que contiene los objetos de información, es decir, las capas obligatorias y opcionales que
mostrará
el Mapa Regional Andino a escala 1:1’000,000, y los atributos de cada uno de estos objetos.

2.

El Administrador

recibe los datos pertinentes al modelo acordado, enunciado en el caso de uso
Generar el
Mapa Regional Andino,
en el formato acordado para archivos

de información geográfica (formato shape,
archivos .shp).

3.

Se asume que PostgreSQL+PostGIS ha sido instalado y configurado, ya que este caso de uso solo explica la
forma específica de configuración de la base de datos
.

4.

La variable de entorno para PostgreS
QL debe haberse establecido previamente.

5.

El Administrador debe tener en cuenta entonces los siguientes parámetros del Modelo de Datos de una base
de datos geográfica; este modelo está basado en estándares OGC y tiene soporte en PostgreSQL+PostGIS:



La tabl
a
GEOMETRY_COLUMNS
, describe las tablas espaciales que están disponibles y sus propiedades
geométricas.



La tabla SPATIAL_REF_SYS describe los sistemas de coordenadas y las transformaciones geométricas.



La tabla FEATURES guarda el conjunto de fenómenos espa
ciales. Las columnas de esta tabla representan
los atributos de interés, significa que cada tupla hace referencia a una característica geográfica.



Cada Geometry Column en la base de datos tiene un registro en la tabla GEOMETRY_COLUMNS. Los
datos almacenad
os para cada Geometry Column, son los siguientes:

o


Identificación de la tabla
FEATURE a la cual la Geometry Column pertenece.

o

Nombre de la
Geometry Column.

o

ID del sistema de referencia espacial de la Geometry Column.

o

Dimensión de coordenadas para la Geomet
ry Column.



Cada Geometry

Column está

asociada a un Sistema de Referencia Espacial. El Sistema de Referencia
Espacial identifica el sistema de coordenadas para todos los objetos geométricos almacenados en la
columna, y dan sentido a los valores numéricos de

las coordenadas para cualquier objeto geométrico
almacenado en la columna.

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


30




La tabla SPATIAL_REF_SYS almacena la información de cada Sistema de Referencia Espacial en la base
de datos.
Las columnas de esta tabla son Spatial Reference System Identifier (SRI
D), Spatial Reference
System Authority Name (AUTH_NAME), Authority Specific Spatial Reference System Identifier
(AUTH_SRID) y la descripción de Spatial Reference System (SRTEXT).
El SRID constituye una llave
entera única para los sistemas de referencia esp
acial dentro de la base de datos, cuya codificación se hace
siguiendo la base de datos de la EPSG.



La interoperabilidad entre clientes se logra a través de columna SRTEXT en donde se almacena la
información tipo texto de los sistemas de referencia espacia
l.

6.

Teniendo en cuenta estos par
ámetros del Modelo de Datos, el Administrador

accede al Sistema Manejador
de Bases de Datos PostgreSQL, mediante la utilidad
pgAdminIII


PostgreSQL tools.

7.

Luego d
e ver la sugerencia del día, esta es la primera pantalla que v
erá el Administrador:


Figura
5
. Pantalla de inicio de PostgreSQL

8.

En la parte izquierda se encuentra el acceso a los servidores, que contienen las bases de datos. Dependiendo
de la configuración de instalación de PostgreSQL, el a
cceso al servidor puede o no tener clave de acceso.

9.

Una vez en el servidor, tendremos acceso a los siguientes servicios:

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


31



Figura
6
. Servicios de PostgreSQL

7.1. Databases

(Bases de Datos)
:

Muestra las bases de datos existentes.

También brinda la opción de crear
una nueva base de datos, de actualizar y de hacer reportes de estadísticas y objetos.

7.2.
1.

Tablespaces

(Espacios de Tablas)
:

Un tablespace es un espacio que se asigna a una base de datos
para que allí se alojen todos lo
s datos correspondientes a la configuración de tablas de la misma. Existen
dos espacios de tablas por defecto: pg_default y pg_global. No es indispensable que el Administrador cree
un nuevo espacio de tablas para la base de datos
idecan
, pero es recomendab
le. Este servicio brinda las
opciones de crear un nuevo espacio de tablas, de actualizar y de hacer reportes de estadísticas y objetos. Si
el Administrador desea crear un nuevo espacio de tablas, debe hacer clic en esta opción, y llenar los datos
del direc
torio que será el nuevo espacio: Nombre, Ubicación, Propietario, Comentarios. La carpeta de
destino del nuevo espacio de tablas debe tener todos los permisos para el usuario que va a ser el propietario.
Este espacio de tablas será un parámetro más a tener
en cuenta en la creación de una nueva base de datos.

7.2.2. Group Roles

(Roles de Grupo)
:
Esta opción brinda la posibilidad de crear roles de usuario para un
grupo de usuarios que quieran acceder como grupo y no de manera individual. Para este caso es irr
elevante.

7.3. Login Roles

(Roles de Usuario)
:
Esta

opción nos brinda la posibilidad de ver los roles de usuarios
existentes en PostgreSQL, que pueden ser propietarios de una base de datos o de un tablespace. Por
defecto, PostgreSQL se configura con un su
perusuario definido en la instalación, llamado
postgres
. Si el
Administrador desea crear un nuevo rol, puede hacerlo llenando los campos esenciales: Nombre del Rol,
contraseña, confirmación de contraseña, expiración de la cuenta, privilegios de rol. Para e
ste caso, lo más
importante es que el nuevo rol pueda crear objetos de base de datos. Sin embargo, no es necesario crear un
nuevo rol.

10.

Ya que se han identificado y configurado los anteriores elementos según sus necesidades, puede proceder a
crear la base
de datos
idecan
. El Administrador hace clic derecho en la opción Databases; esta acción
muestra las opciones de Actualizar, Crear nueva base de datos, y Reportes.

11.

El Administrador hace clic en la opción Crear nueva base de datos.

12.

El Administrador debe ll
enar los parámetros solicitados que se ven en la siguiente figura (se llenarán sólo
los datos esenciales):

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


32



Figura
7
. Parámetros de una nueva base de datos

12
.1. Nombre

(Name)
:

Nombre de la base de datos. Para este caso, el nombr
e de la base de datos será
idecan.

12.2. OID:
Owner Id: Este campo es un número que llena PostgreSQL por defecto cuando se asigna un
propietario a la base de datos, y que identifica a dicho propietario.

12
.3. Propietario

(Owner)
:
PostgreSQL muestra en una

lista desplegable los roles de usuario que pueden
ser propietarios o “creadores” de la base de datos. En este caso, el Administrador selecciona un rol con
permisos de creación de objetos de base de datos creado previamente, y llamado
igac.

12.4. Codificac
ión (Encoding):
El sistema de codificación de la base de datos es importante, ya que no
todos los sistemas son compatibles con objetos geográficos. Para este caso, el Administrador selecciona de
la lista desplegable la codificación
LATIN1
.

12.5. Plantilla
(Template):
Para hacer la base de datos compatible con el modelo de datos para objetos
geográficos, el Administrador debe seleccionar la plantilla
template_postgis
, que proporciona PostGIS,
para que por defecto se establezcan unas tablas que darán soporte
a los archivos geográficos que se
cargarán.

12
.6. Espacio de tablas (Tablespace):
Como se ha mencionado en el numeral 7.2.1. de este flujo de
eventos, el Administrador puede escoger un espacio de tablas para que la información de configuración de
la base
de datos quede guardada en ese directorio. Si se ha creado un espacio de tablas previamente, éste se
mostrará en la lista desplegable. Si no, podemos tomar el espacio de tablas por defecto llamado
pg_default.

12.7. Restricción de Esquema (Schema restricti
on):
PostgreSQL asocia la nueva base de datos con un
esquema por defecto público llamado
public
. No es necesario ingresar una restricción al respecto, por lo
que este campo no se modifica.

1
2
.8. Comentarios (Comment):
Pueden escribirse comentarios sobre l
a configuración de la base de datos.
No es indispensable.

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


33


13.

El Administrador

hace clic en el botón OK.

14.

El proceso de carga de datos se realizará por comandos en la consola de Windows. Sin embargo, se
recomienda dejar abierto pgAdminIII.

15.

Diríjase al menú de

Accesorios, y luego Símbolo del Sistema. También puede acceder a la consola de
comandos mediante la herramienta Ejecutar, con el comando
cmd.

16.

Una vez dentro de la consola de comandos, se tendrá una pantalla como esta:


Figura
8
.

Consola de Windows

Allí
el Administrador

escribe el comando
shp2pgsql

y
da enter. La consola debe mostrar las diferentes
opciones para este comando. Esto sólo es posible si se ha configurado previamente la variable de entorno
para PostgreSQL, como se menc
ionó en el numeral 3 de este flujo de eventos. Esto permite que el sistema
reconozca este comando sin necesidad de ubicarse en el directorio donde se encuentran los archivos
binarios de PostgreSQL. Se procede entonces a ejecutar la sentencia de código que
permitirá cargar un
archivo geográfico.

17.

La sentencia es mostrada en la siguiente pantalla:


Figura

9
. Sentencia de código para subir un archivo de extensión .shp a la bd

Los parámetros de la anterior sentencia son los siguientes
:

17
.1.
shp2pgsql:

Comando que me permite leer el contenido del archivo .shp especificado y escribirlo
luego en lenguaje pgsql.

17
.2. “C:
\
...archivo.shp”

(Para este caso: “
C:
\
Luis
\
Idecan
\
Datos
CAN
\
COLOMBIA
\
transporte
\
vias
\
roadl.shp”)
:
Ruta hacia el direc
torio donde se encuentra el archivo
.shp que será cargado a la base de datos.

17
.3. nombre_tabla

(Para este caso: via):
Nombre que tendrá el archivo como tabla, en la base de datos.

17
.4.
-
I:
Crea

un índice GiST en la columna que contiene la geometría.

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


34


1
7
.5.
-
s:

Define
el atributo identificador del Sistema de Referencia Espacial. Para este caso, todos los
archivos se trabajan con el sistema de referencia 4326.

17
.6. |:
Separador para indicar que termina la instrucción del comando shp2pgsql, y dar paso a
la
instrucción en psql.

17
.7. psql:

Comando que permite opciones de lenguaje estructurado sobre la base de datos. En este caso
permitirá especificar ciertos parámetros de la base de datos.

17.8.
-
d:
Especifica el nombre de la base de datos a la cual se va

a conectar, y en donde se crearán las
nuevas tablas a partir de los archivos .shp.

17
.9.
-
U:
Especifica el nombre del usuario propietario de la base de datos. Solicita la contraseña para este
usuario, si la tiene.

18.

Al ejecutar la sentencia, se tiene el si
guiente resultado:


Figura
10
. Ejecución de la sentencia de código

Esto muestra la inserción de los datos alfanuméricos en la base de datos
idecan.

19.

Se puede verificar que el archivo .shp ha sido cargado exitosamente, revisando
en
pgAdminIII

el
contenido de la base de datos.

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


35



Figura
11
. Verificación de la nueva tabla en la bd

20.

Se repiten estas instrucciones desde el numeral 15 de este flujo de eventos, para cargar a la base de datos
los archivos .shp qu
e necesite mostrar luego en el Mapa Regional Andino.

21.

De esta forma se ha realizado el cargue exitoso de capas de información del Mapa Regional Andino en la
base de datos de PostgreSQL.

22.

Luego de haber
cargado las capas geográficas a la base de datos, esta
queda preparada para poder ser
accedida por cualquier cliente de escritorio. Además, la base de datos
idecan

quedará configurada para ser
utilizada por el Visor de Mapas del Geoportal de la IDECAN.

6.2

Generación del Mapa Regional Andino

Una vez se ha construi
do y configurado la base de datos con los archivos proporcionados,
se

procede a visualizar el
mapa que ha construido mediante un cliente de escritorio con soporte para bases de datos geográficas.

1.
El Administrador

accede al cliente de su preferencia. Pa
ra este caso, se ha escogido gvSIG como cliente
de prueba para la conexión a la base de datos del Mapa Regional Andino; 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
. Una vez iniciado, gvSIG mostrará la pantalla de inicio. Allí el
Administrador

selecciona en el Gestor de
Proyectos la opción Vista, y hace clic en el botón Nuevo.

3. Esto desplegará una nueva Vista que se podrá configurar, para tener acceso a la base de
datos.
El
Administrador

hace clic en el botón de Propiedades para configurar las propiedades de la Vista.

Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


36


4.
El Administrador

tiene acceso a configurar las propiedades de Nombre de la Vista, Propietario, Unidades
del Mapa, Unidades de Medida, Proyección A
ctual, Comentarios, Color de fondo.

5. Una vez configurada la vista,
el Administrador

hace clic en el botón Abrir, para desplegar la Vista vacía.

6.
El Administrador

puede añadir a la Vista una capa desde diferentes opciones, seleccionando en el menú
Vist
a

Añadir capa, o directamente desde el botón Añadir Capa de la barra de herramientas de gvSIG.

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 un
a base de datos

Georeferenciación.

Anotación.

WMS.

WCS.

ArcIMS.

WFS.

El Administrador

selecciona la pestaña GeoBD para configurar la conexión a la base de datos.

8. gvSIG muestra una ventana al Administrador, en donde puede ver los siguientes elementos:

8.
1.

Elija conexión:

Mostrará en una lista desplegable las conexiones configuradas previamente.

8.2.

Botón Añadir conexión:

Por medio de este botón, que nos muestra una nueva ventana, el
Administrador podrá configurar la nueva conexión, teniendo en cuenta l
os siguientes parámetros:

8.2.1.

Nombre de la conexión:

El Administrador da un nombre a la conexión que va a configurar.
Este nombre sólo lo tendrá en cuenta gvSIG para mostrarlo en el campo Elija conexión. Para este
caso el nombre de la conexión será
idec
an
.

8.2.2.
Driver:

Muestra en una lista desplegable los drivers de conexión a la base de datos
disponibles en gvSIG. Como la base de datos está en PostgreSQL+PostGIS, el Administrador
selecciona el driver PostGIS JDBC Driver.

8.2.3.
Url del Servidor:
Por
defecto, la configuración en la base de datos apunta a un sitio local,
por lo que generalmente este parámetro tiene el valor de
localhost
o

la dirección ip local de la
máquina; en caso de que la base de datos esté en un equipo remoto, se debe colocar la ip

del
equipo remoto. Para este caso, el url será
localhost
.

8.2.4.
Puerto:
Por defecto, la configuración de PostgreSQL trabaja sobre el puerto 5432; sin
embargo, si en su configuración se ha especificado otro puerto, debe escribirse el número del
puerto cor
respondiente.

8.2.5.
Nombre de BD:

Se especifica el nombre de la base de datos que reside en PostgrSQL. Debe
ser el nombre exacto de la base de datos.

8.2.6.
Usuario:
Nombre del usuario propietario de la base de datos en PostgreSQL. Para este caso
Geoportal IDECAN


Versión: 1.0

Manual de
Desarrollo

Visor de Mapas


Fecha: 28
/03/08




<Company Name>
,
2013


37


será
i
ga
c.

8.2.7.
Clave:
Contraseña del usuario propietario de la base de datos en PostgreSQL. Para este caso
será
igac.

8.2.8.
Conectado:
Botón de chequeo para conectarse automáticamente a la base de datos.

Un
a vez configurados estos parámetros, el Administra
dor tendrá acceso a la base de datos del Mapa
Regional Andino. Se mostrarán entonces en gvSIG los siguientes campos:

8.3.

Elija tabla:
Muestra al Administrador las tablas que quiere visualizar en el mapa. El
Administrador puede añadir todas las capas que
ha cargado en la base de datos, pero
no

debe añadir
las tablas propias del soporte geográfico de PostGIS, llamadas
geometry_columns, pg_ts_cfg,
pg_ts_cfgmap, pg_ts_dict, pg_ts_parser, y spatial_ref_sys
,
ya que
estas tablas no contienen
información que se p
ueda visualizar, pero son fundamentales dentro del modelo de datos geográfico.
Al seleccionar una capa, se activan los siguientes campos:

8.4.
Columnas de la tabla:
Aquí se observan todos las columnas, campos o atributos que posee la
capa, como identifica
dor, nombre o geometría. El Administrador puede seleccionar los que desee,
además de poder seleccionar Todos o Ninguno.

8.5.
Especificación de la capa:
gvSIG muestra la información básica de la capa, tal y como está en
la base de datos: Nombre, Proyección

Actual, campo identificador, campo de geometría. El
Administrador puede insertar una restricción con un fragmento de código en lenguaje SQL, y
también puede especificar una Zona de interés mediante un bounding box válido. Estos dos últimos
parámetros son
opcionales.


9. Una vez el Administrador ha configurado los anteriores parámetros, da clic en el botón Aceptar.

10. gvSIG permitirá al Administrador visualizar las capas del Mapa Regional Andino que ha seleccionado,
y de esta forma se probará la configura
ción exitosa de la base de datos y del cargue de los archivos .shp.


11. De esta forma se ha generado el Mapa Regional Andino a escala 1:1’000,000.