Formularios

Introducción

El módulo de Formularios permite crear una capa o una tabla de datos. En el caso de las capas, es posible seleccionar el tipo de geometría asociada, ya sea de tipo punto, línea o polígono. Un formulario está compuesto por un conjunto de campos o atributos y, para cada uno de ellos, se puede establecer el tipo de dato, su obligatoriedad, el nombre con el que se almacena en la base de datos y una definición opcional. Según el tipo de dato seleccionado, se habilitan parámetros de configuración adicionales.

1. Interfaz del módulo

El diseñador de formularios cuenta con una serie de elementos que se describen a continuación.

(se abre a tamaño completo en una ventana nueva) Imagen 1: Vista general del módulo Diseño de formularios

1. Diseño de formularios: desde el menú lateral, este botón da acceso al módulo que permite gestionar los formularios en Geonodo.
2. Nuevo formulario: botón que inicia la creación de un nuevo formulario.
3. Lista de formularios: presenta los formularios existentes junto con las acciones disponibles: publicar en web, definir privacidad (público/privado), duplicar, ver historial, editar y eliminar.

2. Funcionalidades

A continuación se detalla cada una de las funcionalidades disponibles en este módulo.

2.1 Nuevo formulario

El procedimiento para configurar un nuevo formulario en Geonodo es el siguiente:

1. Haga clic en el botón Nuevo formulario.
2. Asigne un nombre al formulario.
3. Seleccione el tipo de formulario: Geoespacial o de tipo Datos.
4. Si eligió Geoespacial, seleccione la geometría: punto, línea o polígono.
5. Haga clic en Guardar formulario.
6. Agregue los campos deseados con el botón Añadir elemento y configure sus propiedades (tipo de dato, obligatoriedad, nombre en base de datos y definición opcional). Luego haga clic en Guardar para almacenar la configuración del campo.
7. Guarde los cambios y publique el formulario; con esto quedará listo para ser utilizado.

Definición de campos o atributos

En el módulo de Formularios de Geonodo puede definir campos o atributos utilizando distintos tipos de dato, según las necesidades de captura de información. Los tipos disponibles son:

• Texto: permite ingresar texto breve o palabras clave.
• Texto largo: habilita un campo para texto extenso o descripciones detalladas.
• Correo electrónico: valida que el valor ingresado tenga formato de dirección de correo.
• Entero: acepta números enteros, sin decimales.
• Decimal: acepta números con decimales, incluidos valores fraccionarios.
• Fecha: permite seleccionar una fecha mediante un calendario.
• Hora: permite registrar una hora específica.
• Selección única: presenta una lista de opciones predefinidas y permite elegir solo una.
• Selección múltiple: presenta una lista de opciones predefinidas y permite elegir varias.
• Imagen: permite cargar y adjuntar una imagen al formulario.
• Rut: permite ingresar un RUT con validación del dígito verificador.
• Opción: permite incorporar una casilla de verificación (por ejemplo, para aceptar los términos de uso de los datos).
• Archivos: permite cargar y adjuntar uno o más archivos al formulario.
• Título: permite agregar un título o texto explicativo entre campos o atributos.

Al configurar un campo, seleccione el tipo de dato correspondiente y defina las propiedades adicionales, como la obligatoriedad, el nombre en base de datos y la definición opcional.

Recuerde que puede combinar distintos tipos de dato en un mismo formulario para adaptarse a la diversidad de información que desea capturar. Utilice nombres descriptivos y claros para los campos: esto facilitará la comprensión de la información almacenada.

A continuación se presenta el detalle de cada tipo de campo o atributo.

Texto, Texto Largo y Correo electrónico:

Estos tres tipos de dato comparten una configuración similar. Al agregarse a un formulario, permiten registrar un valor de tipo texto. En el caso de Correo electrónico, el formulario valida automáticamente el formato del dato ingresado.

(se abre a tamaño completo en una ventana nueva) Imagen 2: Parámetros de configuración de un campo de tipo Texto

• Nombre: nombre asignado al campo.
• Tipo: lista que presenta las alternativas de tipos de dato.
• Nombre de la columna de datos: valor que se autocompleta a partir del Nombre y corresponde al texto que se utilizará en la base de datos. Puede modificarse, pero no admite caracteres especiales ni espacios en blanco.
• Definición: permite agregar una descripción del campo.
• Este elemento es requerido: define si el campo es obligatorio.
• Expresión regular: cadena de caracteres que describe o busca patrones dentro del texto ingresado en el campo, según delimitadores y reglas de sintaxis específicas.

Entero y Decimal

Estos dos tipos de dato comparten una configuración similar. Al agregarse a un formulario, permiten registrar un número entero o un número decimal, respectivamente.

(se abre a tamaño completo en una ventana nueva) Imagen 3: Parámetros de configuración de un campo numérico (Entero o Decimal)

• Mínimo: menor valor que puede ingresarse.
• Máximo: mayor valor que puede ingresarse.

Fecha y Hora

