Les utilisateurs d’EarthRanger enregistrent et suivent les incidents et les activités dans leurs zones protégées sous forme d'Événements. Ces Événements peuvent représenter tout, des incendies aux observations de la faune en passant par les emplacements de collets. 

• Les événements reflètent des situations qui se produisent sur le terrain
• Les événements peuvent être créés par un utilisateur ou par un service connecté
• Les événements peuvent être autonomes, associés à des Patrouilles (voir : Patrouilles ) ou regroupés dans des Incidents (voir : Comment utiliser les Incidents) 

Les administrateurs EarthRanger sont chargés de créer la structure (y compris les champs requis), la conception et la gestion de tout Événement pouvant être créé depuis la vue Carte d’EarthRanger. Ces structures de modèle pour les événements sont appelées Types d'Événements.

• Les événements sont les incidents que les utilisateurs enregistrent et avec lesquels ils interagissent dans les applications Web et Mobile EarthRanger. Chaque Événement est basé sur une structure fixe définie par le Type d'Événement qui a été configuré.
• Les Types d'Événements sont les modèles / formats prédéfinis d'Événements pouvant être configurés et gérés par un administrateur via le portail d'administration EarthRanger et sont placés dans des groupes appelés Catégories d'Événements :
• Les Catégories d'Événements sont des groupes dans lesquels les Types d'Événements peuvent être placés. Par exemple, tous les Types d'Événements écologiques, comme « Observations de la faune », « Incendie » et « Espèces envahissantes » peuvent appartenir à une Catégorie d'Événements appelée « Écologie ».

Configuration du Type d'Événement

Les Types d'Événements peuvent être configurés pour les utilisateurs EarthRanger via le site d'administration. Le processus de configuration comprend les étapes suivantes :

• Configurer un nouveau Type d'Événement
• Créer la structure du Type d'Événement (définir les étiquettes, les champs et la disposition des champs via le schéma d'Événement)

Configurer un nouveau Type d'Événement

Remarque : Un Type d'Événement doit avoir un schéma valide avant de pouvoir être enregistré.

1. Accédez à votre site d'administration EarthRanger (https://yourorganization.pamdas.org) et naviguez vers Accueil > Activité > Types d'Événements.
2. Sélectionnez Ajouter un Type d'Événement – en haut à droite de l’écran. La page Ajouter un type d'événement apparaîtra.
3. Affichage : saisissez un nom visible par l’utilisateur pour le nouveau Type d'Événement (ex. : "Observation de la faune").
   Valeur : entrez une valeur interne ou une clé unique pour ce type de rapport, généralement une chaîne de texte suivie de “_rep” (ex. : "observation_faune_rep").
4. Remarque : Il est recommandé d'entrer la chaîne de valeur en lettres minuscules et sans espaces ; lorsqu’il y a deux mots ou plus, remplacer l’espace par un underscore (_) ou un tiret (-).
   Catégorie : sélectionnez la catégorie appropriée pour le Type d'Événement (ex. : Sécurité, Surveillance, Écologie, Logistique, Maintenance, etc.).
   
   Cette Catégorie détermine dans quel groupe le Type d'Événement apparaîtra. La Catégorie d'Événement détermine également l’ensemble de permissions qu’un utilisateur doit avoir pour interagir avec (créer, modifier, consulter, etc.) les Types d'Événements de cette Catégorie.
   
   Vous pouvez créer une nouvelle Catégorie d'Événement en cliquant sur le signe plus vert +

6. Is Collection : laissez décoché.
7. Substitution d’icône : cliquez sur le signe plus vert '+' à côté, et choisissez une icône qui convient au Type d'Événement (utilisez Ctrl + F (Windows) / Cmd + F (Mac) pour rechercher par mot-clé)
   
   Remarque : De nouvelles icônes ne peuvent pas être téléchargées via le site Admin. Si une nouvelle icône est nécessaire, contactez support@earthranger.com
8. Ordernum détermine l’ordre d’affichage du Type d'Événement dans sa Catégorie (valeurs plus basses apparaissent en premier). Ce champ peut être laissé vide, une valeur sera automatiquement assignée.
9. Définissez la Priorité par défaut de l’Événement : Gris (par défaut), Vert, Orange ou Rouge.
   Les couleurs fournissent une indication visuelle du niveau de priorité d’un événement : Élevé (Rouge), Moyen (Orange), Normal (Vert), Faible (Gris).
   Remarque : La classification de ces couleurs dépend de vos préférences ou besoins opérationnels.
