Openlayers: configuración con biblioteca en el servidor local

=OpenLayers: configuración de la biblioteca en el servidor local=

Descarga del fichero
Desde la página oficial de OpenLayers se encuentra el link a la versión estable ("stable"). Actualmente la versión estable es la 2.7:
 * http://www.openlayers.org/download/OpenLayers-2.7.zip



Una vez bajado el fichero lo podemos descomprimir y copiar en la carpeta web de nuestro entorno :


 * C:\ms4w\apps\mapserv-demo\

A continuación renombramos la carpeta:


 * C:\ms4w\apps\mapserv-demo\OpenLayers-2.7

por


 * C:\ms4w\apps\mapserv-demo\openlayers



Crear la página de prueba
Con un editor vamos creando el fichero:


 * C:\ms4w\apps\mapserv-demo\ol-local.html

El código que le vamos a poner será el siguiente:

 OpenLayers con biblioteca en local  #map { width: 512px; height: 512px; border: 1px solid black; }     var map, layer; function init{ map = new OpenLayers.Map( 'map',{ 					maxExtent: new OpenLayers.Bounds(378107,5193120,510896,5320243), 					maxResolution: 'auto', 					units: "m", 					projection: "EPSG:26915"} 				); layer = new OpenLayers.Layer.WMS( "OpenLayers WMS",                   "http://localhost:9000/cgi-bin/mapserv.exe?map=/ms4w/apps/mapserv-demo/itasca.map", {layers: 'drgs'} ); map.addLayers([layer]); map.zoomToMaxExtent; }   Ejemplo de WMS Uso básico de OpenLayers con una capa WMS y la librería en local más texto aquí

Comprobar la página de prueba
El enlace web local será:


 * http://localhost:9000/mapserv-demo/ol-local.html



Todo lo que hay que notar en nuestro código
La verdad es que desde el ejemplo con biblioteca en remoto no ha cambiado mucho salvo la llamada a la biblioteca.

En lugar de que: hemos puesto:

Este cambio puede parecer banal pero nos permite controlar todo el código que ofrecemos en nuestra aplicación web. Es decir, todas las imágenes, los textos y el código JavaScript que un usuario baja desde nuestra página web está totalmente bajo nuestro control.

Una de las consecuencias negativas de utilizar la biblioteca en remoto es, por ejemplo, si los programadores de OpenLayers actualizan la biblioteca y cambian una de las funciones que estamos utilizando, puede que nuestra aplicación no funcione o simplemente funcione diferente de los que esperamos.

Otra consecuencia desagradable se deriva de un posible mal funcionamientos del servidor de OpenLayers.org, en cuyo caso no ofrecería la biblioteca y por lo tanto nuestra aplicación también dejaría de funcionar.

Otra importante nota es relativa a la accesibilidad de nuestra página web. Una de las características más importantes de una página web de éxito es que se pueda bajar rápidamente. La biblioteca de OpenLayers por completo, tal y como la hemos descargado, ocupa 560KB en su versión más compacta (trataremos este tema más adelante). A este valor hay que añadirle el peso de las imágenes del mapa y de las imágenes del diseño gráfico del sitio web. Todo esto va a producir una página web muy pesada si lo que queremos es simplemente mostrar un mapa sencillo que se pueda navegar. A continuación explicaremos cómo reducir el peso de la biblioteca manteniendo las funciones que nos interesan.



Crear el fichero comprimido
En la distribución de OpenLayers existe un carpeta que se llama build. Adentro se encuentran unos ficheros escritos en el lenguaje de programación python que nos permiten crear la biblioteca como mejor nos convenga.

Antes que nada hay que instalar el entorno de ejecución Python for Windows que se puede descargar desde el sitio web de Python

Una vez nos desplazamos a la carpeta build vamos a encontrar unos ficheros que nos van a ser muy útiles para crear la biblioteca personalizada. En esta encontramos:
 * el fichero build.py que lee los ficheros de configuración, limpia el código de todos los comentarios y los espacios blancos inútiles y pone todo en un único fichero (OpenLayers.js</tt>).
 * los ficheros .cfg</tt> de configuración donde está escritos qué librerías hay que poner en la biblioteca.