Estos dos tipos de dato comparten una configuración similar. Al agregarse a un formulario, permiten registrar una fecha mediante un calendario o ingresar el valor de una hora.

(se abre a tamaño completo en una ventana nueva) Imagen 4: Parámetros de configuración de un campo de tipo Fecha

Selección única y múltiple

Estos dos tipos de dato comparten una configuración similar. La Selección única se presenta mediante botones de opción (radio button) y la Selección múltiple mediante casillas de verificación (check box).

(se abre a tamaño completo en una ventana nueva) Imagen 5: Parámetros de configuración de un campo de Selección única

En el caso de la Selección única, puede elegir entre las alternativas de visualización Radio button o Combo box.

• Agregar opción: permite añadir una o más alternativas de dominio.
• Cargar palabras separadas por coma: permite escribir los valores que se mostrarán en la selección única o múltiple. Los valores deben separarse con el símbolo coma («,»), sin agregar un espacio en blanco después de cada coma.

Ejemplo de dominio: Si,No,Sin información

Imagen

Este tipo de dato permite guardar una imagen, que posteriormente podrá visualizarse en el mapa al hacer clic sobre el elemento correspondiente (punto, línea o polígono).

(se abre a tamaño completo en una ventana nueva) Imagen 6: Parámetros de configuración de un campo de tipo Imagen

Rut

Este tipo de dato permite registrar un texto con formato de RUT. Al momento de guardar, el formulario valida el número mediante su dígito verificador.

(se abre a tamaño completo en una ventana nueva) Imagen 7: Parámetros de configuración de un campo de tipo Rut

Opción

Este tipo de dato agrega una casilla de verificación al formulario (por ejemplo, para aceptar los términos de uso de los datos).

(se abre a tamaño completo en una ventana nueva) Imagen 8: Parámetros de configuración de un campo de tipo Opción

Este tipo de dato no incorpora parámetros nuevos; los parámetros presentes ya fueron descritos anteriormente.

Archivos

Este tipo de dato permite guardar uno o más archivos en distintos formatos (ZIP, PDF, XLS, entre otros), que posteriormente podrán visualizarse en el mapa al hacer clic sobre el elemento correspondiente (punto, línea o polígono).

(se abre a tamaño completo en una ventana nueva) Imagen 9: Parámetros de configuración de un campo de tipo Archivos

• Tamaño del archivo (máx. 200 MB): define el tamaño máximo de los archivos que el usuario podrá cargar. Este valor no puede superar el configurado en el archivo php.ini del servidor.

Títulos

Este tipo de dato permite agregar un título y una descripción para un conjunto de atributos. Ayuda al usuario a comprender el sentido de las preguntas que vienen a continuación. Es posible incorporar más de un título entre las preguntas o atributos.

(se abre a tamaño completo en una ventana nueva) Imagen 10: Parámetros de configuración de un campo de tipo Título

Campos dependientes

Al añadir el primer campo del formulario se habilita la opción Añadir condiciones. Esta función permite construir preguntas que, según la respuesta escrita o seleccionada, despliegan nuevas preguntas. A esta configuración la denominamos campos dependientes.

(se abre a tamaño completo en una ventana nueva) Imagen 11: Opción Añadir condiciones disponible al configurar un campo

Al habilitar Añadir condiciones, debe elegir una de las siguientes alternativas:

(se abre a tamaño completo en una ventana nueva) Imagen 12: Selección del tipo de regla de condición a aplicar

Esto desplegará un botón para agregar una o más condiciones.

(se abre a tamaño completo en una ventana nueva)

13

• Pregunta: muestra el listado de preguntas creadas previamente.
• Condición: presenta un listado con cuatro tipos de condición disponibles.
• Eliminar: permite eliminar una condición guardada anteriormente.

Cada vez que agregue una condición debe hacer clic en el botón Guardar.

(se abre a tamaño completo en una ventana nueva) Imagen 14: Listado de tipos de condición disponibles para el campo

Si elige las condiciones Igual a o Distinto a, deberá escribir un texto en el campo Respuesta. Ese texto debe coincidir exactamente con el valor definido en la pregunta seleccionada.

(se abre a tamaño completo en una ventana nueva) Imagen 15: Campo Respuesta habilitado para las condiciones Igual a o Distinto a

2.2. Publicar web/Despublicar web

Habilita una vista web del formulario, lo que permite el llenado de los campos a través del navegador.

(se abre a tamaño completo en una ventana nueva) Imagen 16: Acción Publicar web disponible en la lista de formularios

A continuación se presenta un ejemplo de la vista web del formulario.

(se abre a tamaño completo en una ventana nueva) Imagen 17: Ejemplo de la vista web de un formulario publicado

2.3. Público/Privado

De forma predeterminada, tras su publicación, un formulario queda en estado Privado (ícono de candado cerrado de color rojo). En este estado, para completar la vista web es necesario contar con una cuenta de usuario en Geonodo e iniciar sesión.

