Cree tipos de eventos personalizados con el editor de formularios de eventos.

El editor de formularios de eventos EarthRanger (EFE) es una forma sencilla y visual para que los administradores creen y gestionen cómo se capturan los eventos en EarthRanger .

La función EFE simplifica la creación de tipos de eventos, permitiendo arrastrar y soltar elementos. Los administradores pueden crear, personalizar y gestionar tipos y categorías de eventos, definiendo los datos exactos que desean recopilar. Esto brinda a las organizaciones la autonomía necesaria para adaptar rápidamente los informes de eventos EarthRanger a sus necesidades operativas. Esta nueva función crea lo que denominamos Tipos de Eventos v2 , que reemplazan a los antiguos Tipos de Eventos v1 basados en esquemas JSON. Más información a continuación.

El sistema Editor de formularios de eventos incluye dos partes que trabajan juntas para permitir a los administradores crear y gestionar tipos de eventos sin necesidad de editar el esquema.

  • Editor de formularios de eventos (EFE) : la interfaz de administración para crear y configurar formularios de eventos sin necesidad de editar esquemas directamente.
  • Formulario de evento : el formulario que ven los usuarios, tanto el personal de campo como otros usuarios, al capturar datos de eventos en EarthRanger Web y Móvil.

¿Dónde encontrarlo?

  • Inicie sesión en su sitio de administración EarthRanger y busque en la sección Actividad para
    Tipos y categorías de eventos 2.0)
  • Haz clic en este enlace para abrir la nueva interfaz.

Comprensión de los tipos de eventos v1 y v2

  • Los tipos de eventos v1 se crearon antes del editor de formularios de eventos, utilizando configuraciones de esquema JSON en la interfaz de administración anterior. Aparecen etiquetados como "Legacy" en la administración y no se pueden editar mediante el editor de formularios de eventos.
  • Los tipos de eventos v1 dejarán de estar disponibles el 15 de octubre de 2026. Después de esa fecha, ya no se podrán usar para registrar nuevos eventos. Los eventos ya registrados con un tipo de evento v1 se conservarán y seguirán estando accesibles; la eliminación de estos tipos afectará la posibilidad de crear nuevos eventos con ellos en el futuro, pero no los datos históricos. Si su sitio aún utiliza tipos de eventos v1, migre a la versión 2 antes del 15 de octubre con la herramienta de migración .
  • Los tipos de eventos v2 se crean mediante el editor de formularios de eventos y admiten la personalización mediante arrastrar y soltar. Esta es ahora la ruta predeterminada y compatible para la configuración de todos los tipos de eventos.

Primeros pasos con el editor de formularios de eventos

Antes de comenzar:
Los cambios realizados en los tipos de eventos v2 en el editor de formularios de eventos afectan tanto a los eventos nuevos como a los recopilados previamente de ese tipo . El editor de formularios de eventos actualmente no admite el control de versiones ni la reversión .
Si elimina o modifica un campo:

  • Cualquier dato asociado en los registros existentes puede estar oculto o haberse perdido.
  • El cambio es inmediato e irreversible.

Solo los tipos de eventos v2 (creados en el EFE) se pueden editar mediante esta interfaz. 

Los tipos de eventos v1 (basados en esquemas) no se pueden editar en el editor de formularios de eventos.

Recomendamos encarecidamente revisar la sección sobre Gestión de tipos de eventos antes de crear o publicar su primer formulario.

Descripción general de la interfaz

El panel principal está organizado en dos secciones clave:

  • Panel izquierdo (Filtros):
    • Versión del tipo de evento
      • v1: escrito en EarthRanger usando la notación de esquema JSON (no editable en EFE)
      • v2: creado originalmente (y editable) usando el Editor de Formularios de Eventos (EFE)
    • Estado
      • Activos: Filtra los tipos de eventos activos que se pueden ver en EarthRanger Web y Móvil.
      • Inactivos: Filtra solo los tipos de eventos que se han marcado como inactivos (están ocultos en EarthRanger Web y Móvil).
    • Tipo de geometría
      • Punto: El evento está asociado a una única ubicación.
      • Polígono: El evento representa un área o región definida.

Panel principal (Jerarquía de formularios)

