Eventos y tipos de eventos

Los usuarios de EarthRanger registran y rastrean incidentes y actividades dentro de sus áreas protegidas (como incendios, avistamientos de vida silvestre, ubicaciones de trampas, etc.) que se registran como eventos.

Los administradores de EarthRanger tienen la tarea de diseñar y administrar en general el aspecto de los formularios de eventos en la interfaz de usuario del mapa de EarthRanger. Estos formularios de eventos se denominan tipos de eventos.

Es esencial comprender que los eventos y los tipos de eventos son esencialmente lo mismo:

• Los eventos son los incidentes que los usuarios registran y con los que interactúan en las aplicaciones web y móviles de EarthRanger.
• Los tipos de eventos son los formularios de recopilación de datos que configura y administra un administrador en el sitio web de administración de EarthRanger y se colocan en grupos llamados categorías de eventos.
• Las categorías de eventos son grupos en los que se colocan los tipos de eventos que pertenecen a la misma disciplina o enfoque. Por ejemplo, todos los tipos de eventos ecológicos, como avistamientos de vida silvestre, incendios y especies invasoras, entrarían en esta categoría de eventos "Ecología".

Configuración de tipos de eventos

La configuración de los tipos de eventos para los usuarios de EarthRanger implica configurarlos a través del sitio de administración. El proceso de configuración implica lo siguiente, que se puede encontrar en este artículo:

• Para configurar un nuevo evento, consulte Configurar un tipo de evento.
• Para agregar campos (esquema) para un nuevo tipo de evento, consulte Crear un esquema para un tipo de evento.
• Para ocultar eventos específicos a los usuarios, consulte Ocultar tipos de eventos.

Configurar un tipo de evento

En esta sección se explica cómo crear un nuevo tipo de evento. La siguiente sección, Creación de un esquema para un tipo de evento, le guiará en la adición de un esquema que defina las etiquetas y los campos para un evento.

Nota: Un tipo de evento debe tener un esquema válido antes de poder guardarlo.

Para configurar un nuevo tipo de evento:

