Skip to main content

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

  1. The User must be authenticated and have the Viewer role.
  2. The user must have an address to be looked up on the system.

Postconditions

  1. The System returns the data that matches the request.

Main flow

  1. The User triggers a search by address.
  2. 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.