Creating, Deleting, and Retrieving Records
You can use the HCL Compass REST API to Create, Delete, and Retrieve records.
To retrieve a record, use GET
https://localhots:8190/ccmweb/rest/repos/CCMRepo/databases/SAMPL/records/Defect/SAMPL00000001
,
where SAMPL00000001 is the ID of the record that you are retrieving. For more information, see
https://localhost:8190/swagger-ui.html#/Record/getRecord
.
{
"dbId": "33554433",
"fields": [
{
"name": "Attachments",
"value": "",
"valueStatus": "HAS_NO_VALUE",
"validationStatus": "_KNOWN_VALID",
"requiredness": "READONLY",
"requirednessForUser": "READONLY",
"type": "ATTACHMENT_LIST",
"valueAsList": [],
"messageText": "",
"maxLength": 0
},
{
"name": "customer",
"value": "",
"valueStatus": "HAS_NO_VALUE",
"validationStatus": "_KNOWN_VALID",
"requiredness": "READONLY",
"requirednessForUser": "READONLY",
"type": "REFERENCE_LIST",
"valueAsList": [],
"messageText": "",
"maxLength": 0
},
…
To create a new record, use POST
https://localhost:8190/ccmweb/rest/repos/CCMRepo/databases/SAMPL/records/Defect?operation=Commit
.
For more information, see https://localhost:8190/swagger-ui.html#/Record/createRecord
.
{
"fields": [
{
"name": "Headline",
"value": "this is test sample"
},
{
"name": "Severity",
"value": "1-Critical"
}
]
}
Response:
{
"dbId": "33554473",
"fields": [
{
"name": "customer",
"value": "",
"valueStatus": "HAS_NO_VALUE",
"validationStatus": "_KNOWN_VALID",
"requiredness": "READONLY",
"requirednessForUser": "READONLY",
"type": "REFERENCE_LIST",
"valueAsList": [],
"messageText": "",
"maxLength": 0
},
{
"name": "Headline",
"value": "this is test sample",
"valueStatus": "HAS_VALUE",
"validationStatus": "_KNOWN_VALID",
"requiredness": "READONLY",
"requirednessForUser": "READONLY",
"type": "SHORT_STRING",
"valueAsList": [
"this is test sample"
],
"messageText": "",
"maxLength": 125
},
{
"name": "id",
"value": "SAMPL00000041",
"valueStatus": "HAS_VALUE",
"validationStatus": "_KNOWN_VALID",
"requiredness": "READONLY",
"requirednessForUser": "READONLY",
"type": "ID",
"valueAsList": [
"SAMPL00000041"
],
"messageText": "",
"maxLength": 13
}, {
"name": "Description",
"value": "",
"valueStatus": "HAS_NO_VALUE",
"validationStatus": "_KNOWN_VALID",
"requiredness": "READONLY",
"requirednessForUser": "READONLY",
"type": "MULTILINE_STRING",
"valueAsList": [],
"messageText": "",
"maxLength": 0
},
…
To delete a record, use DELETE
https://localhost:8190/ccmweb/rest/repos/CCMRepo/databases/SAMPL/records/Defect/SAMPL00000041?actionName=Delete
.
For more information, see
https://localhost:8190/swagger-ui.html#/Record/deleteRecord
.