Description
Supplies Idler fault information which includes associated faults in the same position over the lifetime of the equipment. This can be used to see the progression of faults for each idler.
URL
https://apiprod.pdsglobal.com/V2/api/idler/idlerfailureslifecalculation/V3
Note: There are two non-production environments that can be used for testing.
Request
Type
GET
Headers
No header is required for this API Endpoint.
Parameters
Mandatory parameters are denoted by *
*
api_key: string(50)
This is required for authentication. It is used to identify the user and determine access to the system. If you do not have your API key please contact PDS Support (support@pdsglobal.com).
businessName: string(50)
The name of the business as recorded in the hierarchy. Can be obtained from the hierarchy or the Area Details API.
businessFunctionalLocation: string(50)
Unique code used to identify the business. Can be obtained from the business edit dialog in the software, or the Area Details API.
groupName: string(50)
The name of the group as recorded in the hierarchy. Can be obtained from the hierarchy or the Area Details API.
groupFunctionalLocation: string(50)
Unique code used to identify the group. Can be obtained from the group edit dialog in the software, or the Area Details API.
departmentName: string(50)
The name of the department as recorded in the hierarchy. Can be obtained from the hierarchy or the Area Details API.
departmentFunctionalLocation: string(50)
Unique code used to identify the department. Can be obtained from the department edit dialog in the software, or the Area Details API.
areaName: string(50)
The name of the area as recorded in the hierarchy. Can be obtained from the hierarchy or the Area Details API.
areaFunctionalLocation: string(50)
Unique code used to identify the area. Can be obtained from the area edit dialog, or the Area Details API.
page: integer Large datasets are broken down into pages with 2000 records per page. Use the page parameter to specify which page of the paged dataset to retrieve. Note that this number cannot be greater than the lastPage value returned by the first call to the endpoint.
0 is the starting page. For example if there was a total of 3517 records for the last 6 months, then page 0 will show 1 - 2000 records, and page 1 will show the remaining 1517 records.
lastPage: integer
When a paged endpoint is called, it calculates the number of records it will return, then calculates the number of pages required.
This is an intensive operation which affects the performance of the endpoint. After calling the endpoint the first time the lastPage value is returned in the result. By passing that value in to the lastPage parameter on subsequent calls the service will know not to recalculate the number of pages.
Body
No body is required for this API Endpoint.
Response
Body
Object: ResponseEntity<string>
|
changedRecords[]
List of records returned by the call.
|
areaId: integer This is the unique identifier (primary key) for the area. It can be obtained using the Area Details API
|
idlerPosition[]
|
idlerPositionId: integer
This is the unique identifier (primary key) for the Idler Position.
|
idlerPosition: string(50)
The name of the Idler Position for each individual idler, within the Idler Position Set. E.g. if the Set is '4 Roll Trough' then the Idler on the left will be in the position '4 Roll Trough - LHS'.
|
idlerPositionSet: string(50)
Used to group various Idler Positions within the Idler Position Groups. For example all 4 roll troughs on the Carry side will belong to the Set named 'Carry4Roll'.
|
idlerPositionGroup: string(50)
The name of the group the Idler resides in. E.g. 'Carry', or 'Return'.
|
idlerPositionGroupId: integer
This is the unique identifier (primary key) for the Idler Position Group.
|
|
frame: integer
The frame where the Idler is located.
|
currentDateTagged: integer
The date on which the Idler Fault was created.
|
nextDateTagged: integer
The date on which the next (subsequent) Idler Fault was recorded.
|
daysDiff: integer
The number of days between the current and next fault being recorded.
|
currentIdlerFailureType[]
|
idlerFailureTypeId: integer
This is the unique identifier (primary key) for the Idler Failure Type.
|
name: string(50)
The name of the Idler Failure Type.
|
isFramed: boolean
Indicates that surrounding Idlers are to also be replaced.
|
businessId: integer
This is the unique identifier (primary key) for the business where the Failure Type is configured.
|
sortOrder: integer
Determines the sequence of the Idler Failure Type.
|
isActive: boolean
Indicates whether the Idler Failure Type is currently active/enabled.
|
lastSavedBy: string(50)
Identifies the user who last updated the record (email address).
|
lastSavedDateTime: DateTime
Indicates the last time the record was updated.
|
createdBy: string(50)
Identifies the user who created the record (email address).
|
createdDate: DateTime
Indicates the date and time the record was created.
|
priority: string(50)
The name of the priority level selected.
|
priorityId: integer
The name of the priority level selected.
|
idlerFailureTypePriority[]
|
priorityId: integer
This is the unique identifier (primary key) for the Idler Failure Type Priority.
|
name: string(50)
The name of the Idler Failure Type Priority.
|
backColour: string(50)
The back colour which should show for this type.
|
fontColour: string(50)
The front colour which should show for this type.
|
businessId: integer
This is the unique identifier (primary key) for the business where the Failure Type Priority is configured.
|
sortOrder: integer
Determines the sequence of the Idler Failure Type Priority.
|
isActive: boolean
Indicates whether the Idler Failure Type Priority is currently active/enabled.
|
lastSavedBy: string(50)
Identifies the user who last updated the record (email address).
|
lastSavedDateTime: DateTime
Indicates the last time the record was updated.
|
createdBy: string(50)
Identifies the user who created the record (email address).
|
createdDate: DateTime
Indicates the date and time the record was created.
|
|
|
nextIdlerFailureType[]
|
idlerFailureTypeId: integer
This is the unique identifier (primary key) for the Idler Failure Type.
|
name: string(50)
The name of the Idler Failure Type.
|
isFramed: boolean
Indicates that surrounding Idlers are to also be replaced.
|
businessId: integer
This is the unique identifier (primary key) for the business where the Failure Type is configured.
|
sortOrder: integer
Determines the sequence of the Idler Failure Type.
|
isActive: boolean
Indicates whether the Idler Failure Type is currently active/enabled.
|
lastSavedBy: string(50)
Identifies the user who last updated the record (email address).
|
lastSavedDateTime: DateTime
Indicates the last time the record was updated.
|
createdBy: string(50)
Identifies the user who created the record (email address).
|
createdDate: DateTime
Indicates the date and time the record was created.
|
priority: string(50)
The name of the priority level selected.
|
priorityId: integer
The name of the priority level selected.
|
idlerFailureTypePriority[]
|
priorityId: integer
This is the unique identifier (primary key) for the Idler Failure Type Priority.
|
name: string(50)
The name of the Idler Failure Type Priority.
|
backColour: string(50)
The back colour which should show for this type.
|
fontColour: string(50)
The front colour which should show for this type.
|
businessId: integer
This is the unique identifier (primary key) for the business where the Failure Type Priority is configured.
|
sortOrder: integer
Determines the sequence of the Idler Failure Type Priority.
|
isActive: boolean
Indicates whether the Idler Failure Type Priority is currently active/enabled.
|
lastSavedBy: string(50)
Identifies the user who last updated the record (email address).
|
lastSavedDateTime: DateTime
Indicates the last time the record was updated.
|
createdBy: string(50)
Identifies the user who created the record (email address).
|
createdDate: DateTime
Indicates the date and time the record was created.
|
|
|
currentIdlerType[]
|
idlerTypeId: integer
This is the unique identifier (primary key) for the Idler Type.
|
name: string(50)
The name of the Idler Type.
|
businessId: integer
This is the unique identifier (primary key) for the business where the fault is located.
|
sortOrder: integer
Determines the sequence of the Idler Type.
|
isActive: boolean
Indicates whether the Idler Type is currently active/enabled.
|
lastSavedBy: string(50)
Identifies the user who last updated the record (email address).
|
lastSavedDateTime: DateTime
Indicates the last time the record was updated.
|
createdBy: string(50)
Identifies the user who created the record (email address).
|
createdDate: DateTime
Indicates the date and time the record was created.
|
|
nextIdlerType[]
|
idlerTypeId: integer
This is the unique identifier (primary key) for the Idler Type.
|
name: string(50)
The name of the Idler Type.
|
businessId: integer
This is the unique identifier (primary key) for the business where the fault is located.
|
sortOrder: integer
Determines the sequence of the Idler Type.
|
isActive: boolean
Indicates whether the Idler Type is currently active/enabled.
|
lastSavedBy: string(50)
Identifies the user who last updated the record (email address).
|
lastSavedDateTime: DateTime
Indicates the last time the record was updated.
|
createdBy: string(50)
Identifies the user who created the record (email address).
|
createdDate: DateTime
Indicates the date and time the record was created.
|
|
currentTagId: integer
This is the unique identifier (primary key) for the Idler Fault.
|
nextTagId: integer
This is the unique identifier (primary key) for the next (subsequent) Idler Fault.
|
|
lastPage: integer
Indicates the page number of the last page when a paged endpoint is called.
|
Response Status Code
See HTTP Response Codes and Errors
Examples
URL:
https://apiprod.pdsglobal.com/V2/api/idler/idlerfailureslifecalculation/V3?api_key=ABC123
Response Body:
{
"changedRecords": [
{
"areaId": 1,
"idlerPosition": [
{
"idlerPositionId": 12,
"idlerPosition": "3 Roll Trough - RHS",
"idlerPositionSet": "Carry3Roll",
"idlerPositionGroup": "Carry",
"idlerPositionGroupId": 4
}
],
"frame": 7,
"currentDateTagged": "2016-11-01T10:00:00.000Z",
"nextDateTagged": "2017-02-07T11:00:00.000Z",
"daysDiff": 98,
"currentIdlerFailureType": [
{
"idlerFailureTypeId": 3,
"name": "Bearing Seized",
"priorityId": 1,
"idlerFailureTypePriority": [],
"priority": "IMMEDIATE - Action within 1 day",
"isFramed": false,
"businessId": 1,
"sortOrder": 3,
"isActive": true,
"lastSavedBy": "Test3@pdsglobal.com",
"lastSavedDateTime": "2020-01-27T23:49:50.947Z",
"createdBy": "peterm@pdsonline.com.au",
"createdDateTime": "2017-01-22T07:55:44.000Z"
}
],
"nextIdlerFailureType": [
{
"idlerFailureTypeId": 3,
"name": "Bearing Seized",
"priorityId": 1,
"idlerFailureTypePriority": [],
"priority": "IMMEDIATE - Action within 1 day",
"isFramed": false,
"businessId": 1,
"sortOrder": 3,
"isActive": true,
"lastSavedBy": "Test3@pdsglobal.com",
"lastSavedDateTime": "2020-01-27T23:49:50.947Z",
"createdBy": "peterm@pdsonline.com.au",
"createdDateTime": "2017-01-22T07:55:44.000Z"
}
],
"currentIdlerType": [
{
"idlerTypeId": 125,
"name": "Rubber Impact",
"businessId": 1,
"sortOrder": 2,
"isActive": true,
"lastSavedBy": "ricks@pdsonline.com.au",
"lastSavedDateTime": "2017-02-07T03:55:13.920Z",
"createdBy": "ricks@pdsonline.com.au",
"createdDateTime": "2017-02-07T03:55:00.200Z"
}
],
"nextIdlerType": [
{
"idlerTypeId": 125,
"name": "Rubber Impact",
"businessId": 1,
"sortOrder": 2,
"isActive": true,
"lastSavedBy": "ricks@pdsonline.com.au",
"lastSavedDateTime": "2017-02-07T03:55:13.920Z",
"createdBy": "ricks@pdsonline.com.au",
"createdDateTime": "2017-02-07T03:55:00.200Z"
}
],
"currentTagId": 24,
"nextTagId": 7
}