Page Comparison

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 are the attributes which need to be sent in the request body:

containerIdid of storage container to be updated

Parameter	Details
Parameter	Details
name	Container

Name

name. It should be unique in application

barcode

Container BarcodeactivityStatusActivity Status of containertempratureInCentigradeTemperature of storage container.createdByUser Id who had been created the container

[Optional]	Container barcode, By default it will be null. It should be unique in application if barcode is provided
typeName [Optional]	Container type name.
siteName	Site name in which the container is present

parentContainerName

storageLocation [Optional]

Parent container name. By default is will be null cpTitleCollection[Optional]Title of collection protocols to restrict specific protocol for storageholdsSpecimenTypes[Optional]Specimen of specified types are allowed in containeroneDimensionCapacity

Max capacity of dimension one eg.30

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

Parameter

Details

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

id	Identifier of the parent container
name	Name of the parent container.
positionX	Column position
positionY	Row position

noOfRows Number of rows in container

noOfColumns Number 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.

storeSpecimensEnabled Allow 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

createdBy User 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:

URL	`http://<host>:<port>/`

catissuecore

openspecimen/rest/ng/storage-containers/

{containerId}

1

Method

PUT

Request

application/json

json

Code Block
{


"name":"

Container1

Ark -80 F1",


"barcode":"ARKF1",
"typeName":"

2-edpwesdadas-343

Freezer",


"activityStatus":"Active",

"createdBy" : 1,

"tempratureInCentigrade":22.22,

"siteName":"My Site",

"parentContainerName": "Freezer"

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

"holdsSpecimenTypes" : ["Blood","Tissue"],

"comments":"Blah blah blah",

"oneDimensionCapacity":10,

"twoDimensionCapacity":10

}

Response

{


"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":"

Container1

Ark -80 F1",


"barcode":

"2-edpwesdadas-343",

"ARKF1",
"typeName":"Freezer",
"activityStatus":"Active

",

"createdBy" : 1,

"tempratureInCentigrade":22.22,

"siteName":"My Site",

"parentContainerName": "Freezer"

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

"holdsSpecimenTypes" : ["Blood","Tissue"],

"comments":"Blah blah blah",

"oneDimensionCapacity":10,

"twoDimensionCapacity":10

",
"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
200	All resources

Storage Container

Storage container has been updated successfully
400	All requests	Invalid parameters, e.g duplicate

Container Name

container name, blank

Container Name

container name etc
401	All requests	Authorization failed,

User

user doesn’t have

Authority

authority
404	All requests	Container not found,

Container

container with given details not present in the system
500	All requests	Internal server error,

Encountered

encountered server error while performing operations

Versions Compared

Old Version 7

New Version Current

Key