project logo

Mapbender Guía de Inicio Rápido

Mapbender es un entorno de geoportales basado en la web que permite publicar, registrar, ver, navegar, controlar y garantizar el acceso seguro a servicios de Infraestructura de Datos Espaciales.

Las interfaces de administración fortalece la gestión de los administradores quienes necesitan mantener y clasificar los servicios web de mapas y de fenómenos, y permitir el acceso a personas, grupos y otros servicios.

Usted no necesitará nada más que un navegador web estándar para esta guía de inicio rápido.

Esta guía de inicio rápido describe como:

  • iniciar Mapbender
  • crear una aplicación
  • cargar un Web Map Service (OGC WMS)
  • configurar un servicio WMS
  • crear una aplicación individual
  • crear un usuario y un grupo y asignarles aplicaciones
  • cargar un Web Feature Service (OGC WFS)
  • configurar tipos de elementos o fenómenos y crear una aplicación con opción de búsqueda contra un WFS y funcionalidades de digitalización (vectorización).

Iniciar Mapbender

  1. Seleccione Mapbender del menú de Inicio
  2. La aplicación tomará unos pocos momentos en levantar

Si tiene algunas dificultades al ejecutar Mapbender, por favor verifique que su servidor web Apache y su gestor de base de datos PostgreSQL están ejecutándose.

Página de Bienvenida

  1. Antes de que usted pueda comenzar a trabajar con Mapbender usted debe ingresar un usuario o loguearse para tener acceso a las aplicaciones.
  2. La página de bienvenida provee enlaces a las páginas web mas importantes relacionadas con Mapbender.
  3. Usted puede ingresar con el usuario root y la contraseña root (estos son los usuarios y contraseña por defecto que usted tendrá una vez instalado Mapbender). Por favor, cambie la contraseña del usuario root si desea ejecutar Mapbender en un ambiente de producción. Por favor, no elimine el usuario root ya que este usuario tienen acceso a las plantillas de aplicaciones de Mapbender y es usado para las actualizaciones de versiones.
images/screenshots/800x600/mapbender_welcome.png

Luego de haber ingresado satisfactoriamente será dirigido directamente a la application overview.

Vista de Aplicaciones

Después de ingresar a Mapbender, usted será direccionado a application overview con una lista de aplicaciones a las cuales tendrá permisos para acceder. En Mapbender usted tiene aplicaciones de plantillas, que puede utilizar para crear sus propias aplicaciones.

images/screenshots/800x600/mapbender_application_overview.png

Mapbender provee

  • aplicaciones de administración
  • aplicaciones de mapas
  • aplicaciones de contenidos

Las aplicaciones son listadas en categories. Luego usted puede definir sus propias categorías y agregar sus aplicaciones a las categorías que usted desee.

Aplicaciones de Administración

Administration applications le permite por ejemplo, cargar servicios, crear usuarios, crear nuevas aplicaciones.

Cada administration application provee diferentes funcionalidades. Después usted puede configurar su propia administration application con las funcionalidades que sean necesarias.

Luego de la instalación de Mapbender, el usuario root tiene acceso a:

  • ADMINISTRATION, ADMINISTRATION_DE - WMS, WFS, application, user/group, handling (nuevo para la version 2.7)
  • admin2_en - WMS, application, user/group handling
  • admin_en_services - se centra en el manejo de servicios WFS y Metadatos y en la configuración de OWS-Proxy.
  • admin1 - plantilla que contiene todos los elementos de administración
  • admin_wms_metadata, admin_wfs_metadata, admin_wmc_metadata - metadata handling

Tip

Mapbender cuenta con interfaz de administración en inglés y alemán. Actualmente se está traduciendo al español. Los lenguajes de las interfaces de administración nos lo indica el sufijo “en” para inglés y “de” para alemán.

La siguiente imagen muestra la interfaz admin2_en. En el lado izquierdo se puede ver el menú con las opciones que esta aplicación ofrece.

images/screenshots/800x600/mapbender_admin2_en.png

Tip

Para ir “atrás” o “volver” a la vista principal de aplicaciones utilice el botón HOME ir a casa.

Aplicaciones de Mapas

