Page Comparison

catissuecoreopenspecimen/rest/ng/storage-containers

Use this resource to create new storage container in the caTissue open specimen application. Use HTTP POST 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:

Parameter	Details
name	Container

Name

name. It should be unique in application
barcode [Optional]	Container

Barcode

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

activityStatusActivity Status of containertempratureInCentigrade

typeName [Optional]

Temperature of storage container. By default it will be null.createdByUser Id who had been created the container

Container type name.
siteName	Site 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 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

storageLocation

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

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[Optional]By Default it will be Numbers. Available Permissible

columnLabelingScheme

Column 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}
temperature	Temperature of the container.
storeSpecimensEnabled	Allow to store specimens in container
allowedSpecimenClasses	Allowed specimen classes to store in container
allowedSpecimenTypes	Allowed specimen types to store in container
allowedCollectionProtocols	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

Use this URL to add storage container in caTissue open specimen application.

Result:

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

Below is the example of the create storage container:

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

catissuecore

openspecimen/rest/ng/storage-containers

Method

POST

Request

application/json

json

Code Block
{


"name":"

Container1

Ark -80 F1",


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

2-edpwesdadas-343

Freezer",


"activityStatus":"Active

",

"createdBy" : {

",
"siteName":"Arkansas Repository",
"storageLocation":{},
"createdBy" {
              "id":1,
              "loginName":"admin@admin.com",

"domainName


              "domain":"

catissue

openspecimen"

},

"tempratureInCentigrade":22.22,

"siteName":"My Site",

"parentContainerName": "Freezer",

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

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

"comments":"Blah blah blah",

"oneDimensionCapacity":10,

"twoDimensionCapacity":10

}

Response

{

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

,

Arkansas Repository",
"storageLocation":{},
"createdBy"

: {

 {
   "id":1,
   "firstName":"Admin",
   "lastName":"Admin",
   "loginName":"

admin@admin

admin@admin.com",

"domainName


   "domain":"

catissue

openspecimen"

},

"tempratureInCentigrade":22.22,

"siteName":"My Site",

"parentContainerName": "Freezer",

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

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

"comments":"Blah blah blah",

"oneDimensionCapacity":10,

"twoDimensionCapacity":10,

"oneDimentionalLabellingScheme ": "Numbers",

"twoDimentionalLabellingScheme ": "Numbers"

}

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

container has been created 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
500	All requests	Internal server error,

Encountered

encountered server error while performing operations

Versions Compared

Old Version 17

New Version Current

Key