1. Vaya a su sitio web de administración de EarthRanger (https://yourorganization.pamdas.org) y navegue hasta Inicio > Actividad > Tipos de eventos.
2. Seleccione Agregar tipo de evento, en la parte superior derecha de la pantalla. Aparecerá la página Agregar tipo de evento.
3. En Visualización, ingrese un nombre para el nuevo tipo de evento (por ejemplo, "Avistamientos de vida silvestre").
4. En Valor, ingrese un valor único, generalmente una cadena de texto seguida de "_rep" (por ejemplo, "wildlife_sighting_rep").

Nota: Es una buena práctica ingresar la cadena de valor en letras minúsculas y sin espacios; cuando se utilizan dos o más palabras para el valor, reemplace el espacio con un guión bajo (_) o un guión (-).

5. En Categoría, seleccione la categoría adecuada para el tipo de evento (por ejemplo, Seguridad, Monitoreo, Ecología, Logística, Mantenimiento, etc.).
   • Esta categoría determina en qué grupo aparece el tipo de evento. La categoría de evento también determina el conjunto de permisos que se le debe asignar a un usuario para interactuar con los tipos de eventos de esa categoría.

Esto se debe a que en EarthRanger los permisos se asignan a nivel de grupo. Esto significa que para que un usuario tenga acceso a los eventos dentro de una categoría, el administrador debe asignarle el permiso relacionado con esa categoría de evento. Por ejemplo, cuando se crea una categoría de evento llamada Ecología, el sistema EarthRanger creará automáticamente un conjunto de permisos relacionado con esa categoría de evento llamado Ver permisos de eventos de Ecología, que tendrá los siguientes permisos estándar:

• Puede crear eventos ecológicos
• Puede eliminar eventos ecológicos
• Puede leer eventos ecológicos
• Puede actualizar eventos ecológicos

Por lo tanto, el administrador del sitio EarthRanger asignaría este conjunto de permisos a cualquier usuario que deba tener acceso a todos los eventos en la categoría de eventos de ecología. Estos usuarios podrían crear, leer y actualizar todos los eventos registrados a través de EarthRanger Web y Mobile utilizando cualquiera de los tipos de eventos en la categoría de eventos de ecología. El permiso estándar de eliminación solo tendrá efecto si el usuario tiene acceso al sitio de administración, ya que la eliminación de eventos solo se puede realizar a través del sitio de administración de una instancia de EarthRanger.

• Puede crear una nueva categoría seleccionando el signo  +  verde.

6. Deje la opción Is Collection sin marcar.
7. Seleccione el signo más verde +  en Icon Override y elija el ícono que mejor se relacione con el tipo de evento.

• Nota: No es posible cargar nuevos íconos a través del sitio web de administración. Si necesita un ícono nuevo, comuníquese con support@earthranger.com

8. Ordernum determina el orden de la lista del tipo de evento en la categoría de evento (la secuencia cronológica determina dónde aparece cada tipo de evento; los números más bajos aparecen primero). Este campo se puede dejar en blanco, pero puede asignar valores, si lo desea, para controlar el orden de la lista.
9. Establezca la prioridad predeterminada para el evento: Gris (predeterminado), Verde, Ámbar o Rojo.

Nota: la clasificación de estos colores se realiza según sus preferencias o requisitos operativos. Los colores son ayudas visuales para mostrar qué eventos tienen una determinada prioridad; Alta (Rojo), Medio (Ambar) Normal (Verde), and Baja (Gris)

10. Establezca el estado predeterminado: Nuevo (predeterminado), Activo o Resuelto. 

Nota: Nuevo y Activo permitirá que todos los eventos creados con este tipo de evento aparezcan en el feed de eventos y en el mapa si tienen una ubicación asociada a ellos. Resuelto significa que los eventos se crearán, pero no aparecerán automáticamente en el feed ni en el mapa. Todos los eventos resueltos deberán filtrarse en la interfaz de usuario web si un usuario desea verlos.

11. Ingrese un schema válido para definir los campos que aparecerán en el evento. 
    • Para obtener más información, consulte Creación de un esquema para un tipo de evento.
    • Si no está familiarizado con la configuración de schemas, puede trabajar con el equipo de soporte con un modelo de datos.
12. Seleccione Save.

Creación de un schema para un tipo de evento

El schema de un tipo de evento define las etiquetas y los cuadros de texto (campos) que aparecen en el formulario de tipo de evento resultante.

Para crear un schema en el cuadro schema de un tipo de evento, puede escribir manualmente los detalles del schema y crearlo desde cero. Sin embargo, es más común pegar la información del schema de un tipo de evento existente o usar un schema de muestra como el que se muestra en el schema de muestra anotado para usar en un tipo de evento. Luego, puede modificarlo según sea necesario.

Al pegar el ejemplo de schema anotado (agregar imagen) en el cuadro schema de un tipo de evento, se agregarán campos con anotaciones que los describen en el formulario de evento resultante.

Cómo agregar un esquema a un tipo de evento

En la sección schema de muestra anotado para usar en un tipo de evento, encontrará un esquema que se puede copiar y pegar directamente en el cuadro schema de un tipo de evento. Este schema generará formularios de eventos con cuadros de texto y etiquetas, junto con anotaciones que ayudan a ilustrar la relación entre las configuraciones del schema y el diseño del evento resultante.

Antes de continuar con el esquema, la siguiente sección, Acerca de los schemas para los tipos de eventos, proporciona una breve descripción de cómo funcionan los schemas dentro de los tipos de eventos.

Acerca de los esquemas para tipos de eventos

Los schemas para los tipos de eventos se escriben en formato JSON. Cada esquema consta de dos secciones principales:

• Propiedades: define los atributos de los campos almacenados en la base de datos.
• Definición: determina cómo aparece el formulario Tipo de evento para los usuarios en la interfaz de EarthRanger.

Propiedades del schema

Cada propiedad del esquema debe incluir al menos una clave, un tipo y un título:

• clave: un identificador único para el campo, utilizado tanto en la base de datos como en la sección de definición.
• tipo: define el tipo de datos (por ejemplo, cadena, número).
• título: La etiqueta de texto que se muestra en la interfaz de EarthRanger.

Las propiedades opcionales también pueden incluir:

• mínimo: establece el valor mínimo para un campo numérico (por ejemplo, "0" para un campo de conteo).
• máximo: establece el valor máximo para un campo numérico (por ejemplo, "360" para un campo de rumbo).
• obligatorio: establece el campo que debe completarse obligatoriamente antes de que se pueda guardar el evento en las aplicaciones web y móviles de EarthRanger.
• enum: Define valores que generan una lista desplegable dentro del Evento.
  • enum___xxx___values: Opciones desplegables de la tabla CHOICES.
  • query___xxx___values: Opciones desplegables de la tabla ASUNTO, definidas en la tabla OPCIONES DINÁMICAS.

Definiciones de schemas

La sección de definición define cómo aparecen los campos dentro de la interfaz de usuario de EarthRanger:

• clave: coincide con una clave de la sección de propiedades y define el orden en que se muestran los campos.
• htmlClass: define el diseño general de la pantalla (actualmente, se utiliza "col-lg-6" para crear dos columnas).
• fieldHtmlClass: afecta la visualización del campo (por ejemplo, "date-time-picker json-schema" muestra un selector de calendario/hora). Esto también determina el "tamaño" de los campos utilizando "col-lg-6" = texto corto o "col-lg-12" = texto largo
• tipo: Los campos como "textarea" se expanden a dos líneas, lo que permite ajustar el texto y desplazarse.

Es posible que en futuras actualizaciones se admitan otras definiciones de campo.

Schema de muestra anotado para su uso en un tipo de evento

A continuación se muestra un ejemplo de un esquema que se puede utilizar para crear un tipo de evento:

{
  "schema": {
    "$schema": "http://json-schema.org/draft-04/schema#",
    "title": "DAS JSON Schema Reference List",
    "type": "object",
    "properties": {
      "string_field": {
        "type": "string",
        "title": "String Field (2 Col by using col-lg-6)"
      },
      "number_field": {
        "type": "number",
        "title": "Number Field 0<>360 (2 Col)",
        "minimum": 0,
        "maximum": 360
      },
      "time_field": {
        "type": "string",
        "title": "This is a time field. Look below in the Definition section to get date-time-picker"
      },
      "textarea_field": {
        "type": "string",
        "title": "String with text area, word wrap and scroll. 2 lines max"
      },
      "enum_field": {
        "type": "string",
        "title": "This is a drop down list populated from the Choices table where Field = yesno",
        "enum": {{enum___yesno___values}},
        "enumNames": {{enum___yesno___names}}
      },
      "query_field": {
        "type": "string",
        "title": "This is a drop down populated with Subjects defined by a query in Dynamic Choices table",
        "enum": {{query___blackRhinos___values}},
        "enumNames": {{query___blackRhinos___names}}
      },
      "multi_select_field": {
        "key": "multi_select_field"
      },
      "table_field": {
        "type": "string",
        "title": "(DEPRECATED) This is a drop down list populated from a Table",
        "enum": {{table___TrafficType___values}},
        "enumNames": {{table___TrafficType___names}}
      }
    }
  },
  "definition": [
    {
      "key": "string_field",
      "htmlClass": "col-lg-6"
    },
    {
      "key": "number_field",
      "htmlClass": "col-lg-6"
    },
    {
      "key": "time_field",
      "fieldHtmlClass": "date-time-picker json-schema",
      "readonly": false
    },
    {
      "key": "textarea_field",
      "type": "textarea"
    },
    {
      "key": "enum_field"
    },
    {
      "key": "query_field"
    },
    {
      "key": "multi_select_field",
      "type": "checkboxes",
      "title": "Multiple Selection from Choices Table - BUGS on Display and Export",
      "titleMap": {{enum___carcassrep_species___map}}
    },
    {
      "key": "table_field"
    }  ]
 
}

Ocultar tipos de eventos

Importante: no elimine los tipos de eventos, ya que esto puede afectar su capacidad para recuperar eventos existentes. En su lugar, utilice los siguientes pasos para ocultar los tipos de eventos a los que ya no desea que los usuarios accedan como tipos de eventos en las aplicaciones web y móviles de EarthRanger.

Para ocultar un tipo de evento:

1. En el sitio web de administración de EarthRanger (https://your_organization.pamdas.org), navegue a Actividad > Tipos de eventos.
2. En la columna Visualización de la página Tipos de eventos, seleccione el tipo de evento que desea ocultar. Esto abrirá la página de configuración del tipo de evento.
3. En el menú desplegable Categoría, seleccione OCULTADO.
   • ISi no existe una categoría OCULTA, siga estos pasos para crear una:
     1. Seleccione el signo más verde junto al campo Categoría. Aparecerá la página Agregar categoría de evento.
     2. Id: Deje el ID único predeterminado sin cambios.
     3. Valor: Ingrese “hidden”.
     4. Display: Ingrese “HIDDEN.”
     5. Ordernum: Deje este campo en blanco.
     6. Flag: Selecciona System.
     7. Seleccione Guardar para crear la categoría.
4. Como alternativa, puede hacer clic en la casilla de verificación Está activo en la sección Valores predeterminados de la página de detalles del tipo de evento. Cuando no está marcada, el tipo de evento permanecerá en su categoría de evento original, pero se eliminará de la lista Tipos de eventos.
5. Seleccione Guardar en la página de configuración del tipo de evento para ocultar el tipo de evento.

Once saved, the Event Type will no longer be visible to users or available in the Event Type list, but administrators will still have access to it and all the Events that were recorded using that Event Type if needed.