Los usuarios EarthRanger registran y hacen seguimiento de incidentes y actividades dentro de sus áreas protegidas como Eventos . Estos Eventos pueden representar desde incendios hasta avistamientos de vida silvestre o la ubicación de trampas.

• Los eventos reflejan situaciones que ocurren en el terreno.
• Los eventos pueden ser creados por un usuario o por un servicio conectado.
• Los eventos pueden ser independientes, estar asociados con patrullas ( ver: Patrullas ) o agruparse en incidentes (ver: Cómo usar incidentes ).

Los administradores EarthRanger tienen la tarea de crear la estructura (incluidos los campos obligatorios), el diseño y la gestión de cualquier evento que se pueda crear desde la vista de mapa EarthRanger . Estas estructuras de plantilla para eventos se denominan tipos de eventos .

• Los eventos son los incidentes que los usuarios registran e interactúan en las aplicaciones web y móviles EarthRanger . Cada evento se basa en una estructura fija definida por el tipo de evento configurado.
• Los tipos de eventos son las plantillas/formatos predefinidos de eventos que un administrador puede configurar y gestionar a través del portal de administración EarthRanger y se agrupan en categorías de eventos :
• Las categorías de eventos son grupos en los que se pueden colocar los tipos de eventos . Por ejemplo, todos los tipos de eventos ecológicos, como "Avistamientos de vida silvestre", "Incendios" y "Especies invasoras", pueden pertenecer a una categoría de eventos de "Ecología".

Configuración del tipo de evento

Los tipos de eventos se pueden configurar para los usuarios EarthRanger a través del sitio de administración. Un método consiste en utilizar un enfoque basado en esquemas, que implica los siguientes pasos:

• Configurar un nuevo tipo de evento
• Cree la estructura del tipo de evento (defina las etiquetas, los campos y la disposición de los campos a través del esquema de evento).

Configurar un nuevo tipo de evento (método basado en esquema)

Nota: Para este método, un tipo de evento debe tener un esquema válido antes de poder guardarlo. Si utiliza el editor de formularios de eventos, el esquema se crea visualmente como parte del proceso de creación del formulario.

