(GET) Idler Failures Life Calculation API

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
        }
    ],
    "lastPage"0
}



prev next
Was this article helpful?
0 out of 0 found this helpful

Articles in this section

prev next

Related sections