jobs/{id}/summary
Gets basic summary information for the job as well as the list of actions permitted for the current user
This method is useful to implement tools to quickly view the status of a job and propose all available actions to the user:
Accept job or proposal
Decline job
Re-assign job
Manager only actions where applicable
Etc.
URL
(GET) /jobs/{id}/summary
PARAMETERS
URL parameters are:
id | The job ID. Formats used are:
| Mandatory |
RESULTS
The result is a JSON object:
id | The globally unique string ID of the job, such as "c2002" or "s773" | string |
jobid | The numeric job id (unique for Standard and Codyt respectively) | int |
iscodyt | True: A Codyt job. False: A standard job. | bool |
reference | The reference of the job. With Codyt jobs this is the job's document name. | string |
src / srct | Source language code and name | string |
trg / trgt | Target language code and name | string |
branch / brancht | Branch language code and name. In general the branch locale is identical to the target locale. It may be different where a workflow involves a back translation or translation into pivot languages. | string |
task / taskt | Type of task with code and title. |
|
pname | The reference of the project. | string |
pid | The project id. | int |
status | The job status as a number. See Job Status | int |
statust | The job status name. | string |
hasPredecessor | True if this job has a predecessor in the workflow | bool |
|
|
|
assignment | A node containing details on the current job assignment, see further down. Example:
CODE
|
|
|
|
|
deadline | Deadline | datetime? |
dtstart | Date when the job started (typically when moved to in progress status). | datetime? |
dtend | Date when the job was finished (when moved to completed or above status). | datetime? |
dtcassign | Date when the company was assigned. | datetime? |
dtpassign | Date when the person was assigned. | datetime? |
|
|
|
actions | An array of available actions, see below. If no action is available to the user, the array is empty. Example:
CODE
| object[] |
readOnly | For information. If false then the job is totally locked for any change. This is for example the case if the parent project has been closed. | bool |
uicontrols | An object that includes additional parameters per actions' "uicontrol" value. These are properties required to render the action specific UI. | object |
Assignment object
The object has these properties:
mode | 0 = fixed assignment mode, 1 = open job proposal, 2 = crowd sourcing mode | int |
modet | The name of the mode. Example: "Fixed assignment" | string |
cid | Null or the ID of the assigned company. Note that if mode = 1, a job is still a proposal and never assigned yet. If mode = 2, the job is not assigned neither since multiple people can work at the same time. | int? |
cname | Null or the name of the assigned company. | string? |
uid | Null or the ID of the assigned person. If this value is set then "cid" is set as well. Note that a job can be assigned to just a company without specifying a specific user. The exception is, of course, if a job is assigned to an in-house worker. | int? |
uname | Null or the name of the assigned person. To get full person details, use: persons/{uid} | string? |
wasAccepted | When a job is assigned by a manager, this property is false. It is set to true as soon as the assigned company or person takes action such as: Accept job, Accept job proposal, Change status to In Progress, etc. This flag is a useful indication for the manager as well as the assigned worker. | bool |
Action object
Each element in actions has these properties:
id | The ID of the action. When you want to apply an action you will need to supply this ID. | string |
title | The name or title of the action. | string |
desc | Null or a description of the action. | string? |
isinfo | True if this item is only there to show some information. No button. This is for example used when there is no action available to the user and we want to inform the user why there is no action at this point in time. | bool |
isprimary | True if this action should be shown prominently. Typically all primary actions should be immediately accessible through buttons and without opening a combo etc. False if this action is less important and can be hidden in an "Actions" drop down. | bool |
affectsRights | Indicates if applying the action will change the accessibility of the job. For example, changing the status of a job requires reloading editing access rights with parameter "loadRightsFromCache" = true in the editor initialisation method: resources/segments/view/properties One of the actions giving "false" for this property is the one to submit a message with the job. |
|
style | A color style for actions. For example, cancellation may be colored "red", job acceptance be colored "green" and so on. Possible values are:
| string |
uicontrol | This defines what you need to show to the user together with the title and description of the action:
NOTE: If isinfo is true then uicontrol will be | string |
mustNotify | If true, a notification will be sent always. The user has no possibility to untick the notify checkbox. Any unticking will be overridden server side. | bool |
Uicontrols object
The object has one property per UI control in the list of actions. If there is no action at all, the object is empty (but not null).
None | Always null | object |
Terms | Contains properties:
To fetch terms & conditions use this API: jobs/{id}/terms/preview (without setting the cid/pid parameters) | object |
KeepJobOpen | Always null. Render a checkbox, unticked by default, and ask the user if the job shall be kept open when sending back work to the preceding job in the workflow. | object |
AssignWithinCompany | Always null. Use API to get list of colleagues of the current user. | object |
WorkCompleted | Contains properties:
To evaluate if the job has problems, use this API method: If the pass result is false, the job cannot be completed - Unless canSkip above is true. Users with advanced access rights can override blocking situations:
|
|
EXAMPLES
The following example is for a manager user accessing a job which is proposed to him/her. As a manager, the user has management level actions as well.
{
"id": "c231",
"jobid": 231,
"iscodyt": true,
"status": 1,
"statust": "Not assigned",
"hasPredecessor": false,
"assignment": {
"mode": 0,
"modet": "Fixed assignment",
"cid": null,
"cname": null,
"uid": null,
"uname": null,
"wasAccepted": false
},
"readOnly": false,
"actions": [
{
"id": "OPENING_ACCEPT_INACTIVE",
"title": "Yes, I want to reserve this upcoming job!",
"desc": "This job is still inactive but you can already reserve it now. This will put your name on the job.",
"isinfo": false,
"isprimary": true,
"affectsRights": true,
"style": "Green",
"uicontrol": "Terms"
},
{
"id": "OPENING_DECLINE",
"title": "Unfortunately, I have to decline this proposal.",
"desc": "This will remove the job opening from your job list.",
"isinfo": false,
"isprimary": true,
"affectsRights": true,
"style": "Gray",
"uicontrol": "None"
},
{
"id": "ADMIN_STATUS_NOTASSIGNED",
"title": "Change status to 'Not assigned'",
"desc": null,
"isinfo": false,
"isprimary": false,
"affectsRights": true,
"style": "Default",
"uicontrol": "None"
},
{
"id": "ADMIN_STATUS_NOTSTARTED",
"title": "Change status to 'Not started'",
"desc": null,
"isinfo": false,
"isprimary": false,
"affectsRights": true,
"style": "Default",
"uicontrol": "None"
}
],
"uicontrols": {
"Terms": { "termsShow": true },
"None": null
},
}
WORKER ACTIONS
The actions (other than Administrator-level) are:
Code | On-screen title | On-screen message |
---|---|---|
NONE | Your user profile does not allow changing job status | Please notify your manager of completion or for problems by email. You can close this popup. |
FIXED_ACCEPT_INACTIVE | Accept a Job that's not ready to be started – Still inactive | The job has not been made active by the project manager. The job will be marked as Accepted. |
FIXED_ACCEPT_INPROGRESS | Start work now! | The job will be marked as In Progress. |
FIXED_ACCEPT_PROPOSAL | Accept proposal | You have received this job proposal. Click to accept the job. |
FIXED_DECLINE_PROPOSAL | Decline proposal | You cannot take on this job. Click to decline the job proposal. |
OPENING_ACCEPT_INACTIVE | Yes, I want to reserve this upcoming job! | This job is still inactive but you can already reserve it now. This will put your name on the job. |
OPENING_ACCEPT_ACTIVE | Yes, I can take on this job! | This will put your name on the job and you will have exclusive access. |
OPENING_DECLINE | Unfortunately, I have to decline this proposal. | This will remove the job opening from your job list. |
CROWD_ACCEPT_INPROGRESS | Yes, I can contribute to this crowd sourced job! | This will start the job and you and others can contribute freely and simultaneously. Crowd jobs are not assigned exclusively. |
CROWD_DECLINE | Unfortunately, I have to decline this invitation | This will remove the job from your job list. |
COMPLETE | Work done, all OK | I approve the work and mark it as completed. |
REASSIGN_PERSON | Assign to someone in my company | Choose a colleague. |
DROP_PERSON_ME | Leave job to someone else in my company | I cannot take on or continue with this job! Remove my name from the job. |
DROP_COMPANY_MINE | My company cannot take on this job | Refuse job and return it back to the client! |
SEND_BACK | There are problems! Send back to previous work step. | I will wait until the previous worker has done any outstanding corrections. |
MESSAGE | Send a message | (No description provided) |
PROJECT_CLOSED | This job cannot be changed. The parent project is closed. | Contact your manager to enquire on more information. |
NOACTION_INACTIVE | The current task is still inactive. It can be started once active. | Simply close this popup. |
NOACTION_INACCESSIBLE_NOT_MINE | The current task is not yours. | Simply close this popup. |
NOACTION_INACCESSIBLE | The current task cannot be changed for the time being | Simply close this popup. |
NOACTION_JOBOPENINGRESTR | We are very sorry but you cannot take on this job. You are already assigned another job in the same workflow. | Simply close this popup. |
CANNOT_COMPLETE_QA_NOT_RUN | The current task cannot be completed because QA has not been run after the last segment edit or there are segments in red. | Simply close this popup. |