Editamos lite.cfg</tt> y le cambiamos el nombre en custom.cfg</tt> y guardamos el fichero. Ahora vamos a abrir IDLE (la GUI de Python, disponible en Inicio->Todos los programas->Python->IDLE) y, con él, abrimos el fichero build.py</tt>. En la linea 20, cambiamos: por
 * configFilename = "full.cfg"</tt>
 * configFilename = "custom.cfg"</tt>

Desde el menú Run escogemos el comando Run Module. Este comando ejecuta el script y al final vamos a encontrar en la misma carpeta build un fichero OpenLayers.js</tt> que respeta el contenido de nuestro fichero de configuración custom.cfg. Este fichero pesa ahora 111KB, una buena mejoría para las prestaciones de nuestra página web. Para probarlo sólo hay que copiar este OpenLayers.js</tt> en la carpeta:


 * C:\ms4w\apps\mapserv-demo\openlayers</tt>

Ahora podemos comprobar su funcionamiento recargando nuestra página web:


 * http://localhost:9000/mapserv-demo/ol-local.html

Añadir librerías a nuestra biblioteca
Nuestra página web ol-local.html ofrece un mapa muy sencillo, faltan, por ejemplo, las herramientas de navegación. ¿Qué pasa si añadimos el control PanZoomBar a nuestro mapa?

para añadir el control hay que insertar este codigo antes que llamar la función zoomToMaxExtent:

map.addControl(new OpenLayers.Control.PanZoomBar);

Este es el codigo de nuestra pagina: <html xmlns="http://www.w3.org/1999/xhtml"> OpenLayers con biblioteca en local <style type="text/css"> #map { width: 512px; height: 512px; border: 1px solid black; }   <script src="openlayers/OpenLayers.js"> <script type="text/javascript"> var map, layer; function init{ map = new OpenLayers.Map( 'map',{ 					maxExtent: new OpenLayers.Bounds(378107,5193120,510896,5320243), 					maxResolution: 'auto', 					units: "m", 					projection: "EPSG:26915",					controls:[]					} 				); layer = new OpenLayers.Layer.WMS( "OpenLayers WMS",                   "http://localhost/cgi-bin/mapserv.exe?map=/ms4w/apps/mapserv-demo/itasca.map", {layers: 'drgs'} ); map.addLayers([layer]); map. addControl(new OpenLayers.Control.PanZoomBar); map.zoomToMaxExtent; }  <body onload="init"> Ejemplo de WMS Uso básico de OpenLayers con una capa WMS y la librería en local más texto aquí

Lo que resulta es un error. Si podéis ver la ventana de debug os dirá:

OpenLayers.Control is undefined</tt>

Lo que tenemos que hacer es añadir a nuestra biblioteca las librerías justas para que PanZoomBar se encuentre entre los comandos disponibles.

Editamos custom.cfg</tt> y lo vamos a poner con este texto:

Las últimas tres líneas del include ponen los ficheros que OpenLayers necesita para visualizar el PanZoomBar.

Nos queda lanzar otra vez el comando run module del build.py y esperar que complete su trabajo. Ahora podemos copiar otra vez el fichero OpenLayers.js</tt> adentro de la carpeta:


 * C:\ms4w\apps\mapserv-demo\openlayers</tt>

Ahora si volvemos a nuestra página web debería aparecer el control PanZoomBar correctamente.

Cualquier librería que queramos añadir a nuestra biblioteca tiene que pasar por el custom.cfg</tt>, en la sección [include], y luego por la ejecución del build.py</tt>.



referencias
=Autores=
 * Lorenzo Becchi
 * Jorge Gaspar Sanz Salinas
 * Bamboo sheets

=Licencia=
 * la licencia por este articulo es: Creative Commons Attribution 3.0 License (http://creativecommons.org/licenses/by/3.0/deed.es).
 * esta licencia permite:
 * copiar, distribuir y comunicar públicamente la obra
 * hacer obras derivadas
 * bajo estas condiciones:
 * Reconocimiento. Debe reconocer los créditos de la obra de la manera especificada por el autor o el licenciador (pero no de una manera que sugiera que tiene su apoyo o apoyan el uso que hace de su obra).
 * Al reutilizar o distribuir la obra, tiene que dejar bien claro los términos de la licencia de esta obra.
 * Alguna de estas condiciones puede no aplicarse si se obtiene el permiso del titular de los derechos de autor
 * Nada en esta licencia menoscaba o restringe los derechos morales del autor.

=Duración= Por esta clase se evalúa una duración de X oras