Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Below are the attributes which need to be sent in the request body :
Parameter
Details
containerIdId of storage container to be updated

http[s]:<host>:<port>/openspecimen/rest/ng/storage-containers/{containerId}

Use this URL to update storage container in openSpecimen application.

Parameter
Details
nameContainer

...

name. It should be unique in application

...

barcode[Optional]Container

...

barcode, By default it will be null. It should be unique in application if barcode is provided

...

activityStatusActivity status of container.
tempratureInCentigrade[Optional]Temperature of storage container. By default it will be null

...

.

...

createdByUser

...

info object containing loginName and domainName of user, who had been created the container

...

.

...

...

siteNameSite name in which the container is present. Either siteName or parentContainerName is mandatory.

...

parentContainerName[Optional]

...

Parent container name. By default

...

is will be null

...

, Either siteName or parentContainerName is mandatory.
holdsCPTitles[Optional]Title of collection protocols to restrict specific protocol for storage
holdsSpecimenTypes[Optional]Specimen of specified types are allowed in container
oneDimensionCapacity

Max capacity of dimension one eg.30

twoDimensionCapacityMax capacity of dimension two eg.30
comments [optional]Comments for container, By default it will be null
oneDimentionLabelingScheme[Optional]

By

...

default it will be Numbers. Available

...

permissible values are :

{

...

numbers, alphabates upper case, alphabates lower case, roman upper case, roman lower case}

twoDimentionLabelingScheme[Optional]

By

...

default it will be Numbers. Available

...

permissible values are :

{

...

 

http[s]:<host>:<port>/openspecimen/rest/ng/storage-containers/{containerId}

Use this URL to update storage container in openSpecimen application.

numbers, alphabates upper case, alphabates lower case, roman upper case, roman lower case}



Result:

The response of this request will contains the details of the updated storage container.

...

URLhttp://<host>:<port>/opespecimen/rest/ng/storage-containers/{containerId}
MethodPATCH
Requestapplication/json
json

{

"name":"Container1",

"barcode":"2-edpwesdadas-343",

"activityStatus":"Active",

"createdBy" : {

              "loginName" : "admin@admin.com",

               "domainName" :"catissue"

},

"tempratureInCentigrade":22.22,

"siteName":"My Site",

"parentContainerName": "Freezerfreezer",

"holdsCPTitles":["Cp1","My CP"],

"holdsSpecimenTypes" : ["Bloodblood","Tissuetissue"],

"comments":"Blah blah blah",

"oneDimensionCapacity":10,

 "twoDimensionCapacity":10

}

Response

{

"id" : 1,

"name":"Container1",

"barcode":"2-edpwesdadas-343",

"activityStatus":"Activeactive",

"createdBy" : {

              "loginName" : "admin@admin.com",

               "domainName" :"catissue"

},

"tempratureInCentigrade":22.22,

"siteName":"My Site",

"parentContainerName": "Freezerfreezer",

"holdsCPTitles":["Cp1","My CP"],

"holdsSpecimenTypes" : ["Bloodblood","Tissuetissue"],

"comments":"Blah blah blah",

"oneDimensionCapacity":10,

 "twoDimensionCapacity":10,

"oneDimentionalLabellingScheme ": "Numbersnumbers",

"twoDimentionalLabellingScheme ": "Numbersnumbers"

}

 

Error Cases :

code
Applies to
Status Message
200All resourcesStorage container has been patched successfully
400All requestsInvalid parameters, e.g  duplicate container Name, blank container Name etc
401All requestsAuthorization failed, User doesn’t have Authority
404All requestsContainer not found, container with given details not present in the system
500All requestsInternal server error, Encountered server error while performing operations