ProRoster - Get planned co-workers
API Url
This api is used to load employees that have overlapping demands/tasks with you.
http://localhost:16010/ProMarkREST/rest/ProRoster/employees/{id}/co-workers
Permissions: user
Path parameters
| Field | Type | Description |
|---|---|---|
| id | Number | The employee's unique identifier. |
Query parameters
| Field | Type | Description |
|---|---|---|
dateoptional | String | the date on which you want to see the co-workers |
Parameter
| Field | Type | Description |
|---|---|---|
ignoreDayProfileoptional | Object[] | |
| isLocked | Boolean | Is the attribute locked. |
| value | Boolean |
Success 200
| Field | Type | Description |
|---|---|---|
| response | Object | Main object containing the response data. |
| data | Object | Object containing the requested data. |
| employees | Object[] | |
assignedDemandsoptional | Object[] | Collection of demands (only when expand=demands). |
acceptBeforeoptional | Object[] | |
daysoptional | Number | Accept days before shift takes place. |
| isLocked | Boolean | Is the attribute locked. |
| isRequired | Boolean | Is the attribute required. |
approvalGroupoptional | Object[] | |
descriptionoptional | String | Description of the approvalGroup. |
idoptional | String | Id of the approvalGroup. |
| isLocked | Boolean | Is the attribute locked. |
| isRequired | Boolean | Is the attribute required. |
assignmentMethodoptional | Object[] | |
| isLocked | Boolean | Is the attribute locked. |
| isRequired | Boolean | Is the attribute required. |
methodoptional | String | Assignment methode Automatic = "A" or Manual "M". |
| backColor | String | BackGround color in HEX without #. |
| baseDemandId | Number | The Id of the base demand from which the demand was created. |
categoryoptional | Object[] | |
descriptionoptional | String | Description of the category. |
idoptional | String | Id of the category. |
| isLocked | Boolean | Is the attribute locked. |
| isRequired | Boolean | Is the attribute required. |
| date | Date | The date of the demand . |
dayProfileoptional | Object[] | The day profile object. |
backColoroptional | String | BackGround color. |
| description | String | Description of the day profile. |
endTimeoptional | Number | Normal time end of day profile. |
foreColoroptional | String | ForeGround color. |
idoptional | String | Day profile ID. |
| isLocked | Boolean | Is the attribute locked. |
| isRequired | Boolean | Is the attribute required. |
| isVariable | Boolean | True if day profile is variable. |
startTimeoptional | Number | Normal time start of day profile. |
departmentoptional | Object[] | |
descriptionoptional | String | Description of the department. |
idoptional | String | Id of the department. |
| isLocked | Boolean | Is the attribute locked. |
| isRequired | Boolean | Is the attribute required. |
| description | String | Description of the demand. |
| empId | String | The Id of the employee assigned to a demand. |
| foreColor | String | ForeGround color in HEX without #. |
groupoptional | Object[] | |
descriptionoptional | String | Description of the group. |
idoptional | String | Id of the group. |
| isLocked | Boolean | Is the attribute locked. |
| isRequired | Boolean | Is the attribute required. |
| id | Number | The Id of the demand. |
| isPublished | Boolean | False = the assigned demand is not published. True = the assigned demand is published. |
| isTask | Boolean | True if demand is task, false if not. |
maximumBidsoptional | Object[] | |
amountoptional | Number | Number of employees to bid in. |
| isLocked | Boolean | Is the attribute locked. |
| isRequired | Boolean | Is the attribute required. |
| name | String | The name of the demand . |
normalTimeoptional | Object[] | Normal time interval for variable day profiles. |
endTimeoptional | Number | End time of the interval in seconds. |
| isLocked | Boolean | Is the attribute locked. |
| isRequired | Boolean | Is the attribute required. |
startTimeoptional | Number | Start time of the interval in seconds. |
| planId | Number | The Id of the plan. |
qualificationSetupoptional | Object[] | |
| isLocked | Boolean | Is the attribute locked. |
| isRequired | Boolean | Is the attribute required. |
qualificationoptional | Object[] | |
descriptionoptional | String | Description of the qualification. |
empQualIdoptional | String | Id of the employee qualification. |
idoptional | Number | Id of the demand qualification. |
orderoptional | Number | Order of qualifications. |
primaryoptional | Boolean | true = This is a primary qualification. |
| requiredEmployees | Object[] | |
| amount | Number | Number of employees |
| isLocked | Boolean | Is the attribute locked. |
| isRequired | Boolean | Is the attribute required. |
| version | Number | Version number of the demand. |
empIdoptional | String | The Id of the employee. |
empNameoptional | String | First name + Last name. |
empNooptional | String | The number of the employee. |
initialsoptional | String | Employee's initials. |
messageoptional | Object | Object containing response messages. |
| code | Number | Message code. |
| text | String | Message text. |
| type | String | Type of message. "warning""info" |
Success example:
HTTP/1.1 200 OK{"response": {"data": {"employees": [{"empId: "833","empNo: "CMD1","fullName: "Ciprian Dinu 1","initials: "CMD1","assignedDemands": [{"id": 2153908066,"planId": 2153557517,"name": "Weld","empId": "893","description": "Welder","foreColor": "000040","backColor": "000050","version": 1,"dayProfile": [{"id": "DAY","startTime": 46800,"endTime": 61200,"description": "Day Shift 13:00 - 17:00","isVariable": false,"foreColor": "000080","backColor": "00FF40","isRequired": false,"isLocked": true}],"requiredEmployees": [{"amount": 5,"isRequired": true,"isLocked": true}],"department": [{"id": "0000007215","description": "SAP-HR-department 15","isRequired": false,"isLocked": true}],"assignmentMethod": [{"isRequired": false,"isLocked": false}],"group": [{"id": "1","description": "BH1","isRequired": false,"isLocked": true}],"approvalGroup": [{"id": "01","description": "Kem Default","isRequired": true,"isLocked": true}],"maximumBids": [{"amount": 10,"isRequired": true,"isLocked": true}],"category": [{"id": "02","description": "Part-day absence","isRequired": false,"isLocked": true}],"acceptBefore": [{"days": 2,"isRequired": false,"isLocked": true}],"qualificationSetup": [{"isRequired": true,"isLocked": true,"qualifications": [{"id": "1","description": "Welding certificate f","primary": true,"order": 1},{"id": "2","description": "Truck certificate","primary": true,"order": 2}]}]}]] ,"errorCode": 0,"errorMessage": ""}}
Error 4xx
| Field | Type | Description |
|---|---|---|
| response | Object | Main object containing the response data. |
| data | Object | Object containing the requested data (empty). |
| errorCode | Number | Error code. |
| errorMessage | String | Error description. |