10. Définissez l’État par défaut : Nouveau (par défaut), Actif ou Résolu. 
    
    Remarque : Les états Nouveau et Actif feront apparaître automatiquement tous les événements créés à l’aide de ce Type d'Événement dans le flux d’événements et sur la carte (s’ils ont une localisation). Les événements Résolus n’apparaîtront pas automatiquement – un filtre devra être appliqué sur l’interface Web pour les voir.
11. Entrez un schéma valide pour définir les champs qui apparaîtront dans l’Événement. 
    • Pour plus d'informations, reportez-vous à la section suivante : Création d’un schéma pour un Type d'Événement.
    • Si vous n’êtes pas familier avec la configuration de schémas, vous pouvez collaborer avec l’équipe de support et une feuille de calcul de modèle de données.
12. Cliquez sur Enregistrer.

Création d’un schéma pour un Type d'Événement

Le schéma d’un Type d'Événement définit les étiquettes, la structure et les champs qui apparaîtront dans le formulaire associé à ce Type d'Événement.

Vous avez un contrôle total sur la disposition, et le schéma peut être construit manuellement depuis zéro. Il est cependant plus courant d’utiliser un schéma existant comme base et de l’adapter à vos besoins.

Ajout d’un schéma à un Type d'Événement

Vous trouverez ci-dessous un schéma pouvant être copié et collé directement dans la boîte Schema d’un Type d'Événement (voir Exemple de schéma annoté à utiliser pour un Type d'Événement). 

Ce schéma génère des formulaires d’Événements avec champs de texte, étiquettes et annotations expliquant le lien entre la configuration du schéma et la disposition de l’Événement.

À propos des schémas pour les Types d'Événements

Les schémas sont écrits en format JSON. Chaque schéma contient deux sections principales :

• Properties: définit les attributs des champs, tels qu'enregistrés dans la base de données. 
• Definition: détermine l'apparence du formulaire dans l'interface EarthRanger. 

Propriétés du schéma

Chaque propriété doit inclure au minimum une clé (key), un type (type) et un titre (title).

• key: identifiant unique du champ, utilisé dans la base de données et dans la section definition. 
• type: définit le type de données (ex. : chaîne, nombre, liste de choix). 
• title: étiquette affichée dans l'interface EarthRanger. 

Autres propriétés possibles :

• minimum : valeurs numériques min. et max. 
• required : rend le champ obligatoire pour enregistrer l'événement sur Web et Mobile 
• enum : valeurs pour générer une liste déroulante
• enum__xxx___values / query___xxx___values : options dynamiques issues des tables CHOICES ou SUBJECT

Définitions du schéma

La section definition définit l'affichage des champs dans l’interface utilisateur EarthRanger :

• key : correspond à une clé des properties et définit l'ordre d'affichage 
• htmlClass : définit la disposition (ex. : “col-lg-6” pour deux colonnes) 
• fieldHtmlClass : affecte l'apparence (ex. : “date-time-picker json-schema” affiche un calendrier)
• type : ex.: “textarea” pour champs multiligne 

Exemple de schéma annoté à utiliser pour un Type d'Événement

Voici un exemple de schéma qui peut être utilisé pour créer un type d’événement :

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

Pour masquer un Type d'Événement :

1. Depuis le portail Admin (https://your_organization.pamdas.org), accédez à : Activité > Types d'Événements
2. Dans la colonne Affichage, cliquez sur le nom du Type d'Événement à masquer
3. Dans la liste déroulante Catégorie, sélectionnez HIDDEN
4. Si la catégorie HIDDEN n’existe pas :
   1. Cliquez sur le + vert à côté du champ Catégorie
      1. ID : laissez l’ID par défaut
      2. Valeur : entrez “hidden”
      3. Affichage : entrez “HIDDEN”
      4. Ordernum : laisser vide
      5. Drapeau : sélectionnez Système
5. Cliquez sur Enregistrer pour créer la catégorie
   Alternative : décochez la case Is Active dans la section Valeurs par défaut du Type d'Événement. Le Type restera dans sa catégorie d’origine, mais sera supprimé de la liste des Événements.
6. Cliquez sur Enregistrer dans la page de paramètres du Type d'Événement.

Une fois enregistré, le Type d'Événement ne sera plus visible ou disponible pour les utilisateurs, mais les administrateurs y auront toujours accès, ainsi qu’aux Événements enregistrés avec ce Type.