Modificar los datos de una capa es, a menudo, el momento en que los principiantes en el desarrollo de plugins QGIS empiezan a sentirse inseguros: ¿y si estropeo algo?
Esta preocupación es completamente normal… e incluso saludable.
La buena noticia es que QGIS proporciona mecanismos simples y fiables para modificar datos de forma segura, siempre que se respeten algunas reglas fundamentales.
Esta guía explica cómo utilizar el modo de edición, confirmar o cancelar cambios y actualizar capas y atributos sin poner en riesgo los datos.
Por qué modificar datos parece arriesgado
Leer datos de una capa es una operación completamente segura.
Puedes:
- recorrer entidades,
- consultar atributos,
- analizar geometrías,
sin modificar nada.
Los riesgos aparecen únicamente cuando:
- se modifican atributos,
- se añaden o eliminan entidades,
- se cambia la estructura de una capa.
Mientras una capa no esté en modo de edición, no se escribirá ningún cambio en la fuente de datos.
El modo de edición: la primera línea de protección
QGIS exige activar explícitamente el modo de edición antes de permitir cualquier modificación.
layer.startEditing()
Esta decisión de diseño no es casual.
El modo de edición:
- permite cancelar cambios,
- evita modificaciones accidentales,
- obliga al desarrollador a tomar una decisión consciente antes de modificar los datos.
Mientras los cambios no se confirmen, todo sigue siendo reversible.
Confirmar o cancelar: commit y rollback
Una vez realizadas las modificaciones, existen dos posibilidades:
layer.commitChanges() # confirmar cambios
o
layer.rollBack() # cancelar cambios
Una regla simple pero esencial:
Confirmar los cambios únicamente cuando todo haya funcionado correctamente.
Cancelar los cambios tan pronto como se detecte un error lógico o de procesamiento.
Este enfoque ayuda a preservar la integridad de los datos y evita dejar la capa en un estado incoherente.
Verificar antes de modificar
Antes de realizar cualquier modificación, el plugin debería comprobar que:
- la capa es vectorial,
- la capa no es de solo lectura,
- los campos necesarios existen,
- la estructura de los datos corresponde a lo esperado.
Estas comprobaciones forman parte de la lógica de negocio del plugin; QGIS no las realiza automáticamente.
Cuanto antes se detecte un problema, más fácil será resolverlo de forma segura.
Realizar pocos cambios, pero de forma explícita
Una buena regla para los desarrolladores principiantes es:
Realizar pocas modificaciones, pero que sean claras y predecibles.
Conviene evitar:
- modificaciones implícitas,
- procesos silenciosos,
- acciones difíciles de explicar al usuario.
Un plugin fiable es aquel cuyo comportamiento puede describirse con una sola frase.
Si no puedes explicar claramente qué modifica tu plugin, probablemente tus usuarios tampoco lo comprenderán.
QGIS protege tus datos… si le permites hacerlo
QGIS nunca aplica modificaciones sin instrucciones explícitas.
La plataforma está diseñada para proteger la integridad de los datos.
Mientras respetes el ciclo:
Verificar → Editar → Confirmar o Cancelar
los datos permanecerán bajo control.
La mayoría de los problemas relacionados con la pérdida o corrupción de datos no son causados por QGIS, sino por código que omite alguna de estas etapas.
Lo que debes recordar
Antes de continuar, recuerda estas ideas fundamentales:
- Leer una capa es seguro.
- Modificar una capa requiere activar el modo de edición.
commitChanges()yrollBack()son tus mecanismos de seguridad.- La prudencia es una virtud, no una limitación.
Este breve artículo puede servir como referencia cada vez que necesites modificar datos desde un plugin QGIS.
Los plugins más seguros no son los que contienen más código, sino los que respetan los datos que modifican.