Las aplicaciones de mapas contienen servicios OGC de tipo WMS, uno o más mapas, botones, un explorador de geodatos, un elemento de leyendas, tu propio logotipo y más.

  1. Seleccione una aplicación de mapas by click desde la application overview

  2. Conozca Mapbender y las funcionalidades que estas aplicaciones ofrecen.

    • seleccione por ejemplo de GUI, gui_digitize
    images/screenshots/800x600/mapbender_gui_digitize.png

Tip

Si su navegador web soporta pestañas, usted puede abrir las aplicaciones en pestañas y fácilmente desplazarse entre ellas.

Aplicaciones que contienen WMS

Usted puede crear una aplicación de contenidos que contenga su servicio OGC WMS. Tener el servicio WMS contenido o almacenado en una aplicación Mapbender no implica que sea desplegado de forma automática. Con el concepto de “contenedores” usted puede crear un sofisticado repositorio de servicios web de mapas.

images/screenshots/800x600/mapbender_container.png

Crear una aplicación individual

  1. Vaya a la aplicación de administración admin2_en
  2. Seleccione Application Management ‣ Create new application
  3. Defina un nombre y descripción para su aplicación y seleccione el botón new para crear la aplicación (geoportal)
  4. Vaya al enlace Application Management ‣ Edit application elements y seleccione la nueva aplicación
  5. En la casilla de selección en la parte superior seleccione una aplicación que le guste para usar como plantilla y haga clic en el botón add all elements. Este proceso tomará todos los elementos desde la aplicación que usted seleccionó y los cargará en SU aplicación nueva.
  6. También podría seleccionar un solo elemento desde otra aplicación y cargarlo en la suya nueva. Seleccione el elemento de forma individual activando el óvalo del elemento y haciendo clic en botón save para salvar este elemento nuevo en su aplicación.
  7. Su aplicación está configurada. Ahora necesita un WMS que se muestre en su aplicación. Esto se describe en la sección de Gestión de WMS: WMS Management.

Copiar o renombrar una aplicación

También puede crear una nueva aplicación mediante la copia de una aplicación existente. Para ello, vaya a Application Management ‣ Rename/copy application, seleccione la aplicación que desea copiar y defina un nombre para la nueva aplicación. Esta funcionalidad no sOlo copia la aplicación, también copia los servicios de la aplicación original y los usuarios/grupos (opcional). Esto significa que la nueva aplicación ya tiene servicios de mapas y que los respectivos usuarios/grupos tienen acceso a la nueva aplicación producida a partir de la copia de una existente.

Eliminar una aplicación

Puede eliminar una aplicación con Application Management ‣ Delete application. Sólo la aplicación es eliminada, no los servicios que formaban parte de ella (p.e WMS/WFS). No está permitido eliminar aplicaciones que también pertenecen a otros usuarios.

Exportar una aplicación

Puede exportar una aplicación usando un script SQL con Application Management ‣ Export application (SQL). El script SQL contiene todas las definiciones de los elementos de la aplicación y se pueden importar en otra instalación de Mapbender (en otro servidor).

Tip

La exportación de una aplicación de geoportal en Mapbender con SQL no conlleva la exportación de la información de los servicios ni la información sobre los usuarios y grupos que contiene la aplicación de origen.

Gestión de WMS

Cargando un Web Map Service

Usted puede cargar servicios OGC Web Map Services (WMS) a su aplicación.

Un WMS devuelve un archivo XML cuando se solicita el documento getCapabilities. Esta información es analizada por Mapbender y Mapbender obtiene toda la información necesaria sobre el servicio de este archivo XML

Tip

Usted podría inicialmente verificar el documento de capacidades o Capabilities del servicio WMS en su navegador web antes de tratar de cargarlo con Mapbender

  1. Vaya a admin2_en y seleccione WMS Management ‣ Load WMS. Seleccione la aplicación la cual contendrá el WMS. Escriba el enlace a la dirección web del WMS getCapabilities en el campo de texto y seleccione cargar Load.
  2. Aquí tiene algunos ejemplos de WMS los cuales puede cargar en su aplicación:

Usted puede cargar más de un WMS en una aplicación o geoportal. Seleccione WMS application settings para cambiar el orden de carga de los WMS o eliminar un WMS de su aplicación.

El WMS con el índice 0 define el valor por defecto del sistema de referencia y los valores límite del extendido del mapa.

Tip

