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

 

containerIdid of storage container to be updated
Parameter
Details
Parameter
Details
nameContainer
Name
name. It should be unique in application
barcode [Optional]Container
BarcodetempratureInCentigrade
barcode, By default it will be null. It should be unique in application if barcode is provided
activityStatusActivity Status of containercreatedByUser Id who had been created the container
typeName [Optional]
Temperature of storage container. By default it will be null
Container type name.
siteNameSite name in which the container is present
. Either siteName or parentContainerName is mandatory.parentContainerName
storageLocation [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 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 nulloneDimentionLabelingScheme[Optional]By Default it will be Numbers. Available Permissible

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,

Alphabates

Alphabets Upper Case,

Alphabates

Alphabets Lower Case, Roman Upper Case, Roman Lower Case}

twoDimentionLabelingScheme
columnLabelingScheme [Optional]
By Default

Column labeling scheme, by default it will

be Numbers

be Numbers.

Available

Permissible

permissible values are :

{Numbers,

Alphabates

Alphabets Upper Case,

Alphabates

Alphabets Lower Case, Roman Upper Case, Roman Lower Case}

Parameter
Details

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":"
Container1
Ark -80 F1",

"barcode":"ARKF1",
"typeName":"
2-edpwesdadas-343
Freezer",

"activityStatus":"Active",
"siteName":"Arkansas Repository",
"storageLocation":{},

"createdBy" {
              "id":1,

"tempratureInCentigrade":22.22,

"siteName":"My Site",

"parentContainerName": "Freezer",

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

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

"comments":"Blah blah blah",

"oneDimensionCapacity":10,

 "twoDimensionCapacity":10

}

Response

{


              "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":"ARKF1",
"typeName":"
2-edpwesdadas-343
Freezer",

"activityStatus":"Active",
"siteName":"Arkansas Repository",
"storageLocation":{},

"createdBy" {
   "id":1
,

"tempratureInCentigrade":22.22,

"siteName":"My Site",

"parentContainerName": "Freezer",

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

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

"comments":"Blah blah blah",

"oneDimensionCapacity":10,

 "twoDimensionCapacity":10,

"oneDimentionalLabellingScheme
,
   "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",

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