Method
|
POST
|
URL
|
/v2/view/records/<view_UUID>
|
Parameters
|
limit, offset, exclude_total_count, sort, data_format
|
Response Content Type
|
application/json
|
Parameter
|
Description
|
Data Type
|
Example
|
---|---|---|---|
limit
|
The number of records to retrieve. SMQL LIMIT clause syntax is supported. If specified, the response includes the X-Total-Count header with the total count of records that can be retrieved without the limit. Consider using exclude_total_count if calculation of this value is not performant.
If not specified, all undeleted records associated with a view are retrieved.
|
Integer
|
Retrieve only 100 records for the specified view:
/v2/view/records/<view_UUID>?limit=100
|
offset
|
Offset to use to retrieve records. ServiceMax recommends combining this parameter with the sort parameter. SQML OFFSET clause syntax is supported
If not specified, records are retrieved with no offset.
|
Integer
|
Retrieve the next 100 records after the first 500 for the specified view:
/v2/view/records/<view_UUID>?limit=100&offset=500
|
exclude_total_count
|
Set this flag to exclude the X-Total-Count header, which is provided by default when you use limit to specify the number of records returned.
If limit is not set and the total number of selected records is large, performance may be impacted depending on permissions configuration. In these cases, use this parameter to reduce the number of calculation iterations of the total count.
|
Boolean
|
Retrieve the next 100 records after the first 500, ordered by name, without calculating the total count.
/v2/view/records/<view_UUID>?sort=io_name&limit=100&offset=500&exclude_total_count=true
|
sort
|
Sorting criteria for retrieved records.
If not specified, records are retrieved based on their order in the database.
For more information, see View Record Sorting.
|
String
|
Retrieve all records sorted by Created On in descending order:
/v2/view/records/<view_UUID>?sort=io_created_on.desc
|
data_format
|
The output data format. Supported values are basic (default) and extended.
The basic format corresponds to the example response shown above. The extended format includes additional information for specific data types. For more information, see Extended Output Data Format.
|
String
|
Retrieve records in extended output data format:
/v2/view/records/<view_UUID>?data_format=extended
|
suppress_ror
|
Whether to bypass recalculation for recalculate-on-read fields.
When specified, RoR fields are read instead of recalculated, and their values are returned from the database.
|
Boolean
|
Retrieve View records with recalculate-on-read suppressed:
/v2/view/records/<object_full_identifier>?suppress_ror=true
|