This repository is the widgets for the dashboard the Baltimore City Digital Services Team built with the Baltimore Office of Emergency Management (OEM). The purpose was to allow OEM to view many overlapping layers grouped by "Scenarios" so that in an emergency they could quickly navigate to the exact view they needed. It allows an admin to quickly add or remove additional layers through a database view. These widgets and apps are built to be used with ArcGIS Experience Builder.
Please navigate to https://github.com/city-of-baltimore/scenario-dashboard-docker to get set up with docker
This repository contains two widgets:
- scenario-dashboard handles the front-end display of the dashboard. It allows the user to add Layers and Scenarios (also known as Templates on the back-end) to a map.
- scenario-database-config allows the user to directly add/delete Templates, Layers, Categories while viewing the database as a table.
The database is an ArcGIS table called "OEM Database Public". The schema is
| Categories |
|---|
| OBJECTID |
| name |
| Layers | Description |
|---|---|
| OBJECTID | |
| Scope | Area this layer covers |
| Title | Name of layer to be displayed to user |
| URL | Api url for layer |
| Source | Where did the data originate |
| Description | What data the layer reflects |
| Category ID | Assigns the layer to a Category by ID |
| Renderer | JSON object based on Renderer |
| Filter | Allows user to apply filter to layer |
| Templates |
|---|
| OBJECTID |
| Title |
| LayerTemplateRelationships |
|---|
| OBJECTID |
| Template ID |
| Layer ID |
The oem-dashboard widget contains the following components and interfaces:
- Base Widget Component: Handles all api calls and renders the child
- LayerListComponent: lists each of the layers to be removed or adjusted on screen. There are two modals (LayerStyleModal and MoreInfoModal) that this renders and one set of buttons (LayerListButtons).
- TemplateComponent: This handles searching through the templates, removing them, and viewing active templates. It renders AddTemplateItem, ActiveTemplatesMenu, and TemplateSearch.
- SaveTemplateComponent: Creates a button to allow the user to save the current layer list as a template.
- ExportCSVComponent: Handles the link display and status modal for exporting CSV.
- LayerWrapper: Interface for LayerWrapper object which contains the ArcGIS layer.
- Category: Interface for Category which has many layers.
- Template: Interface for Template, also known as Scenarios.
The oem-database-config widget contains the following components:
- Base Widget Component
- AddCategory
- AddLayer
- DeleteCategory
- DeleteLayer
- DeleteTemplate
This project will use issues and branching to track changes from external contributors. If you have a change, please find or open a GitHub issue describing the reason for the change.
Name your branch based on the issue (ex. issue-2).
Reference the issue in your commit message, along with a description of the code changed.
Once the code is ready, open a pull request for review.
Read more about creating a branch
Want to contribute to this README?