catissuecore/rest/ng/collection-protocols/{id}
or
catissuecore/rest/ng/collection-protocols/title={title}
or
catissuecore/rest/ng/collection-protocols/shortTitle={shortTitle}
Use this resource for update the Collection Protocol. 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:
Parameter | Details |
|---|---|
| title | Collection protocol title.Unique in the application |
| shortTitle | Collection protocol short title. Unique in the application |
| startDate | Collection protocol starting date |
| endDate[optional] | Collection protocol end date. If given then the endDate should not be earlier than startDate. |
| investigator | Principal investigator on CP Mainly contains following parameters : loginName : User login name. For this specified user must be present in application. domainName: Name of domain to which user belongs to. By default it will be catissue. |
| activityStatus | Activity status of a collection protocol |
| cpType[optional] | Collection protocol type |
| labelFormat[optional] | CP label format |
| derivedLabelFormat[optional] | Derived label format |
| aliquotLabelFormat[optional] | Aliquot label format |
| ppIdFormat[optional] | PPId format |
| cpSiteRoles[optional] | It is collection of Sites and Roles with respect to CP. By default it will be none. i.e. Blank collection. Mainly contains following parameters : roleName : Role of user like Scientist, Admin etc. For this attribute role must be present in application. siteName: Site name. For this attribute Site must be present in application.
|
http[s]:<host>:<port>/catissuecore/rest/ng/collection-protocols/{id}
or
http[s]:<host>:<port>/catissuecore/rest/ng/collection-protocols/title={title}
or
http[s]:<host>:<port>/catissuecore/rest/ng/collection-protocols/shortTitle={shortTitle}
Use this URL to update collection protocol in caTissue application.
Result:
The response of this request will contains the details of the updated collection protocol.
Below is the example of the update collection protocol:
| URL |
or
or
|
| Method | PUT |
| Request | application/json |
| json | { "title":"My Cp", "shortTitle": "CpM", "startDate" : "2014-07-23", "cpType": "Parent", "activityStatus": "Active", "endDate" : "2018-07-23", "investigator" : {"loginName" : "admin@admin.com", "domainName" :"catissue"}, "cpSiteRoles" : { "siteName" : "My Site", "roleName" : "Scientist" } } |
Response | { "id" : 1, "title":"My Cp", "shortTitle": "CpM", "startDate" : "2012-07-23", "endDate" : "2018-07-23", "cpType": "Parent", "startDate": null, "endDate": null, "activityStatus": "Active", "labelFormat": null, "derivedLabelFormat": null, "aliquotLabelFormat": null, "ppIdFormat": "", "investigator" : {"loginName" : "admin@admin.com", "domainName" :"catissue"}, "cpSiteRoles" : { "id" : 1, "siteName" : "My Site", "roleName" : "Scientist" } } |
Error Cases :
code | Applies to | Status Message |
|---|---|---|
| 200 | All resources | Collection Protocol has been updated successfully |
| 400 | All requests | Invalid parameters, e.g duplicate CP title, blank CP Title etc |
| 401 | All requests | Authorization failed, User doesn’t have Authority |
| 404 | All requests | CP not found, CP with given details not present in the system |
| 500 | All requests | Internal server error, Encountered server error while performing operations |