Cree una aplicación contenedora de servicios y cargue todos los WMS una sola vez a esta aplicación contenedora. Usted puede transferir el WMS desde esta aplicación para otras aplicaciones. Al actualizar un servicio WMS los posibles cambios aparecerán en todas las aplicaciones que contienen ese servicio WMS. Usted puede copiar fácilmente un WMS de una a otra aplicación con la entrada del menú * Link WMS de la aplicación *

Configurar un WMS

Después de cargar un servicio WMS usted puede configurarlo para su aplicación específica. Tal vez usted no desea servir todas las capas o desea cambiar el orden o títulos de la capa o desactivar la función de “información” o cambiar las escalas de visualización para una capa.

images/screenshots/800x600/mapbender_wms_application_settings.png
  • on/off - activar/desactivar una capa para esta aplicación o geoportal
  • sel - hacer elegible en el explorador de datos geográficos
  • sel_default - la capa es activada por defecto cuando la aplicación inicia
  • info/info default - la capa provee respuesta a solicitudes de información de los elementos o fenómenos, info default activa por defecto esta funcionalidad para una capa
  • minscale/maxscale - define el rango de escalas dentro de los cuales la capa será desplegada; valor cero (0) significa que tiene limitaciones
  • style - si un servicio WMS provee mas de un estilo usted puede seleccionar uno de los diferentes estilos proveídos como “estilo por defecto”
  • prio - define el orden en el cual las capas serán dibujadas o cargadas
  • setWFS - conecta una capa de un servicio WMS a la configuración de tipos de fenómenos de la misma capa en un servicio WFS (usted podrá aprender mas sobre esta funcionalidad luego)

Configure su aplicación

Ahora usted debería tener una idea de lo fácil que es cambiar una aplicación o personalizar un geoportal en Mapbender sin cambios en el código fuente.

Cuando se selecciona un elemento, por ejemplo mapframe1 haciendo clic en el óvalo, puede ver que el elemento tiene una gran cantidad de atributos. Estos atributos son atributos HTML. Al definir un elemento en Mapbender usted define un elemento HTML. Al iniciarse la aplicación o geoportal Mapbender creará una página HTML con todos los elementos definidos previamente.

  • id - nombre único para el elemento
  • on/off - activar/desactivar un elemento
  • title - nombre el cual será desplegado como pestaña o referencia
  • HTML-TAG/CLOSE-TAG - tipo de elemento HTML a crear, por ejemplo div, img
  • top, left - define la posición del elemento (para diseños estáticos)
  • width/height - define el tamaño del elemento

Algunos elementos tienen variables las cuales le permiten al usuario configurar los parámetros de ese elemento. Las variables de los elementos pueden ser de tipo JavaScript, PHP, referencias a archivos CSS o definiciones de texto CSS.

Ejemplos para variables en elementos:

  • el elemento copyright tiene una variable de elemento para establecer el texto de derechos de autor
  • el elemento de información general (mapa general) tiene un elemento variable para definir los WMS se utiliza para el mapa general
  • el elemento treeGDE (explorador de datos geográficos) tiene variables para definir el estilo del explorador de datos geográficos

Inténtelo usted mismo

  • cambie el tamaño del elemento mapframe (elemento mapframe1)
  • cambie la imagen del logotipo - seleccione el logotipo de foss4g - como imagen (elemento logo)
  • defina el color de fondo (elemento body elemento-variable css_class_bg)
  • mueva sus botones (cambie los valores de izquierda y superior (left and top) de sus elementos a otra posición en píxeles)
  • cambie el texto del copyright

Gestión de Usuarios y Grupos

Acceder a Mapbender siempre requiere autenticación. Por lo tanto se requiere de un usuario que tenga permisos para acceder a una o un conjunto de aplicaciones y los servicios (WMS, WFS), que se asignan a estas aplicaciones.

No hay diferencias inherente entre los roles como guest, operator o administrator. El role de un usuario depende de la funcionalidad y los servicios a los que el usuario tiene acceso a través de sus aplicaciones.

Crear un usuario

  1. Para crear un usuario vaya a admin2_en y seleccione User Management ‣ Create and edit user
  2. Seleccione un nombre y una contraseña (name/password) para su usuario.
images/screenshots/800x600/mapbender_create_user.png

Crear un grupo

  1. Para crear un grupo vamos a User Management ‣ Create and edit group. Defina un nombre y una descripción para su grupo.

