Capas y tipos de activo

Introducción

En Maptainer cada tipo de activo es una capa del mapa: «Luminaria», «Hidrante», «Tubería de abastecimiento»… Los activos de una capa comparten geometría, campos y simbología. La ficha de cada activo y su edición en el mapa se explican en Activos.

El orden habitual para montar una capa nueva es este:

1. Crea la familia, si no existe.
2. Crea la capa con Nueva Capa.
3. Define sus campos con Gestionar campos y marca los identificativos.
4. Carga los activos: con un fichero, con una API REST o dibujándolos en el mapa.
5. Configura la simbología.

Requisitos previos

Las pantallas Activos / Capas y Capas WMS están en el administrador, en el bloque Configuración del menú lateral. Solo las ve el administrador del tenant. Se llega desde el menú de usuario → Ir al administrador.

No hace falta ningún módulo contratado. Algunos bloques solo aparecen con módulos concretos:

La pantalla de capas

Activos / Capas abre la pantalla Tipos de Activos & Capas. Arriba están los botones Gestionar Familias y Nueva Capa, y debajo la lista de capas.

Cada fila muestra:

Para buscar, escribe en Buscar tipo, código o familia….

Para cambiar el orden, arrastra la fila desde el manejador de la izquierda. Sale «Orden actualizado correctamente». La primera capa de la lista se dibuja por encima de las demás en el mapa.

Acciones de cada fila

Los botones de la derecha dependen del tipo de capa. Al pasar el ratón se ve su nombre:

Familias

Las familias agrupan las capas en el panel Capas del mapa. Por ejemplo, «Alumbrado exterior» reúne luminarias y cuadros. Una capa puede no tener familia; entonces sale suelta al final.

Pulsa Gestionar Familias para abrir Gestión de Familias.

Crear una familia

1. Pulsa Nueva Familia.
2. Rellena el Nombre. El resto es opcional:
   • Orden: posición en el listado.
   • Código: una abreviatura de hasta 20 caracteres, como «ELEC».
   • Familia padre: elígela para crear una subfamilia.
   • Descripción.
3. Pulsa Crear familia.

Para crear una subfamilia directamente, pulsa Crear subfamilia (el botón +) en la fila de la familia padre.

Para reordenar, arrastra las filas. Para mover una familia dentro de otra, ábrela con Editar y cambia la Familia padre; sus subfamilias se mueven con ella.

Eliminar una familia

Pulsa Eliminar en su fila y confirma. Sus subfamilias pasan a ser familias raíz y sus capas se quedan sin familia. No se borra ninguna capa ni ningún activo.

Crear una capa

Pulsa Nueva Capa. El formulario Nueva Capa de Activos tiene varios bloques; solo el nombre y la geometría son imprescindibles.

Información básica

Geometría y capa

Elige GEOMETRY solo si la capa mezcla puntos, líneas y polígonos. Una capa Sin geometría no se dibuja: sirve para datos sin posición, como componentes o repuestos. Al elegirla desaparecen los bloques de visualización y aparece Cargar datos, con un CSV.

Visualización

Lecturas de contador

Solo aparece con el módulo de lecturas. La casilla Admite lecturas de contador convierte la capa en medible. Puedes marcarla en el alta, pero los campos a medir se añaden después, desde Editar. Al guardar una capa medible, Maptainer avisa de que falta el campo a medir; pulsa Añadir ahora para abrir Editar. Todo el proceso está en Lotes de lectura.

Cargar geometrías

Puedes cargar los activos en el mismo alta, con un fichero GeoJSON, GeoPackage, Shapefile en .zip o DXF. Funciona igual que Subir archivo geoespacial. Para un DXF, marca Es archivo CAD/DXF y escribe el sistema de coordenadas en Sistema de coordenadas de origen, por ejemplo «EPSG:25830». Se marca solo al elegir un .dxf.

