Versions Compared

Key

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

catissuecoreopenspecimen/rest/ng/storage-containers/{containerIdid}

 

Use this resource for update the Storage Containerstorage container. Use HTTP PUT method to call this API by passing the below details in JSON format. Below

Below are the attributes which need to be sent in the request body:

 

Parameter
Details

...

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
typeName [Optional]Container type name.
siteNameSite name in which the container is present
storageLocation [Optional]

In case of child level container, specify position of the container within parent container.

idIdentifier of the parent container
nameName of the parent container.
positionXColumn position
positionYRow position
noOfRowsNumber of rows in container
noOfColumnsNumber of columns in conatiner
rowLabelingScheme [Optional]

Row labeling scheme, by default it will be Numbers.

Available permissible values are :

{Numbers, Alphabets Upper Case, Alphabets Lower Case, Roman Upper Case, Roman Lower Case}

columnLabelingScheme [Optional]

Column labeling scheme, by default it will be Numbers.

Available permissible values are :

{Numbers, Alphabets Upper Case, Alphabets Lower Case, Roman Upper Case, Roman Lower Case}

temperature [Optional] Temperature of the container.
storeSpecimensEnabledAllow to store specimens in container.
allowedSpecimenClasses [Optional] Allowed specimen classes to store in container
allowedSpecimenTypes [Optional] Allowed specimen types to store in container
allowedCollectionProtocols [Optional] Title of collection protocols to restrict specific protocol for storage
createdByUser info object containing loginName and domainName of user, who had been created the container.

 

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

Use this URL to update Storage Container storage container in caTissue openSpecimen application.

Result:

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

Below is the example of the update Storage Containerstorage container:

URLhttp://<host>:<port>/
catissuecore
openspecimen/rest/ng/storage-containers/
{containerId}
1
MethodPUT
Requestapplication/json
json
Code Block
{

    "name":"KS Cancer Research Center"
}

Response

{

    "id" : "1",

    "name":"KS Cancer Research Center"
}

 

 


"name":"Ark -80 F1",
"barcode":"ARKF1",
"typeName":"Freezer",
"activityStatus":"Active",
"siteName":"Arkansas Repository",
"storageLocation":{},
"createdBy" {
              "id":1,
              "loginName":"admin@admin.com",
              "domain":"openspecimen",
              "emailAddress":"openspecimendemo@gmail.com"
            },
"noOfColumns":1,
"noOfRows":4,
"storeSpecimensEnabled":true,
"childContainers":null,
"temperature":-80,
"columnLabelingScheme":"Numbers","rowLabelingScheme":"Numbers",
"comments":null,
"allowedSpecimenClasses":["Fluid"],
"allowedSpecimenTypes":["DNA"],
"allowedCollectionProtocols":["LCP"]
}

Response

Code Block
{
"id":1,
"name":"Ark -80 F1",
"barcode":"ARKF1",
"typeName":"Freezer",
"activityStatus":"Active",
"siteName":"Arkansas Repository",
"storageLocation":{},
"createdBy" {
   "id":1,
   "firstName":"Admin",
   "lastName":"Admin",
   "loginName":"admin@admin.com",
   "domain":"openspecimen",
   "emailAddress":"openspecimendemo@gmail.com",
   "instituteName":null,
   "admin":true,
   "manageForms":false,
   "cpCount":0,
   "creationDate":null
},
"noOfColumns":1,
"noOfRows":4,
"freePositions":0,
"storeSpecimensEnabled":false,
"childContainers":null,
"temperature":-80,
"columnLabelingScheme":"Numbers",
"rowLabelingScheme":"Numbers",
"comments":null,
"allowedSpecimenClasses":["Fluid"],
"calcAllowedSpecimenClasses":["Fluid"],
"allowedSpecimenTypes":["DNA"],
"calcAllowedSpecimenTypes":["DNA"],
"allowedCollectionProtocols":["LCP"],
"calcAllowedCollectionProtocols":["LCP"],
"occupiedPositions":[1,2,3,4]
}

 

Error Cases :

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