Asignar aplicaciones a usuarios/grupos

  1. Asigne un usuario a un grupo mediante User Management ‣ Add one user to several groups o con el enlace User Management ‣ Add several users to one group
  2. Asigne una aplicación a un usuario mediante User Management ‣ Allow one user to access several applications
  3. Asigne una aplicación a un grupo con User Management ‣ Allow one group to access several applications

Tip

Si desea conceder a un usuario acceso de escritura a una aplicación tiene que utilizar User Management ‣ Assign to edit an application to a user.

  1. Cierre la sesión de Mapbender con el botón LOGOUT
  2. Iniciar sesión como el nuevo usuario
  3. ¿Qué sucede cuando el usuario tiene acceso a una o más de una aplicación?

Gestión de Servicios WFS

Mapbender es cliente de servicios OGC Web Feature Service WFS 1.0.0 y 1.1.0. Los servicios OGC WFS pueden ser usados en las aplicaciones y/o geoportal Mapbender para diferentes funcionalidades:

  • búsqueda atributiva
  • búsqueda espacial
  • digitalización o vectorización
  • listar información
  • generación de información sobre herramientas
  • descarga de data

Para usar un servicio WFS usted debe cargar el servicio WFS en Mapbender y generar configuraciones de tipo de fenómenos.

Luego usted tiene que permitir el acceso de su nueva configuración de tipo de fenómenos (WFS) a una aplicación antes de poder usarlo.

Si desea crear una aplicación con la opción de digitalización o vectorización de WFS, necesitará de un servicio WFS que soporte transacciones (WFS-T). Por ejemplo, puede utilizar software de servidores de mapas tales como GeoServer o Deegree para establecer un WFS-T.

Cargando un Web Feature Services

El módulo para la configuración de servicios WFS está integrado en la aplicación de administración admin_en_services.

  1. Vaya a admin_en_services y seleccione WFS Management –> Load WFS. Seleccione una aplicación de la lista de aplicaciones. Escriba el enlace URL para obtener el documento WFS getCapabilities en el casilla de texto y seleccione con click Load.

Tip

Usted podría inicialmente verificar el documento de capacidades o Capabilities del servicio WFS en su navegador web antes de tratar de cargarlo con Mapbender.

Demo WFS

http://wms.wheregroup.com/geoserver/wfs?REQUEST=getCapabilities&VERSION=1.0.0&SERVICE=WFS

images/screenshots/800x600/mapbender_loadWFS.png

Crear una configuración de tipo de fenómenos

El siguiente paso es establecer una configuración para un tipo de fenómenos. Después de la configuración y la autorización de acceso a una aplicación, la configuración se puede utilizar en sus aplicaciones.

images/screenshots/800x600/mapbender_configure_WFS_featureType.png

Configuración

  1. primero usted tiene que seleccionar un servicios WFS desde el recuadro de selcción Select WFS. Todos los tipos de fenómenos de este WFS serán listados
  2. seleccione el tipo de fenómeno que usted quiere configurar
  3. después de la selección del tipo de fenómeno un par de campos aparecerán (campos de configuración, campos de atributos)
  4. defina un resumen descriptivo y una etiqueta para su búsqueda
  5. defina el texto que aparecerá en el botón de búsqueda (p.e. ok o buscar)
  6. en las casillas de estilo y de estilo-de-resultados usted puede definirlo con uso de texto-ccs
  7. defina una área (buffer) la cual será usada cuando se haga un acercamiento sobre los objetos que resulten de la búsqueda
  8. seleccione el campo o columna de la geometria (espacial)
  9. search / pos - define las columnas a ofrecer para realizar la búsqueda y el orden (pos de position) en el cual serán listados
  10. minimum_input (Search) - define la entrada mínima de datos para un campo
  11. label - define una etiqueta para la columna de búsqueda
  12. show - define las columnas las cuales usted desea mostrar en la lista de resultados y define la posición de éstas
  13. show_detail - define las columnas las cuales serán desplegarán información detallada en una ventana que provee información por cada objeto en individual
  14. mandatory (digitizing) - la columna o campo ha de ser llenado y nos puede dejarse vacío
  15. edit (digitizing) - define cuales columnas o campos usted, desde ofrecer para ser digitalizados o vectorizados
  16. html - ofrece cuadros de selección (selectbox), búsqueda por fechas, casillas de verificación (checkbox), áreas de texto o de carga de archivos por medio de una campo de captura sencillo
  17. auth - aquí usted puede definir autorizaciones para que los usuarios tengan acceso dependiendo de los objetos y fenómenos
  18. operator - (Search) - define cual operador será usado para la búsqueda
  19. helptext - ++define un texto de ayuda para cada campo.
  20. category - usted puede definir categorías. Los atributos serán asignados a esta categoría y serán desplegados en forma de pestaña con el nombre de la categoría.
  21. save guarda sus preferencias
  22. su configuración tendrá un indentificador de configuración o “configuration id”
