Sites
Overview
Purpose: The Sites page allows users to manage and monitor all sites within the system, including their names, assets inside, tags, Site IDs, and creation dates. Sites represent geographical locations where beacons and assets are deployed.
Access: Access this page via the main navigation menu under the Sites section.
Intended Users: Admins and users with permissions to view or manage sites.
List View (Main Table)
-
The table displays all sites with the following default columns: Site Name, Assets Inside, Tags, Site ID, Create Date.
-
Column Configuration (Table Preferences):
- Click the gear icon to open the Table Preferences modal.
- Select which columns to show or hide (e.g., Site Name, Assets Inside, Tags, Site ID, Create Date).
- Columns can be rearranged by dragging, hidden by deselecting, but resizing is not supported.
- Click Save to apply changes; Cancel to discard.
- Note: Only the specified columns (Site Name, Assets Inside, Tags, Site ID, Create Date) are available.
-
Search and Filter:
-
Use the Search bar to find sites by Site Name.
-
Use the Tags filter dropdown to filter sites by tags (e.g., BLE).
- Steps: Click the filter icon, select tags (e.g., BLE), click Apply to filter, or Clear to reset.
- Expectations: Displays only sites matching the selected tags.
-
-
Actions (Based on Permissions):
- Click the More Actions (…) button next to a site in the table to open a context menu with Edit and Delete options (to be detailed if needed).
- Admins: Add, edit, or delete sites.
- Standard Users: View sites; edit or delete if granted explicit permissions.
-
Pagination: Adjust rows per page (e.g., 50) and navigate pages (e.g., 1 of 7) using the pagination controls at the bottom.
Conditions: You need admin permissions or explicit rights to add sites.
Steps:
-
Click the Add Site button to open the Add Site modal.
-
Step 1: Enter Site Details:
- Site Name: Input the site name (e.g., “Madrid (test)").
- Tags: Select from dropdown or add new tags (e.g., BLE).
- Description: Input an optional description.
- Click Next to proceed or Cancel to discard.
-
Step 2: Define Site Boundary:
-
A map interface appears with a search bar to locate the site.
-
Options:
- Enter an address in the search bar, and the map will load the corresponding coordinates.
- Manually drag the map to adjust the view and select the area.
-
The system automatically captures a screenshot of the selected area as the site boundary.
-
Click Save to confirm; Cancel to discard.
-
-
Expectations: The new site is added to the system with the specified name, tags, description, and boundary map.
Conditions: You need admin permissions or explicit rights to edit sites. The site must already exist.
Steps:
-
Click the More Actions (…) button next to a site (e.g., “Madrid (test)") in the table.
-
Select Edit from the context menu to open the Edit Site modal.
-
Update the following fields:
- Site Name: Modify the name.
- Tags: Add or remove tags.
- Description: Modify the description.
-
Modify Boundary: Use the same map component as in Add Site to adjust the site boundary.
- Steps: Enter a new address or manually drag the map, then save the updated boundary.
-
Click Save to confirm changes; Cancel to discard.
-
Expectations: The updated site reflects changes in the list, including the boundary.
Conditions: You need admin permissions or explicit rights to delete sites. The site must not be linked to active buildings, assets, or geofences.
Consequences: Deleting a site removes it from the system, unpairs it from associated data, and affects related records. If the site is associated with buildings, assets, or geofences, deletion is blocked until all dependencies are removed.
Steps:
-
Click the More Actions (…) button next to a site (e.g., “Madrid (test)") in the table.
-
Select Delete from the context menu to open the Confirm Delete Site modal.
-
If Dependencies Exist:
- A warning modal appears: “Delete Site is disabled in the system because it is associated with other entities in the system. To proceed with deletion, you must first remove all associated entities. Please review the dependencies and try again.”
- Click OK to close the modal and address dependencies.
-
If No Dependencies:
- Review the warning about permanent deletion and its impacts (unpairing, data loss).
- Click Delete to confirm; Cancel to abort.
-
Expectations:
-
If dependencies exist, the site remains until all associated buildings, assets, or geofences are deleted.
-
If no dependencies, the site is permanently removed and cannot be restored.