Muestra una lista de categorías de eventos , cada una de las cuales puede contener uno o más tipos de eventos .

  • Arrastra y suelta para reordenar tanto las categorías de eventos como los tipos de eventos .
    • Este orden refleja directamente cómo se muestran las categorías y los tipos en EarthRanger Web y Móvil.
  • Utilice esta función para expandir o contraer las categorías de eventos individuales y facilitar la navegación.
  • La jerarquía visual muestra claramente qué tipos de eventos pertenecen a qué categorías de eventos .

Cada tipo de evento enumerado incluye:

  • Icono
  • Nombre para mostrar
  • Versión ( v1 o v2 )
  • Tipo de geometría ( Point o Polygon )
  • Estado ( Active o Inactive )

El menú de acciones principales incluye:

  • ➕ Nueva categoría de evento
  • ➕ Nuevo tipo de evento

Gestión de categorías de eventos

Las categorías de eventos actúan como contenedores para los tipos de eventos . Cada tipo de evento que cree debe pertenecer a una categoría, lo que ayuda a agrupar eventos relacionados para facilitar su uso y gestión.

Ejemplos:

  • Eventos relacionados con la fauna silvestre: avistamientos, mortalidad, conflictos.
  • Eventos de patrullaje: inicio, fin, ruta, incidente
  • Informes comunitarios: comentarios, divulgación, conflicto entre humanos y vida silvestre

Creación o edición de categorías de eventos

En el editor de formularios de eventos , las categorías se gestionan directamente desde el panel principal.

Crear una nueva categoría de evento

  • Desde el menú de acciones superior, haga clic en ➕ Nueva categoría de evento.
  • Introduzca un nombre para mostrar (la etiqueta que verá el usuario) y el valor se completará automáticamente para crear un identificador único.
  • Guarda los cambios.

Tu nueva categoría aparecerá en el panel principal del editor de formularios de eventos, donde podrás añadir tipos de eventos debajo.
También puedes reordenar las categorías arrastrándolas y soltándolas para controlar cómo aparecen en EarthRanger Web y Móvil.

Categorías de eventos predeterminadas

EarthRanger incluye automáticamente varias categorías de eventos predeterminadas cuando se activa el sitio por primera vez para facilitar el trabajo de los administradores, ya que estas se basan en el uso y las solicitudes más frecuentes. Sin embargo, si estas categorías no son útiles para su sitio, puede desactivarlas.

Desactivar una categoría de evento

  1. En el panel principal del Editor de formularios de eventos , seleccione la Categoría de evento de la lista para abrir su vista de configuración.
  2. En la sección Opciones adicionales , busque la casilla de verificación Activa.
  3. Desmarca la casilla "Activo" para desactivar la categoría.

Cuando una categoría de evento se marca como inactiva:

  • La categoría y todos los tipos de eventos que contiene se ocultarán en EarthRanger Web y Móvil.
  • Esos tipos de eventos no aparecerán en los menús desplegables ni en los flujos de trabajo de informes de eventos.

Puedes reactivar una categoría en cualquier momento volviendo a la misma vista y seleccionando de nuevo la opción "Activa" .
El estado Activo/Inactivo de cada categoría es visible directamente en la interfaz principal del Editor de Formularios de Eventos.

Creación de tipos de eventos con el editor de formularios de eventos.

Guía paso a paso para crear un nuevo tipo de evento.

Para comenzar a crear un tipo de evento , puede:

  • Haga clic en + Nuevo tipo de evento en la parte superior del panel de control, o
  • Haz clic en + Tipo de evento dentro de una categoría de evento específica (esto rellenará automáticamente el campo de categoría).

Detalles del tipo de evento

Al crear un nuevo tipo de evento , deberá configurar lo siguiente:

Campo Descripción
Nombre para mostrar El nombre que se muestra al usuario en EarthRanger .
Valor Un identificador único generado automáticamente a partir del nombre para mostrar, que se puede editar y no se muestra en EarthRanger . Se puede utilizar para el análisis de datos.
Categoría del evento La categoría bajo la cual se organiza este tipo de evento.
Geometría tyPE Define si este evento se reporta como un punto o un polígono . Esto no se puede cambiar después de su creación.
Resolución automática Permite la resolución automática después de un número determinado de horas.
Icono de evento Elige entre el conjunto de iconos disponibles de EarthRanger .
Valores predeterminados Establezca valores iniciales, como prioridad o estado , cuando se creen los eventos.
Estado Establecer como activo o inactivo.