images/screenshots/800x600/mapbender_configure_WFS_featureType_attribute_table.png

Asignar una configuración de tipos de fenómenos a una aplicación

Su nueva configuración ha de ser asignada a una o mas aplicaciones. Esto se hace en WFS configuration -> Assign WFS conf to application.

  1. Seleccione su servicio WFS
  2. Seleccione una aplicación
  3. Mueva su configuración para el GUI configuration list ubicado a la derecha
images/screenshots/800x600/mapbender_set_featureType_access.png

Establecer una búsqueda en un WFS

Para hacer compatible una configuración de tipos de fenómenos en una aplicación, vaya a admin_en_services -> Edit application elements seleccione su aplicación y vaya hasta el elemento gazetteerWFS. Seleccione el elemento para editarlo haciendo clic sobre el texto o nombre del elemento, y verá en una nueva ventana que el elemento gazetteerWFS tiene una variable wfsConfIdString. Aquí usted puede listar los identificadores (ids) de sus servicios WFS (separados por coma). En el orden en que se listen serán desplegados los resultados de las búsquedas en la aplicación.

images/screenshots/800x600/mapbender_wfsConfIdString.png

Eche un vistazo de cómo la búsqueda podría aparecer en una aplicación. En este ejemplo hay un recuadro de búsqueda de la izquierda, donde puede buscarse un “Usuario Mapbender”. Usted puede realizar una búsqueda espacial y definir una región para buscar o puede hacer una consulta alfanumérica. Los resultados de la búsqueda se muestran en una tabla de resultados. Al hacer clic en uno de los elementos listados en un resultado, Mapbender hace un acercamiento a la ubicación y la información detallada del objeto es desplegada.

images/screenshots/800x600/mapbender_WFS_search.png

Establecer funcionalidades de digitalización a un WFS

La forma más sencilla de disponer de una aplicación que admita la digitalización o vectorización sobre un servicio WFS es copiar la plantilla gui_digitize. Ahora sólo tiene que conectar una capa del servicio WMS con la configuración tipo de fenómenos. Esto se hace en WMS application settings con el botón set WFS en la lista de capas. Pulse el botón y seleccione el identificador de configuración suyo.

Tip

Asegúrese de que la capa WMS que está conectado con la configuración de tipos de fenómenos del servicio WFS soporta la opción de solicitud de información por elemento. Así es como Mapbender decide si se envía una solicitud getFeature CMA o no

Ahora usted puede buscar con la búsqueda espacial que está del lado derecho, la existencia de objetos los cuales son mostrados en un recuadro de resultados. Los objetos pueden ser actualizados (mover objeto, agregar punto, modificar los atributos, cortar una línea (split), continuar una línea, fusionar polígonos (merge)...). También puede crear nuevos objetos.

images/screenshots/800x600/mapbender_gui_digitize.png

Cosas por intentar

Estos son algunos cambios adicionales para que los intentes:

  1. Intenta cargar algunos WMS en tu aplicación. Trata de configurar tus WMS con Configure WMS access ‣ WMS application settings.
  2. Intenta crear una aplicación individual - cambia de color de fondo, mueve los botones, cambia el tamaño del mapa (elemento mapframe1). Application Management ‣ Edit application elements.

¿Qué sigue ahora?

Estos son solo los primeros pasos en el camino de utilizar Mapbender. Hay muchísimas más funcionalidades que puedes probar.

Proyecto Mapbender:

Encontrarás tutoriales en:

Prueba el tutorial en inglés:

Conoce más de Mapbender en:

Participa del proyecto:

Copyright & Disclaimer