4.64. Viewer - Search sites/blocks/units/equipments by address
| Id | 4.64. |
| Description |
As a Viewer,
I must be able to search for sites, blocks, units or NTPs by address,
So that I can determine the vertical cabling status of a given site, block, unit or NTP. |
| Priority | High |
| Actors | Viewer |
| API Calls |
GET /sites GET /blocks GET /units GET /equipments GET /physical-links |
| Linked Processes | |
| Status | Implemented |
Preconditions
- The User must be authenticated and have the Viewer role.
- The user must have an address to be looked up on the system.
Postconditions
- The System returns the data that matches the request.
Main flow
- The User triggers a search by address.
- The system returns the resources that match the query.
Exceptions
[400 Bad Request] Invalid input:
If mandatory fields are missing or invalid, the system returns an error message.
[404 Not Found] Resource not found:
Error returned if the Server could not find any resource for the given search criteria.
[500 Internal Server Error] System Error
If the system fails to save changes due to an internal error, it displays an appropriate message and logs the error for further investigation.