Este FAQ (Frequently Asked Questions) pretende facilitar la configuración del cliente web p.mapper. Si bien los tips se encuentran en su página oficial, quienes han configurado p.mapper de forma básica estarán de acuerdo en que la documentación podría estar mejor organizada. Algunas veces es necesario aplicar lo que se dice en un par de páginas antes de obtener lo que se busca. Por eso, a continuación se disponen a manera de preguntas comunes, algunos apartes de la configuración básica de p.mapper.

Cabe aclarar que ciertos temas son exclusivos (si, son bugs) de la versión actual de p.mapper (4.0.0) y se espera que en próximas versiones estén corregidos del todo. Sin más preámbulo...

FAQ de configuración de p.mapper

==== LAYOUT ====

• ¿Dónde edito el título de la página web principal de la aplicación?

  En la etiqueta <pmTitle> del archivo principal de configuración (config\config_default.xml).

• ¿Dónde personalizo el banner de la aplicación?

Puedes definir el logo principal y cambiar el título del banner en la función pmHeader() del archivo incphp\uielement.php

• ¿Cómo defino el idioma de los textos de la interfaz?

Debes editar el archivo config\config_default.xml en la etiqueta <defaultLanguage>. Por ejemplo, el idioma español se obtiene así: <defaultLanguage>es</defaultLanguage>.

• Después de definir el idioma a español, obtengo palabras extrañas como '&aacute;' en la interfaz de p.mapper.

Para corregirlo, edita el archivo incphp\locale\language_es.php y reemplazar los &aacute; por 'á', los &eacute; por 'é' y así sucesivamente.

• ¿Dónde puedo editar los colores de fondo de la interfaz de la aplicación?

Para ello debes editar los siguientes archivos CSS:

+templates\layout.css: Agregar a las líneas 64 y 86 algo como background-color:#004477;

+ templates\jquery.layout.css: Agregar a la línea 43 background-color:#ffdd33;

• ¿Cómo puedo definir otro estilo de botones para la interfaz?

Para ello puedes cambiar el nombre de la carpeta de íconos a default. Las carpetas de estilos para los botones se encuentran en images\buttons\

==== COORDENADAS DEL CURSOR  ====

• ¿Cómo puedo cambiar las etiquetas para las coordenadas X y Y por Longitud y Latitud?

Edita el archivo javascript\pm_cjs.js en las funciones:

PM.ZoomBox.xCoordCont.html('Longitud: '+px);

PM.ZoomBox.yCoordCont.html('Latitud: '+py);

• ¿Cómo defino el número de decimales de las coordenadas del cursor?

Edita el archivo javascript\pm_cjs.js de tal manera que la variable coordsDisplayRfactor tenga el valor correspondiente al número de decimales que deseas.

==== HERRAMIENTA DE MEDICIÓN ====

• ¿Dónde defino las unidades y el factor para el despliegue de distancias y áreas?

Edita el archivo config\default\js_config.php en la línea:

PM.measureUnits = {distance:" [km.]", area:" [km&sup2;.]", factor:0.00898315};

El factor que se ha definido (0.00898315) sirve para calcular la distancia en kilómetros y el área en kilómetros cuadrados para un mapa con coordenadas geográficas del sistema de referencia WGS84.

==== PUNTOS DE INTERÉS =====

• La herramienta de puntos de interés no funciona correctamente. ¿Qué puede pasar?

Debes incluir las fuentes FreeSans en el archivo de fuentes enlazado por el mapfile de la aplicación.

==== TRANSPARENCIA DE IMÁGENES EN LA TABLA DE CONTENIDO ====

• Los íconos de las imágenes para la simbología de puntos en la tabla de contenido no tienen transparencia. ¿Dónde la habilito?

En el archivo mapfile agrega la sentencia TRANSPARENT ON en la sección MAP.

==== SLIDER ZOOM ====

• Tengo grados decimales como unidad en el mapa. El control Slider Zoom falla para la versión 4.0.0 de p.mapper y la 5.6 de MapServer.  ¿Qué puedo hacer?

+ Edita en el archivo config\config_default.xml las etiquetas <sliderMax> y <sliderMin>.

Ejemplo: <sliderMax>max</sliderMax> y <sliderMin>25000</sliderMin>

+ Edita en el archivo incphp\init\initmap.php las líneas 626 y 645 así:

Línea 626: $y_dgeo_m = ($this->mapUnits == 6 ? $y_dgeo * 111120 : $y_dgeo);

Línea 645: $dgeo['c'] = $this->map->units == 6 ? 111120 : 1;

En este último punto se cambian las unidades de 5 a 6, esto se debe a que en UMN MapServer el valor 5 estaba asociado a las unidades de grados decimales (dd). Sin embargo, en la versión 5.6 de UMN MapServer se ha adicionado la unidad de millas náuticas. Esto puede verificarse en la página web http://mapserver.org/mapfile/map.html en la sección Units.

==== CONSULTAS ====

• ¿Cómo defino explícitamente la codificación de las capas en el mapa?

En el archivo mapfile agrega a cada capa:

METADATA

"LAYER_ENCODING" "UTF-8"

END

• ¿Dónde puedo definir alias para los campos mostrados como resultado de consultas?

En el archivo mapfile agrega a cada capaen la etiqueta METADATA:

"RESULT_FIELDS" "nombre_campo1,nombre_campo2"

"RESULT_HEADERS" "alias_campo1,alias_campo2"

• ¿Es posible seleccionar un subconjunto de campos a mostrar como resultado de consultas?

Si es posible, se hace con las mismas etiquetas de la pregunta anterior.

• En los resultados de las consultas, la herramienta Zoom al registro no funciona. ¿Qué debo hacer?

Debes agregar a cada capa en el mapfile la siguiente etiqueta (claro, si el sistema de referencia de tu mapa es WGS84):

PROJECTION
"+proj=longlat +ellps=WGS84 +datum=WGS84 +no_defs  no_defs"
END

• ¿Cómo defino el extent cuando se realiza un Zoom a elementos tipo punto?

Edita la etiqueta <pointBuffer> en el archivo config\config_default.xml

• Las herramientas identify y selección espacial no funcionan en la versión 4.0.0 de p.mapper y 5.6 de UMN MapServer. ¿A qué se debe?

Se debe a un bug en p.mapper. Por ahora, es posible corregirlo descargando 6 archivos desde http://svn.pmapper.net/trac/changeset/952 y reemplazándolos en sus respectivas carpetas.

+ incphp/common.php  
+ incphp/group.php  
+ incphp/init/initmap.php  
+ incphp/initgroups.php  
+ incphp/map/map.php  
+ incphp/query/squery.php

Si tienes alguna pregunta que consideres que puede hacer parte de este FAQ coméntanosla, si bien no somos gurús en el manejo del programa, hay unos cuantos p.mapperos por acá que te podrán ayudar.