Si la carga falla, Maptainer borra la capa recién creada y muestra el motivo. Corrige el fichero y vuelve a empezar.

Origen de datos externo

Este bloque conecta la capa con una API REST de otro sistema. Se explica en Sincronizar con una API REST.

Guardar

Pulsa Crear capa. Sale «Capa creada exitosamente» y vuelves a la lista. Si has elegido un fichero, una barra muestra el avance de la carga.

Subtipos

Un subtipo es una capa que cuelga de otra en la lista, por ejemplo los componentes de una luminaria. Tiene su propia geometría, sus campos y su simbología: es una capa más. Además, sus activos pueden colgar de un activo de la capa padre: ver Jerarquía de la capa.

1. En la fila de la capa padre, pulsa Crear subtipo de … (el botón +).
2. Se abre Nuevo Subtipo de Activo, con el recuadro DEPENDIENTE DE y el nombre de la capa padre.
3. Rellena el formulario como en Crear una capa y pulsa Crear capa.

Un subtipo puede tener a su vez subtipos; el formulario se titula entonces Nuevo Sub-subtipo de Activo.

La capa padre se cambia después en Editar, en el bloque Jerarquía.

Editar una capa

Pulsa Editar en la fila. Editar tipo de activo tiene los mismos bloques que el alta, salvo la carga de ficheros. A la derecha, una tarjeta resume la capa: familia, caché y si se carga al inicio.

Cambia lo que necesites y pulsa Guardar cambios. Sale «Tipo de activo actualizado exitosamente».

En las capas medibles, aquí se crean y editan los campos a medir: ver Lotes de lectura.

Jerarquía de la capa

El bloque Jerarquía dice de qué capas pueden colgar los activos de esta. Una capa puede tener varias capas padre, por ejemplo una bomba que cuelga de una estación de bombeo o de un depósito.

1. Pulsa Añadir capa padre y elige la capa en Cuelga de.
2. En Máximo, escribe cuántos activos de esta capa caben bajo un mismo padre, por ejemplo 3 palas por rotor. Vacío es sin límite.
3. Marca Obligatorio si todo activo de esta capa tiene que colgar de uno.
4. Quitar borra la fila. Pulsa Guardar cambios.

Sin ninguna capa padre, la capa no tiene jerarquía y sus formularios no piden Cuelga de. Una capa no puede colgar de sí misma ni de una de sus capas hijas.

Cambiar las reglas no toca los activos. Los que no tengan padre en una capa que pasa a exigirlo siguen existiendo; se piden al editarlos. Cómo se usa en el día a día: ver Jerarquía de activos.

Asignar padres a los activos que ya existen

Asignar padres…, en el bloque Jerarquía, cuelga de golpe los activos de la capa. Sirve para una capa cargada sin padres o para pasar a jerarquía un campo de referencia. Las capas padre tienen que estar guardadas.

1. Elige Cómo se elige el padre:

   Método	Qué hace
   Por un campo	Un campo del activo lleva el código del padre. En Se busca en, elige si ese código es el Código del activo padre o un campo del padre. Un campo de referencia a la capa padre sale ya elegido, con su campo de muestra
   El más cercano	El padre más próximo, hasta la Distancia máxima (m)
   Dentro del padre	El padre es un polígono (una nave, una parcela) que contiene al activo

2. Deja marcadas Solo los que no tienen padre (para no tocar lo ya hecho) y El padre, del mismo cliente, salvo que necesites otra cosa.

3. Pulsa Vista previa. Sale cuántos se colgarán y por qué no se cuelgan los demás, con ejemplos: «Sin padre que encaje», «Con varios padres posibles», «Sin valor en el campo», «Su padre está lleno».
4. Si te cuadra, pulsa Aplicar y confirma. Hasta ese momento no cambia nada.

Se respeta el máximo de hijos de cada padre: con El más cercano, un activo cuyo padre más cercano ya está lleno sale como «Su padre está lleno» y no se cuelga de otro. En capas de cientos de miles de activos puede tardar unos segundos; si pasa de dos minutos, se para con un aviso.

