4.34. Editor - Add a block

Id 

 4.34. 

 

 

 Description 

 

 As an Editor , 

   

 I want to be able to create a missing block for a given site, 

   

 So that I can attach at a later stage the units for which I need to create vertical cabling entries. 

 

 

 

 Priority 

 High 

 

 

 Actors 

 User 

 

 

 API Calls 

 POST /blocks 

 

 

 Linked Processes 

 

 

 

 Status 

 Implemented 

 

 

 

 Preconditions 

 

 The User must be authenticated and have the Editor role. 

 The User has a site id for which he wants to create a block 

 The User has the name of the block and list of zero or more addresses to be linked to that specific block 

 

 Postconditions 

 

 The system returns the created block 

 

 Main flow 

 

 The Editor uses an API call to create a new block for a given site. 

 The system validates the input parameters. 

 The system returns the created block 

 

 Exceptions 

 [400 Bad Request] Invalid input: 

 If mandatory fields are missing or invalid, the system returns an error message. 

 [409 Conflict] Addresses already used 

 Error returned by the system if the all or some of the given address are already linked to another site. 

 [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.