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.