Skip to main content

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

  1. The User must be authenticated and have the Editor role.
  2. The User has a site id for which he wants to create a block
  3. The User has the name of the block and list of zero or more addresses to be linked to that specific block

Postconditions

  1. The system returns the created block

Main flow

  1. The Editor uses an API call to create a new block for a given site.
  2. The system validates the input parameters.
  3. 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 or block.

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