Gestionar campos

Los campos son los datos de cada activo de la capa. Pulsa Gestionar campos en la fila: se abre una ventana con dos partes, Campos identificativos y Campos definidos.

Campos identificativos

Marca los campos que forman el nombre del activo. Ese nombre es el que se ve en la ficha, las órdenes, las incidencias y los lotes de lectura. Si marcas varios, se unen con un guion, por ejemplo «CM-01 - Calle Mayor».

El cambio se guarda al marcar la casilla, sin más botones. Maptainer recalcula también el código de los activos y avisa con «Se han actualizado N códigos de activo».

Los campos identificativos sirven además como clave al volver a cargar un fichero GeoJSON o DXF: ver Activos que ya existen.

Añadir o editar un campo

1. Pulsa Añadir campo, o Editar en la tarjeta del campo.
2. Rellena Identificación:
   • Etiqueta (ES): el nombre que ve el usuario. Obligatorio.
   • Etiqueta (EN): opcional.
   • Nombre técnico: sin espacios, solo letras, números y guiones bajos. Es la clave del dato y tiene que coincidir con la columna de los ficheros que cargues.
   • Tipo de campo: ver la tabla siguiente.
3. Si el tipo es de lista, añade las opciones con Añadir opción. Cada opción tiene un valor y una etiqueta.
4. En Comportamiento, ajusta Valor por defecto, Orden de presentación, Ancho del campo, Visibilidad y Campo obligatorio.
5. Pulsa Crear campo o Actualizar campo.

Al crear un campo, todos los activos de la capa lo reciben vacío o con el valor por defecto.

Otras opciones del editor:

Listas que dependen de otra

Un campo de lista puede depender de otro. Por ejemplo, Modelo puede ofrecer unas opciones u otras según el Fabricante.

1. Crea primero el campo padre, con sus opciones.
2. En el campo hijo, elige el Campo padre en Dependencia jerárquica.
3. Guarda el campo. En su tarjeta aparece la etiqueta Dependiente y el botón Gestionar opciones en cascada.
4. Pulsa Gestionar opciones en cascada, elige cada valor del padre y escribe las opciones que le corresponden.

Renombrar o eliminar un campo

Si cambias el Nombre técnico, Maptainer lleva el cambio a los datos de los activos, a los campos identificativos y a los estilos del mapa.

Para eliminar, pulsa Eliminar en la tarjeta. Antes de confirmar se indica cuántos activos tienen un valor en ese campo y qué estilos lo usan.

Subir un archivo geoespacial

Así se cargan muchos activos a la vez. Pulsa Subir archivo geoespacial en la fila de la capa.

1. En Archivo, elige el fichero. Si es un DXF, escribe en Sistema de coordenadas de origen el EPSG en el que está dibujado, por ejemplo «EPSG:25830». Es obligatorio: sin él no deja subirlo.
2. Con el módulo de clientes, elige el Cliente de todos los activos del fichero. Si son de tu empresa, elige el cliente propio.
3. Si la capa tiene capas padre, puedes indicar la Columna con el código del padre y, en Se busca en, dónde está ese código: el Código del activo padre o un campo de la capa padre. Ver Padres en la carga.
4. En ¿Qué hacer con los datos existentes?, elige Añadir datos o Reemplazar datos.
5. Pulsa Subir archivo.

Una barra muestra la subida y el proceso. Al terminar sale un resumen, por ejemplo «Se crearon 415 activos correctamente». Si alguna fila falla, el mensaje dice cuántas y por qué.

Formatos

El tamaño máximo es de 150 MB. Todo se convierte a la proyección del mapa al cargar.

Cómo se leen los campos

No hay que emparejar columnas a mano. Cada columna del fichero se guarda con su nombre, y se muestra en el campo cuyo Nombre técnico coincide.