Al hacer clic sobre el ícono de candado rojo, el formulario cambia a estado Público: el ícono pasa a color verde con forma de candado abierto. Esto permite completar el formulario sin necesidad de iniciar sesión.

(se abre a tamaño completo en una ventana nueva) Imagen 18: Cambio de estado del formulario entre Privado y Público

2.4. Acceso a formulario web

Todo formulario con estado de publicación web en «Sí» muestra un ícono con forma de cuadro y flecha. Al hacer clic sobre él, se abre una nueva ventana del navegador con el formulario listo para ser completado.

(se abre a tamaño completo en una ventana nueva) Imagen 19: Ícono de acceso directo al formulario web

2.5. Vista de detalles

Mediante el ícono con forma de ojo se accede al detalle del formulario.

(se abre a tamaño completo en una ventana nueva) Imagen 20: Ícono Vista de detalles en la lista de formularios

Esta función da acceso al detalle del formulario y permite conocer sus atributos, tipos de dato, reglas y otros detalles.

(se abre a tamaño completo en una ventana nueva) Imagen 21: Detalle del formulario con sus elementos, definiciones y reglas

2.6. Duplicar

Los formularios pueden duplicarse con el fin de reutilizar la estructura de datos de un formulario creado previamente. La duplicación no incluye los datos capturados al completar el formulario y el nuevo formulario queda despublicado, por lo que podrá editarse.

(se abre a tamaño completo en una ventana nueva) Imagen 22: Ícono Duplicar en la lista de formularios

2.7 Ver Historial

El historial de un formulario registra los cambios realizados durante su edición y permite volver a una versión configurada anteriormente.

(se abre a tamaño completo en una ventana nueva) Imagen 23: Ícono Ver historial en la lista de formularios

La elección de la versión se realiza al hacer clic en el ícono ubicado a la derecha de cada versión.

(se abre a tamaño completo en una ventana nueva) Imagen 24: Historial de versiones del formulario con su resumen funcional

2.8. Editar

Los formularios pueden editarse para realizar cambios en su modelo de datos. Es importante publicar los cambios una vez realizados.

(se abre a tamaño completo en una ventana nueva) Imagen 25: Ícono Editar en la lista de formularios

2.9. Eliminar

Elimina el formulario seleccionado.

Advertencia: la eliminación es irreversible. Si se elimina un formulario, la capa o el dato correspondiente se elimina de los gestores respectivos y se pierden los datos recolectados.

(se abre a tamaño completo en una ventana nueva) Imagen 26: Ícono Eliminar en la lista de formularios

2.10 Exportar e importar formularios

Esta sección describe el procedimiento para transferir esquemas de datos entre distintas instancias de Geonodo. Esta funcionalidad es clave para replicar estructuras de captura de información territorial sin necesidad de recrear manualmente cada atributo.

2.10.1 Exportación de Formularios

La exportación permite generar un respaldo técnico del formulario en formato JSON. Este archivo no contiene los datos recolectados, sino la arquitectura del esquema, que incluye:

• Definición geoespacial: tipo de geometría (punto, línea o polígono).
• Esquema de atributos: nombres técnicos, etiquetas (labels) y tipos de dato (texto, numérico, fecha, etc.).
• Lógica de negocio: reglas de validación, condiciones de visibilidad y dominios de valores.
• Configuración de interfaz: orden de los elementos y tipos de control (selectores, captura de imágenes, etc.).

Nota: el sistema admite la exportación masiva. Puede seleccionar múltiples formularios para descargarlos en un único proceso de empaquetado.

(se abre a tamaño completo en una ventana nueva) Imagen 27: Ventana Exportar formularios con la selección de ámbito

2.10.2 Importación de Formularios

Para integrar un formulario externo a su instancia de Geonodo, siga estos pasos:

1. Acceso: diríjase al módulo de gestión de formularios y seleccione la opción Importar.
2. Identificación: asigne un Nombre al nuevo formulario. Será su identificador dentro de la base de datos geoespacial.
3. Carga de esquema: seleccione el archivo JSON desde su almacenamiento local.
4. Validación: el sistema verifica que la estructura sea compatible antes de crear la nueva capa y su respectiva interfaz de captura.

(se abre a tamaño completo en una ventana nueva) Imagen 28: Ventana Importar formularios con el campo de nombre y la carga del archivo JSON

2.10.3 Ejemplo de Estructura JSON

Para fines de administración avanzada, a continuación se muestra la estructura de un formulario de tipo GIS (punto) orientado a la caracterización de infraestructura:

Campo	Descripción	Ejemplo en JSON
name	Nombre técnico de la capa	“Casas”
gis_type	Tipo de entidad espacial	“POINT”
domain	Valores restringidos para el campo	“1,2” (número de pisos)
form_element_type	Tipo de componente en la aplicación	“image”, “select”, “text”

Ejemplo de archivo JSON:

(se abre a tamaño completo en una ventana nueva) Imagen 29: Ejemplo de la estructura JSON exportada de un formulario