Los usuarios EarthRanger registran y rastrean incidentes y actividades dentro de sus áreas protegidas como Eventos . Estos Eventos pueden representar desde incendios hasta avistamientos de fauna silvestre y ubicaciones de trampas.

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

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

• Los eventos son los incidentes que los usuarios registran y con los que 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 plantillas/formatos predefinidos de eventos que un administrador puede configurar y administrar a través del portal de administración EarthRanger y se ubican en grupos denominados 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", "Incendio" y "Especies invasoras" pueden caer en una categoría de evento "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
• Crear la estructura del tipo de evento (definir 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 para poder guardarlo. Si utiliza el editor de formularios de eventos, el esquema se crea visualmente durante el proceso de creación del formulario.

1. Vaya al sitio web de administración EarthRanger ( https://yourorganization.pamdas.org ) y navegue a Inicio > Actividad > Tipos de eventos .
2. Seleccione "Añadir tipo de evento " en la esquina superior derecha de la pantalla. Aparecerá la página "Añadir tipo de evento" .
3. Pantalla: ingrese un nombre visible para el usuario para el nuevo tipo de evento (por ejemplo, "Avistamiento de vida silvestre").
4. Valor: ingrese un valor interno o clave único para este tipo de informe, generalmente una cadena de texto seguida de “_rep” (por ejemplo, "wildlife_sighting_rep").
   
   Nota : Es una buena práctica ingresar la cadena de valores 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 guion (-).
5. 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 . También determina el conjunto de permisos que debe tener un usuario para interactuar con los tipos de evento (crear, editar, ver, etc.) de esa categoría.
   
   Puede crear una nueva categoría de evento haciendo clic en el signo más verde +.

6. Es Colección : Déjelo sin marcar.
7. Anulación de ícono: haga clic en el signo "+" verde al lado y elija el ícono que mejor se adapte al tipo de evento (use Ctrl + F (Windows) / Cmd + F (Mac) para buscar íconos por palabra clave)
   
   Nota : No se pueden subir nuevos íconos a través del sitio web de administración. Si necesita un nuevo ícono , contacte con support@earthranger.com
8. El número de orden determina el orden de la lista del tipo de evento dentro de la categoría de evento (los números más bajos aparecen primero). Este campo puede dejarse en blanco y se le asignará un valor automáticamente.
9. Establezca la prioridad predeterminada para el evento : gris (predeterminado), verde, ámbar o rojo.
   Los colores dan 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 depende de 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 que utilicen este tipo de evento aparezcan en la fuente de eventos y en el mapa si tienen una ubicación asociada a ellos de manera predeterminada.
    Los eventos resueltos no aparecerán automáticamente en el feed ni en el mapa de forma predeterminada. Un filtro ... deben aplicarse en la interfaz web si un usuario desea verlos.
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 del esquema, puede trabajar con el equipo de soporte y una hoja de cálculo del modelo de datos .
12. Haga clic en Guardar .

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

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

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

Agregar un esquema a un tipo de evento

En la sección a continuación, encontrará un esquema que se puede copiar y pegar directamente en el cuadro Esquema de un tipo de evento (consulte Esquema de muestra 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 las configuraciones del esquema y el diseño del evento 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 tipos de eventos se escriben 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 aparece el formulario Tipo de evento para los usuarios en la interfaz EarthRanger .

Propiedades del esquema

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 dato (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 rumbo).
• obligatorio : marca el campo como obligatorio para permitir que se pueda guardar un evento en las aplicaciones web y móviles EarthRanger .
• enum : define valores que generan una lista desplegable dentro del evento.
  • enum___xxx___values: Opciones desplegables de la tabla CHOICES.
  • consulta___xxx___valores: Opciones desplegables de la tabla ASUNTO, definidas en la tabla OPCIONES DINÁMICAS.

Definiciones de esquemas

La sección de definición 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 pantalla (actualmente, se utiliza "col-lg-6" para crear dos columnas).
• fieldHtmlClass : Afecta la visualización del campo (p. ej., "date-time-picker json-schema" muestra un selector de calendario/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 ajustar el texto y desplazarse.

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

Esquema 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"
 } ]
 
}

Para ocultar un tipo de evento:

1. Desde el portal de administración EarthRanger (https://your_organization.pamdas.org), navegue a Actividad > Tipos de eventos .
2. En la columna "Visualización" de la página "Tipos de evento ", haga clic en el nombre del tipo de evento que desea ocultar. Se 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 junto al campo Categoría . Aparecerá la página "Añadir categoría de evento" .
     2. Id : Deje el ID único predeterminado sin cambios.
     3. Valor : Ingrese “oculto”.
     4. Pantalla : Ingrese “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 conservará 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 eventos , pero los administradores aún tendrán acceso a él y a todos los eventos que se registraron usando ese tipo de evento (si es necesario).

A continuación: Cree tipos de eventos personalizados con el editor de formularios de eventos