Personalización del diseño del formulario

Lienzo de arrastrar y soltar

La sección Formulario de evento incluye un lienzo donde puede construir la estructura del formulario arrastrando varios elementos del formulario :

Elemento Objetivo
Sección Organiza el contenido en secciones etiquetadas. Admite diseños de 1 o 2 columnas.
Encabezamiento Agregue un encabezado de texto para separar visualmente y etiquetar las partes del formulario. Útil para indicar el propósito de una sección o grupo de campos. Puede elegir el tamaño de visualización (Grande, Mediano o Pequeño).
Lista de opciones Agregue menús desplegables o selecciones múltiples utilizando datos EarthRanger u opciones personalizadas. Obtenga más información sobre cómo configurar las opciones en el EFE.
Fecha y hora Recopile datos temporales de los usuarios. Puede elegir el tipo de entrada como Fecha y hora, Solo fecha o Solo hora.
Numérico Recopile valores numéricos con rangos opcionales y valores de entrada predeterminados.
Texto Recopile respuestas de texto cortas o largas.
Recopilación Habilita la introducción de elementos repetibles (por ejemplo, lista de activos, avistamientos). Obtén más información sobre cómo funcionan las colecciones en el editor de formularios de eventos.
Ubicación Captura las coordenadas manualmente, mediante un mapa o utilizando la ubicación del dispositivo.

Cada campo admite:

  • Etiqueta (lo que ve el usuario)
  • Valor (identificador interno)
  • Visibilidad y estado activo
  • Validación (por ejemplo, campo obligatorio)
  • Descripciones y sugerencias (para guiar a los usuarios)

Puedes arrastrar los campos para reordenarlos y eliminar un campo mediante:

  • Arrastrándolo al cuadro de eliminar, o
  • Seleccione “Eliminar” en el menú de configuración del campo.

Consejo práctico: Utilice secciones y encabezados para crear un flujo lógico y separar visualmente los grupos de campos.

Previsualización y prueba de formularios

Actualmente no existe un modo de vista previa completa , pero puedes inspeccionar visualmente el diseño del formulario directamente en el lienzo mientras lo creas. Usa Guardar y continuar para conservar tu progreso sin salir del editor.

Para probar el formulario en un entorno real:

  • Puedes establecer temporalmente el tipo de evento en " Activo" para previsualizarlo directamente en EarthRanger Web o Mobile .
  • Una vez realizada la prueba, puede volver a cambiar el estado a Inactivo si se necesitan ajustes adicionales.

Este enfoque permite validar el comportamiento y el diseño del formulario en flujos de trabajo reales en EarthRanger Web y Móvil antes de su finalización.

Gestión de tipos de eventos

Edición y actualización de formularios

Para editar un tipo de evento existente o su formulario:

  1. Localiza el tipo de evento dentro de su categoría.
  2. Haz clic en el nombre del tipo de evento para entrar en el modo de edición.
  3. Actualizar campos, diseño o metadatos del evento.

Importante: Solo los tipos de eventos v2 (creados en el Editor de formularios de eventos) se pueden editar con el EFE. Los tipos de eventos creados originalmente en el sistema anterior (v1) no se pueden editar actualmente en el Editor de formularios de eventos.

Sin control de versiones ni función de reversión.

Actualmente, el control de versiones no es compatible con el Editor de formularios de eventos.
No hay forma de ver ni de volver a versiones anteriores de un formulario después de haber realizado cambios.
Los cambios afectarán tanto a los eventos nuevos como a los ya existentes, incluidos aquellos que ya se hayan recopilado utilizando la versión actual del formulario.

Por ejemplo, si reemplaza un campo o lo elimina por completo, es posible que los eventos enviados previamente pierdan visibilidad de los datos.

Archivar o eliminar formularios

Para archivar o eliminar formularios:

  • Abra el tipo de evento y cambie su estado a Inactivo para archivarlo.
  • Si en el menú del tipo de evento aparece la opción de eliminar, puede eliminar el formulario por completo.

Advertencia: Eliminar formularios puede afectar la generación de informes de eventos y la coherencia de los datos históricos. Úselo con precaución: el archivado (establecer como inactivo) es reversible; la eliminación no lo es.