1. Vaya a su sitio web de administración EarthRanger ( https://yourorganization.pamdas.org ) y navegue a 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. Visualización: introduzca un nombre visible para el usuario para el nuevo tipo de evento (por ejemplo, "Avistamiento de fauna silvestre").
4. Valor: introduzca un valor interno único o una clave para este tipo de informe, normalmente una cadena de texto seguida de “_rep” (por ejemplo, “wildlife_sighting_rep”).
   
   Nota : Es una buena práctica introducir la cadena de valor en minúsculas y sin espacios; cuando se utilicen dos o más palabras para el valor, sustituya el espacio por un guion bajo (_) o un guion (-).
5. Categoría : seleccione la categoría apropiada 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 debe tener un usuario para interactuar (crear, editar, ver, etc.) con los tipos de evento de dicha categoría.
   
   Puedes crear una nueva categoría de evento haciendo clic en el signo más verde (+).

6. ¿Es una colección ?: Dejar sin marcar.
7. Anulación de icono: Haga clic en el signo '+' verde que aparece junto a y elija un icono que se ajuste mejor al tipo de evento (use Ctrl + F (Windows) / Cmd + F (Mac) para buscar iconos por palabra clave).
   
   Nota : No es posible subir nuevos iconos a través del sitio web de administración. Si necesita un nuevo icono , póngase en contacto con support@earthranger.com.
8. El campo Ordernum determina el orden de la lista de tipos de eventos dentro de las categorías de eventos (los números más bajos aparecen primero). Este campo puede dejarse en blanco y se asignará un valor automáticamente.
9. Establezca la prioridad predeterminada para el evento : Gris (predeterminado), Verde, Ámbar o Rojo.
   Los colores ofrecen una descripción visual/de un vistazo de la prioridad de un evento: Alta (Rojo), Media (Ámbar), Normal (Verde) y Baja (Gris).
   Nota : la clasificación de estos colores se realiza según sus preferencias o requisitos operativos.
10. Establezca el estado predeterminado : Nuevo (predeterminado), Activo o Resuelto.
    
    Nota : Los estados Nuevo y Activo harán 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 de forma predeterminada.
    Los eventos resueltos no aparecerán automáticamente en el feed y el mapa de forma predeterminada. Un filtro lo hará. Deben aplicarse en la interfaz web si el usuario desea verlas.
11. Introduzca un esquema válido para definir los campos que aparecerán en el evento.
    • Para obtener más información, consulte la siguiente sección: Creación de un esquema para un tipo de evento.
    • Si no está familiarizado con la configuración de esquemas, puede trabajar con el equipo de soporte y una hoja de cálculo del modelo de datos .
12. Haz clic en Guardar .

Creación de un esquema para un tipo de evento (método manual)

Si utiliza el método tradicional (introduciendo manualmente un esquema), este define las etiquetas, la estructura y los campos que aparecen en el formulario de tipo de evento resultante.

Usted tiene el control total sobre el diseño del tipo de evento , y el esquema se puede crear manualmente desde cero. Sin embargo, lo más común es usar un esquema existente como punto de partida y modificarlo según sus necesidades.

Agregar un esquema a un tipo de evento

En la sección siguiente, encontrará un esquema que puede copiar y pegar directamente en el cuadro Esquema de un tipo de evento (consulte Esquema de ejemplo anotado para usar en un tipo de evento ).

Este esquema de ejemplo generará formularios de eventos con cuadros de texto y etiquetas, junto con anotaciones que ayudan a ilustrar la relación entre la configuración del esquema y el diseño de eventos resultante.

Antes de continuar con el esquema, la siguiente sección proporciona una breve descripción de cómo funcionan los esquemas dentro de los Tipos de Eventos :

Acerca de los esquemas para tipos de eventos

Los esquemas para los tipos de eventos están escritos en formato JSON. Cada esquema consta de dos secciones principales:

• Propiedades : Define los atributos de los campos, tal como se almacenan en la base de datos.
• Definición : Determina cómo se muestra el formulario Tipo de evento a los usuarios en la interfaz EarthRanger .

Propiedades del esquema

Cada propiedad en el 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, lista de opciones).
• Título : La etiqueta de texto que se muestra en la interfaz 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 orientación).
• Requerido : Marca el campo como obligatorio para permitir que un evento se guarde tanto en la aplicación web como en la aplicación móvil 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 SUBJECT, definidas en la tabla DYNAMIC CHOICES.

Definiciones de esquemas

La sección de definiciones define cómo aparecen los campos dentro de la interfaz de usuario 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 visualización (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 calendario/selector de hora). Esto también determina el "tamaño" de los campos usando "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 el ajuste de texto y el desplazamiento.

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

Esquema de muestra anotado para su uso en un tipo de evento.

Aquí tienes 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"
 } ]
 
}

Para ocultar un tipo de evento:

1. Desde su portal de administración EarthRanger (https://your_organization.pamdas.org), navegue a Actividad > Tipos de eventos .
2. En la columna "Mostrar" de la página "Tipos de evento" , haga clic en el nombre que desea ocultar. Esto abrirá la página de configuración del tipo de evento .
3. En el menú desplegable Categoría , seleccione OCULTO .
   • Si no existe una categoría OCULTA , siga estos pasos para crear una:
     1. Seleccione el signo más verde que aparece 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 : Introduzca “oculto”.
     4. Visualización : Introduzca “OCULTO”.
     5. Número de pedido : Deje este campo en blanco.
     6. Bandera : Seleccionar sistema.
     7. Seleccione Guardar para crear la categoría.
        

1. Como alternativa, puede marcar la casilla "Está activo" en la sección "Valores predeterminados" de la página de detalles del tipo de evento . Si no la marca, el tipo de evento permanecerá en su categoría original, pero se eliminará de la lista de eventos .
   

1. Seleccione Guardar en la página de configuración del tipo de evento .

Una vez guardado, el tipo de evento ya no será visible para los usuarios ni estará disponible en la lista de tipos de evento , pero los administradores seguirán teniendo acceso a él y a todos los eventos que se registraron utilizando ese tipo de evento (si fuera necesario).