It is for use with action "REASSIGN_PERSON" to reassign a job to a colleague. The action must appear in jobs/{id}/summary
The method returns qualified users of the user's company. Once a cid/uid tuple selected, the assignment is done with method jobs/{id}/action/commit
Access rights constraints:
-
The current user must have the "REASSIGN_PERSON" action enabled.
-
The current user must have the access rights to enumerate colleagues and to view user names.
URL
(GET) /jobs/{id}/action/reassign-person
PARAMETERS
URL parameters are:
|
id |
The job ID. Also see jobs/{id}/summary |
string, Mandatory |
RESULTS
The resulting JSON object has these properties:
|
count |
Total persons returned. |
int |
|
items |
List of persons of the current user's company to which the job can be assigned, see below for properties. |
object[] |
Each item has these properties:
|
uid |
The person id. |
int |
|
cid |
The company id. |
int |
|
active |
Indicates if the person is active. Please note that the method always returns active people only. |
bool |
|
fname |
First name |
string |
|
lname |
Last name |
string |
|
title |
Optional title of person. Nullable. |
string? |
|
code |
Optional code of person. Platform defined purpose. If not assigned then empty string. |
string |
|
|
Email address. |
string |
|
role |
Optional role of person within the company. Nullable |
string? |
|
phone |
Optional phone. Nullable |
string? |
|
phoneMobile |
Optional mobile phone. Nullable |
string? |
EXAMPLES
A single user is available:
{
"count": 1,
"items": [
{
"uid": 17,
"cid": 10,
"active": true,
"fname": "Philip",
"lname": "Bruce",
"title": null,
"code": "PB",
"role": null,
"phone": null,
"phoneMobile": null,
"email": "jclement@alpha.com"
}
]
}
The user cannot reassign the job or no people available:
{
"count": 0,
"items": []
}