• Si la capa no tiene campos, Maptainer crea uno de tipo texto por cada columna. Después puedes cambiar sus etiquetas y tipos en Gestionar campos.
• Si la capa ya tiene campos, no se crea ninguno. Las columnas con otro nombre se guardan, pero no se ven hasta que crees un campo con ese nombre técnico.

Todos los activos cargados entran en estado Operativo. Las filas sin geometría o con una geometría vacía se descartan.

Activos que ya existen

Con Añadir datos, lo que pasa con los activos que ya están en la capa depende del formato:

Reemplazar datos cambia todos los activos de la capa por los del fichero. Primero lee y comprueba el fichero entero; solo si está bien borra los activos y carga los nuevos, todo de una vez. Si algo falla, no se borra nada y la capa se queda como estaba.

Como borra la capa, Reemplazar datos exige además el permiso Eliminar de Activos GIS. Sin él, la carga se rechaza sin tocar nada y el aviso propone usar Añadir datos o pedir el permiso a un administrador.

En todos los formatos, las filas a las que les falta un campo obligatorio no se cargan. El resumen las enumera, por ejemplo «Fila 12: falta la propiedad obligatoria código».

Padres en la carga

Si el fichero trae una columna con el código del activo del que cuelga cada fila (por ejemplo, el cuadro de cada luminaria), escribe su nombre en Columna con el código del padre. Al terminar la carga, cada activo nuevo se cuelga del de la capa padre que tenga ese código. El resumen lo cuenta: «Padres: 407 activos colgados de su padre; en la capa quedan 8 con código de padre sin colgar (8 sin padre con ese código)».

• La columna se guarda como un campo más del activo, así que se puede volver a usar con Asignar padres.
• Solo se cuelgan los activos sin padre. No se pasa del máximo de hijos de cada padre.
• Si un código aparece en dos padres, ese activo no se cuelga.

Límite del plan

Si el fichero supera los activos que admite tu plan, no se carga nada. Sale un mensaje como «Tu plan admite N activos y ya hay M». Amplía el plan o divide el fichero.

Sincronizar con una API REST

Una capa puede tomar sus activos de otro sistema que los publique en una API REST. La conexión (dirección y credencial) se da de alta antes en Conexiones Remotas; ver Administración del tenant.

Configurar el origen

En Nueva Capa o Editar, en Origen de datos externo, elige API Rest y rellena:

En una capa Sin geometría el bloque se llama Cargar datos (en el alta) u Origen de datos (al editar), y no pide geometría.

La API tiene que devolver una lista de registros, o un objeto con la lista dentro de «data», «results», «items», «records» o «features».

Sincronizar

En la fila de la capa, pulsa Sincronizar API Rest y confirma con Sincronizar.

1. La primera vez, si la capa no tiene campos, Maptainer solo lee la estructura. Crea un campo por cada dato y avisa: «Ejecute de nuevo para importar datos».
2. Revisa los campos en Gestionar campos. La Clave primaria tiene que ser uno de ellos, con el mismo nombre técnico.
3. Vuelve a sincronizar. Ahora se importan los registros.

Al terminar, Sincronización completada da el recuento: creados, actualizados, sin cambios y desactivados.

Sincronización automática y delta

Con Horas de ejecución, Maptainer sincroniza la capa sola a cada hora indicada, con unos minutos de margen. Si a esa hora ya hay una sincronización de la capa en marcha, esa vez se salta.

Con Implementación delta en Sí:

• La primera sincronización trae todo. Las siguientes piden solo lo cambiado desde la última correcta, con un margen de 5 minutos.
• Maptainer añade a la dirección ?modified_since= con la fecha en el Formato de fecha elegido. Si la API usa otro nombre, escribe {since} en la Ruta endpoint donde vaya la fecha, por ejemplo «/v1/items?updated_at[gte]={since}».
• Si la API no filtra, Maptainer descarta él mismo los registros que no han cambiado según el Campo fecha actualización.
• Un registro con el Campo fecha de borrado relleno da de baja su activo. Los que no vienen en la respuesta no se tocan.
• Si una vez quieres traerlo todo, desactiva el delta, sincroniza y vuelve a activarlo.

