catissuecoreopenspecimen/rest/ng/users/{userId}
Use this resource to update the user. Use HTTP PUT method to call this API by passing the below details in JSON format.
...
Parameter | Details |
|---|---|
| userId | User Id id of the user |
| firstName | First name of the user |
| middleName | Middle name of the user |
| domainName | It is the name of the authentication domain. You cannot able to change domain of the user once user has been created |
| emailAddress | Email Address address of the user. This attribute should be unique in catissue openSpecimen application |
| loginName | Login Name name through which user can login to catissue openSpecimen application, should be unique in authentication domains. You cannot able to change domain of the user once user created |
| userSiteNames[Optional] | Collection of the site names to which the user belongs. By default it will be none. i.e. Blank blank collection |
| userCPRoles[Optional] | Collection of the Collection Protocol the collection protocol titles and their role names to which user belongs. By default it will be none. i.e. Blank blank collection. Mainly contains following parameters : roleName : Role of user like Scientist, Admin etc. For this attribute role must be present in application. cpTitle : Collection Protocol title. For this attribute CP must be present in application. |
| activityStatus | Activity status of the user, permissible values are {active, closed, pending, disabled} |
| deptName | Name of department to which user belongs |
| comments [optional] | Comments on user given by admin while approval |
| country | Country of the user |
| state [optional] | State of the user |
| city [optional] | City of the user |
| zipCode | ZipCode Zip code of the user |
| phoneNumber [optional] | Phone number of the user |
| faxNumber [optional] | Fax number of the user |
http[s]:<host>:<port>/catissuecoreopenspecimen/rest/ng/users/{userId}
Use this URL to update user in caTissue openSpecimen application.
Result:
The response of this request will contains the details of the updated user.
Below is the example of the update user:
| URL | catissuecoreopenspecimen/rest/ng/users/{userId} |
| Method | PUT |
| Request | application/json |
| json | { "lastName":"Piterson", "firstName":"Sam", "domainName":"catissue", "emailAddress":"sam.piterson@live.com", "loginName":"samPiterson", "userSiteNames":["My group"], "userCPRoles":[{"roleName":"Scientiest1","cpTitle":"My Cp1"}], "activityStatus":"Active", "deptName":"Department of onchology", "comments":"bla bla bla", "city":"Jalgaon", "state":"Maharashtra", "country":"India", "zipCode":"425022", "faxNumber":"434343AS", "phoneNumber":"654323" } |
Response | { "id" : 1, "lastName":"Piterson", "firstName":"Sam", "domainName":"catissue", "emailAddress":"sam.piterson@live.com", "loginName":"samPiterson", "userSiteNames":["My group"], "userCPRoles":[{"roleName":"Scientiest1","cpTitle":"My Cp1"}], "activityStatus":"Active", "deptName":"Department of onchology", "comments":"bla bla bla", "city":"Jalgaon", "state":"Maharashtra", "country":"India", "zipCode":"425022", "faxNumber":"434343AS", "phoneNumber":"654323" } |
...
code | Applies to | Status Message |
|---|---|---|
| 200 | All resources | User has been updated successfully |
| 400 | All requests | Invalid parameters, e.g duplicate Login Namelogin name, duplicate Email Addressemail address, blank First Name first name etc |
| 401 | All requests | Authorization failed, User user doesn’t have Authorityauthority |
| 404 | All requests | User not found, User user with given details not present in the system |
| 500 | All requests | Internal server error, Encountered encountered server error while performing operations |
...