In EarthRanger, Event Type dropdown menus allow users and administrators to classify activities in protected areas, such as species sightings, unauthorized activity, and environmental observations. EarthRanger administrators can adjust dropdown choices for Event fields to better reflect their site’s needs.Here is the detailed process for modifying these choices, including adding, reordering, and verifying dropdown options.
Understanding Events and Event Types
In EarthRanger:
- Events are user-facing entries in the application where specific activities are logged and reviewed.
-
Event Types are administrative classifications that configure and organize these activities.
Changes to Event Types in the administration interface directly impact the dropdown choices users see when creating or editing Events.
Updating Dropdown Choices in Events
To adjust dropdown menu options in Events, you’ll update the schema for the associated Event Type in the EarthRanger Administration website. Follow these steps to make changes:
Step 1: Locate the Choice Field to Modify
- In the EarthRanger Administration website, navigate to Activity > Event Types.
- In the Display column, select the Event Type associated with the Event you want to modify (e.g., Human-Wildlife Contact).
- Within the schema for this Event Type, find the title of the dropdown menu field you wish to update (e.g., "Species").
- Locate the enumNames key, which will display the specific Choice Field value, such as:
"enumNames": {{enum__
hwrep_species
__names}}
the value between enum and names is the identifier we will use in the next step.
This identifier will be used to update dropdown options.
Step 2: Modify or Add Choices in the Dropdown Menu
To adjust the available dropdown options:
- In the Administration website, go to Choices > Choices.
- Use the Search box to enter the Choice Field identifier from Step 1 (e.g., "
hwcrep_species
") and select Search. - Edit fields in the Display column to update names or adjust values in the Ordernum column to specify the display order for each choice.
Important Note:
- Avoid updating the Values of existing choices. Doing so can cause breaking changes in past Events where this option was selected. Specifically:
- If you update only the Display content of existing choices, the past Events in which this option is chosen will update their Display text accordingly.
- If you update the Value, the system will no longer recognize the choice. Past Events using this option will display a blank field.
To add a new choice:
- Search for the relevant Choice Field on the Choices page.
- Select Add Choice to open the configuration page.
- Complete the fields as follows:
- Id: Accept the autogenerated value.
-
Model: Enter
activity.event
. - Field: Enter the Choice Field name from Step 1.
- Value: Enter a lowercase, no-spaces identifier for the new option (e.g., vervet_monkey).
- Display: Enter how you want the choice to appear in the dropdown.
- Ordernum: Specify a display order. Choices are listed alphabetically if no order is provided.
- Save the new entry.
Disable Dropdown Choices
If you want to make a choice unavailable for new Events while retaining it in past Events, you can disable the option instead of removing or updating it.
- Search for the relevant Choice Field on the Choices page.
- Select the choice you want to disable.
- Change its Status to Disabled.
-
Save the changes.
Disabled choices will no longer appear in the dropdown menu for new Events but will remain visible in past Events where they were selected.
Step 3: Verify the Dropdown Changes in Events
To confirm the changes in EarthRanger:
- Refresh the EarthRanger web application.
- Create a new Event of the type you modified (e.g., Human Wildlife Contact).
- Check the dropdown to confirm the new choices display as configured.
Following these steps allows administrators to customize Event dropdown choices to reflect site-specific classifications and improve usability for EarthRanger users.