Retrieve Records from a Repository
The various details of how to retrieve records from a repository are explained in this section. Only the root level records are retrieved. Classification, GroupName, and EffectiveDate are not supported.
HTTP Method | ||||
Endpoint URL | See Endpoint | |||
Resource | /records/{repositoryName} | |||
Request Parameters | Specify the following parameters: | |||
Name | Description | Type | Data Type | |
Required | ||||
repositoryName | Name of the repository. | path | string | |
Optional | ||||
startIndex | Starting index of the start record. This is used for pagination. The default value is 1. | query | integer (int32) | |
recordCount | Number of records to be retrieved. This is used for pagination. | query | integer (int32) | |
includeSystemAttributes | Set to true if you want to include system attributes. The default value is false. | query | boolean | |
sortBy | Column name on which you want to sort the data. The sortBy works with the ascending field. | query | string | |
ascending | Set to true if you want to sort by the ascending order. The ascending field works with the sortBy field. | query | boolean | |
recordState | The state of a record that is being searched. You can specify the following values: | query | string | |
Media Type | application/json | |||
Active | Specifies whether or not the deleted records are retrieved. Use Active with recordState = ALL. The valid values are Y, N, and ANY. The default value is Y. | query | string | |
workItemId | Unique ID of the work item. | query | string | |
Response Model |
{ "records": [ { "productId": "string", "productIdExt": "string", "productKeyId": "string", "version": "string", "state": "string", "effectiveDate": "string", "attributes": [ { "name": "string", "value": "string", "displayName": "string", "multivalues": [ {} ], "multivalue": false, "id": 0, "groupName": "string" } ], "repositoryName": "string", "relationships": { "relationshipAttributes": [ { "name": "string", "value": "string", "displayName": "string", "multivalues": [ {} ], "multivalue": false, "id": 0, "groupName": "string" } ], "targetRecord": {} }, "deleted": false } ], "totalCount": 0 } |
|||
Request Example |
Endpoint:http://localhost:8080 Resource:/eml/rest/records/Company |
|||
Response Example |
{ "records": [ { "productId": "REC1", "productIdExt": "REC1", "productKeyId": "12799", "version": "1", "state": "CONFIRMED", "isDeleted": false, "attributes": [ { "name": "PRODUCTID", "value": "REC1", "displayName": "Record ID", "multivalues": null, "groupName": "Unassigned", "multivalue": false }, { "name": "PRODUCTIDEXT", "value": "REC1", "displayName": "Record ID Extension", "multivalues": null, "groupName": "Unassigned", "multivalue": false }, { "name": "CONTAINS", "value": "", "displayName": "Related Records", "multivalues": null, "groupName": "Unassigned", "multivalue": false }, { "name": "Name", "value": "TIBCO", "displayName": "Name", "multivalues": null, "groupName": "Unassigned", "multivalue": false }, { "name": "Address", "value": "IL USA", "displayName": "Address", "multivalues": null, "groupName": "Unassigned", "multivalue": false }, { "name": "Street", "value": null, "displayName": "Street", "multivalues": [ "11th St", "Rockford" ], "groupName": "Unassigned", "multivalue": true }, { "name": "Website", "value": "https://www.google.co.in/", "displayName": "Website", "multivalues": null, "groupName": "Unassigned", "multivalue": false }, { "name": "Rating", "value": "10.10", "displayName": "Rating", "multivalues": null, "groupName": "Unassigned", "multivalue": false }, { "name": "CompanySource", "value": "IT SOURCE", "displayName": "CompanySource", "multivalues": null, "groupName": "CompanyType", "multivalue": false }, { "name": "CompanyRating", "value": "9", "displayName": "CompanyRating", "multivalues": null, "groupName": "CompanyType", "multivalue": false } ], "repositoryName": "COMPANY", "relationships": {}, "deleted": false }, { "productId": "record1-1", "productIdExt": "record1-1", "productKeyId": "12798", "version": "1", "state": "CONFIRMED", "isDeleted": false, "attributes": [ { "name": "PRODUCTID", "value": "record1-1", "displayName": "Record ID", "multivalues": null, "groupName": "Unassigned", "multivalue": false }, { "name": "PRODUCTIDEXT", "value": "record1-1", "displayName": "Record ID Extension", "multivalues": null, "groupName": "Unassigned", "multivalue": false }, { "name": "CONTAINS", "value": "", "displayName": "Related Records", "multivalues": null, "groupName": "Unassigned", "multivalue": false }, { "name": "Name", "value": "TIBCO", "displayName": "Name", "multivalues": null, "groupName": "Unassigned", "multivalue": false }, { "name": "Address", "value": "IL USA", "displayName": "Address", "multivalues": null, "groupName": "Unassigned", "multivalue": false }, { "name": "Street", "value": null, "displayName": "Street", "multivalues": [ "11th St", "Rockford" ], "groupName": "Unassigned", "multivalue": true }, { "name": "Website", "value": "https://www.google.co.in/", "displayName": "Website", "multivalues": null, "groupName": "Unassigned", "multivalue": false }, { "name": "Rating", "value": "10.10", "displayName": "Rating", "multivalues": null, "groupName": "Unassigned", "multivalue": false }, { "name": "CompanySource", "value": "IT SOURCE", "displayName": "CompanySource", "multivalues": null, "groupName": "CompanyType", "multivalue": false }, { "name": "CompanyRating", "value": "9", "displayName": "CompanyRating", "multivalues": null, "groupName": "CompanyType", "multivalue": false } ], "repositoryName": "COMPANY", "relationships": {}, "deleted": false } ], "totalCount": 2 } |
|||
Success Response | Example:
Code: 200 successful operation |
|||
Error Response | If the response is unsuccessful, either of the following error code is displayed:
Example: Code: 400 Parameters required are missing OR Code: 404 Repository not found OR Code: 500 Invalid Request For error code response, see Error Handling . |
Copyright © Cloud Software Group, Inc. All rights reserved.