Configure locations - SarahJChong/emergency-duress-app GitHub Wiki

What is it used for

1. End Users make distress calls to Security Responders based on their/the user's location.
2. Security Responders are assigned to one or more locations
3. Each location has a default phone number and email address

Any constraints/things to note:

1. Who can update locations: Only "Admin" users can modify locations incl. managing Security Responders assigned to a given location
   • Refer to Manage users for more information
2. Deleting a location: A location can only be deleted if it had NONE Emergency calls / incidents made against it
3. Updating a location name: A location's name can only be change if it has NO ACTIVE Emergency calls / incidents against it
4. Updating a location phone number or email: A location's phone number and email can be updated at anytime
5. Adding Security Responders: Only persons that have logged in before (either in Web app/mobile app) can be added as a Security Responder, since lookup is based on names in Duress app database. The limitation is due to there being no generic way to search for users in different Identity Providers.
   • For more information refer to Security Responder Management
6. Updated locations displayed in app: Any changes to locations will be available next time the user logs into the app

Update a location's details

Overview:

• A location's name can only be change if it has NO ACTIVE Emergency calls / incidents against it
• A location's phone number and email can be changed at anytime

Steps:

1. Log into web app as an Admin user

2. In the "Locations Management" page, click on "Edit" button of the related location you want to update

   

3. If applicable, change the name of the location

   

4. If applicable, change the phone number and/or email of the location and click "Update location"

   

5. Click "Update location" and updated location information will be displayed in location list

   

Adding a new location

Steps:

1. Log into web app as an Admin user

2. In the "Locations Management" page, click on "Add location" button (button is above the list of locations)

3. Add the name, phone number and telephone of the location and click "Add location"

   

4. New location will be displayed in location list (ordered alphbetically)

   

5. Assign Security Responders to the new location - refer to Manage Security Responders for a given location

Delete a location

Overview:

• A location can only be deleted if it had NONE Emergency calls / incidents made against it

Steps:

1. Log into web app as an Admin user

2. In the "Locations Management" page, click on "Delete" button of the related location you want to remove

   

3. Once the location was successfully deleted, the following message will be displayed above the "Add Location" button

   

Manage Security Responders for a given location

Overview:

• Only persons that have logged in before (either in Web app/mobile app) can be added as a Security responder
• A person can be assigned to more than 1 location
• If a person has been removed from all locations, then they will be removed from the Security responder role

Steps:

1. Log into web app as an Admin user

2. In the "Locations Management" page, click on "Manage Security" button of the related location you want to update

   

3. There are 2 methods of finding and adding a users as a security responder

   1. If the person's name are displayed in "Available Security Responders", then click on "Add" button next to to the person you want to add
   2. Search for the name of person you want to add. This will fiter the names in "Available Security Responders" list. Click "Add" button next to the person you want to add

   

4. If successfully added, the person will appear in "Assigned Security Responders" list

   

5. To remove a person as security responder, then click "Remove" button next to their name.

   • Note:
     • If person was successfully removed, the person will disappear from the "Assigned Security Responders" list and is available to be assigned again
     • If a person has been removed from all locations, then they will be removed from the Security responder role

6. Once all changes have been made, click "Close"

Updating default phone number of Emergency calls made by logged out users

Overview:

• When a user is logged out of the app, they will still be able to make an emergency call. Given we don't know what their location is, a default company wide phone number is called instead

Steps:

• This default number is updated in the Environment config files - refer to Steps to change default company contact number