This project consists of three separate projects:
Staging: https://spillsmap.dev.utah.gov/
Production: https://spillsmap.deq.utah.gov/
This is a normal web application hosted in firebase. It is used in two different contexts:
When used as a standalone website, data is passed via Url parameters. This is used for linking from the public search results page as well as the lead agency report emails.
When used as an embedded application, data is passed (both ways) via the window.postMessage API. This is used in the DEQ Salesforce Lightning Component. A Url parameter (embedded=true) is used to indicate that the application is being used in an embedded context.
| Parameter | Description |
|---|---|
embedded |
Set to true if the application is being used in an embedded context. This hides the header and footer among other things. |
readonly |
Set to true to hide the location editing controls and disable location updates via map clicks. |
Additionally, when in standalone mode, any of the properties of DataContextType['data'] can be passed as Url parameters. These show up in a sidebar.
Pushes to dev and main branches will automatically deploy to staging and production Firebase instance respectively using the standard UGRC release and deploy actions.
This project consists of a Salesforce Lightning Web Component that embeds the Firebase web application via an iframe. It also includes a simple environmentSwitch component that allows us to switch between the production and development Urls in the iframe.
Development Sandbox: https://utahdeqorg--eid.sandbox.my.salesforce.com/
Production Salesforce Instance: https://utahdeqorg.lightning.force.com/
Development Model: Org
- Install Salesforce CLI (
pnpm install -g @salesforce/cli) - Install Salesforce Extension Pack for VS Code
- Authorize Org Sandbox
org:login:web --alias utahdeqorg --instance-url https://utahdeqorg--eid.sandbox.my.salesforce.com/ --set-default
From salesforce directory:
sf project retrieve start --source-dir force-app
From salesforce directory:
sf project deploy start --source-dir force-app
- Log into sandbox.
- Contacts -> Nathan Hall
- "Log in to Experience as User" -> "DEQ EID Portal Authorized Users"
- "Spill Reports" -> Select a report
- Salesforce Extensions Documentation
- Salesforce CLI Setup Guide
- Salesforce DX Developer Guide
- Salesforce CLI Command Reference
This is the legacy version of the web application that is still used by the Tanks system. They are currently working on migrating Tanks to Salesforce after which this application will be deprecated.
This application has been removed from CI so any new deployments would need to be done manually.
Staging: https://deqspills.dev.utah.gov/
Production: https://deqspills.ugrc.utah.gov/