Capas sin geometría

Las capas Sin geometría no se dibujan en el mapa. No tienen Subir archivo geoespacial ni Configurar simbología; tienen Ver datos.

Ver datos abre una tabla con los registros de la capa. Tiene una columna por campo, más Activo y Creado. Muestra 50 registros por página y se filtra con Buscar.... Se cierra con Cerrar o Escape.

Los datos se cargan con un CSV con cabeceras en la primera fila: en el alta, en Cargar datos, o después con Cargar datos CSV en la fila de la capa. Cada columna se convierte en un campo de texto si la capa no tenía campos.

Cargar datos CSV funciona como Subir un archivo geoespacial: eliges el fichero, el Cliente y, si hay capas padre, la columna del padre, y después Añadir datos o Reemplazar datos. Las filas sin un campo obligatorio no se cargan, y si el reemplazo falla la capa se queda como estaba.

Simbología

La simbología decide cómo se dibuja la capa en el mapa. Pulsa Configurar simbología en la fila: se abre Simbología con los estilos de la capa.

Una capa puede tener varios estilos. En el mapa son alternativas: se ve uno y los demás se eligen con Seleccionar temático en el panel de capas. El Nombre (ES) del estilo es lo que sale en esa lista. Ver El mapa.

Sin ningún estilo, la capa se dibuja con un estilo verde por defecto.

Crear un estilo

1. Pulsa Añadir estilo. En una capa GEOMETRY, elige antes la Geometría a simbolizar.
2. En Capa, modo y zoom, elige:
   • Tipo de capa: Círculo o Símbolo/Texto para puntos, Línea para líneas, Relleno (Polígono) para polígonos.
   • Modo de estilo: Fijo (un solo aspecto) o Temático (según un campo).
   • Zoom mínimo y Zoom máximo: entre qué niveles de zoom se dibuja, en los dos modos.
3. En Identificación, pon un Nombre (ES) y decide si es el Estilo principal: el que se ve al abrir la capa en el mapa web, el portal y la app móvil. Solo hay uno por capa; al marcar otro, el anterior deja de serlo.
4. Rellena Configuración del estilo (ver abajo).
5. Pulsa Crear estilo.

Para cambiarlo, pulsa Editar en su tarjeta y después Actualizar estilo. Para borrarlo, Eliminar.

Estilo fijo

Todos los activos se dibujan igual. Los datos dependen del tipo de capa:

La opacidad va de 0 (transparente) a 1 (opaco). Los colores se eligen con el selector o se escriben en hexadecimal.

Etiquetas

Los estilos de círculo, relleno y símbolo tienen el bloque Etiquetas de Texto (Opcional). Sirve para escribir junto a cada activo el valor de un campo, como su número.

Iconos

En el tipo Símbolo/Texto, el bloque Icono (Opcional) dibuja un icono en lugar de un círculo.

1. Pulsa Seleccionar. Se abre Seleccionar Icono SVG con la biblioteca de iconos.
2. Busca por nombre o filtra por sector.
3. Pulsa el icono.
4. Ajusta Tamaño del Icono (escala): 1 es el tamaño original.

La biblioteca de iconos es común a todas las empresas y la mantiene Maptainer. No se pueden subir iconos propios. Tiene unos 370 iconos repartidos en diez sectores: Agua y saneamiento, Electricidad y alumbrado, Eólica, Fotovoltaica, Riego, Señalización y tráfico, Instalaciones, Edificios y equipamientos, Obra y herramientas, y Símbolos y estados.

Todos los iconos son casi cuadrados. Los objetos que por naturaleza son alargados, como un hidrante, un aerogenerador o un semáforo, van dentro de un círculo para que se lean bien en el mapa. El mapa pinta el icono como una silueta de un solo color, que es el color del estilo; los colores del dibujo original no se ven.

Temático por un campo

Un estilo Temático colorea cada activo según el valor de un campo. Por ejemplo, las tuberías por material.

1. Elige Temático en Modo de estilo.
2. En Campo para Tematizar, elige el campo. Aparece Asignar Estilos por Valor, con una tarjeta por cada valor.
3. Ajusta cada valor: color y radio en círculos, color y ancho en líneas, color y opacidad en rellenos.
4. Elige el Color por Defecto para los activos con un valor que no esté en la lista.
5. Opcionalmente, añade etiquetas en Etiquetas de Texto (Opcional).
6. Pulsa Crear estilo o Actualizar estilo.

Los valores salen de las opciones del campo y de los valores que ya tienen los activos, hasta 100. Los colores se proponen solos y se pueden cambiar.

En el tipo Símbolo/Texto, Configuración de Iconos permite Icono único para todos, con un color por valor, o Icono por cada valor.

Eliminar una capa

Pulsa Eliminar en la fila y confirma. Sale «Tipo de activo eliminado exitosamente».

Si algún activo de la capa tiene incidencias, el borrado falla con «Error al eliminar el tipo de activo».

Capas WMS

Una capa WMS muestra en el mapa la imagen de un servidor de mapas externo: una ortofoto, el catastro, el planeamiento. Es solo imagen: no tiene activos ni se puede consultar. Se gestionan en Capas WMS, dentro de Configuración del administrador.

La pantalla Gestión de Capas WMS lista las capas con su nombre, dirección del servicio, capa y fecha de creación. Todas son de tipo Cosmética.

Añadir una capa WMS

1. Pulsa Nueva capa WMS.
2. En Paso 1 · Conectar al servicio WMS, pega la dirección en URL del servicio WMS y pulsa Conectar. Sale «Servicio WMS conectado exitosamente».
3. En Paso 2 · Identificación, escribe el Nombre descriptivo, que es el que se verá en el mapa, y elige la Capa del servicio WMS.
4. En Servicio WMS, revisa Sistema de referencia, Versión WMS, Formato de imagen y Estilo. El Sistema de referencia se elige solo (ver abajo).
5. En Visualización, ajusta Opacidad, Cargar al inicio y Transparencia.
6. Pulsa Crear capa WMS.

Usa PNG con Transparencia para ver las capas de debajo. JPEG pesa menos pero tapa todo.

Sistema de referencia

El mapa trabaja en EPSG:3857. Al elegir la capa, Maptainer mira qué sistemas ofrece el servicio:

• Si ofrece EPSG:3857 (o un equivalente), lo usa y el desplegable queda fijo. Es la opción más rápida.
• Si no lo ofrece, propone uno de los que tiene, como EPSG:4326 o EPSG:25830, y avisa de que la capa se reproyecta. Maptainer pide la imagen en ese sistema y la convierte para el mapa. Se ve en su sitio, pero carga algo más despacio.
• Si no ofrece ningún sistema que se pueda convertir, lo avisa y no deja crear la capa.

En servicios ArcGIS, una capa reproyectada puede cambiar de grosor de línea o de rótulos según el sistema. Si el servicio ofrece uno en metros, como EPSG:25830, suele verse mejor que en EPSG:4326.

En el mapa

Las capas WMS salen en el panel Capas, en el grupo Capas WMS, y siempre se dibujan por debajo de los activos. Si el servidor ofrece leyenda, se ve en el panel Leyenda. Ver El mapa.

Para cambiar una capa, pulsa Editar. Editar capa WMS permite además cambiar la URL, el nombre interno de la capa y la URL de leyenda. Para quitarla, pulsa Eliminar y confirma.

Problemas frecuentes

Última actualización: 2 OCT 2026