jobs/{id}/terms/checklist

Retrieves the job checklist and evaluates the status of the job.

A checklist item is linked to a rule. The rule tests some properties of the job to tell if it can be completed or not. This method is thus primarily called to see if a user can complete a job.

With jobs the checks done are:

  • Any missing translations?
  • Any translations in red/error status?
  • Was a QA check done (after the job was started)?
  • Are there QA errors left?

URL

(GET) /jobs/{id}/terms/checklist

PARAMETERS

URL parameters are:

id

The job ID. Also see jobs/{id}/summary

string, Mandatory


RESULTS

The resulting JSON object has these properties:

pass

True: The checklist lets user proceed with the "next" step.

For example, a user can only complete a job if the value is true.

bool
isokTrue: The checklist rules are all error/warning free. Note that even if this property is false, the value for pass may be true.bool
items

The list of all checklist items. Each item has a title, description and implements a validation rule:

  • A rule to look for missing or erroneous translations
  • A rule verifying if a QA was done
  • etc.
object[]


Each checklist item has these properties:


Rule evaluation
pass

User can proceed (if rule evaluates successfully or the rule is not mandatory)

True: The checklist lets user proceed with the "next" step.

False: The problem must be resolved before proceeding.

Example: Checks if the user can complete a job.

bool
ok

Rule evaluates to success.

True: Rule did not yield problems: Result is either Success or Information.

False: Rule resulted with a problem.

bool
result

The evaluation result of the rule, any of:

  • Success
  • Information
  • Warning
  • Error
string
msgOptional message attached to the evaluation result. Usually contains error messages.string?




Rule properties
titleTitle of checklist item or rulestring
descDescription of the rulestring
mandatoryTrue if the rule must evaluate to success in order to let the user proceed.bool
ruleInternal ID of the rulestring


EXAMPLES

A job that still requires some cleanup to do before it can be completed by the user:


{
  "pass": true,
  "ok": false,
  "items": [
    {
      "pass": true,
      "rule": "j_trans",
      "title": "Translations done",
      "desc": "Looks for missing translations or translations flagged as erroneous.",
      "mandatory": false,
      "result": "Error",
      "ok": false,
      "msg": "A total of 1 translations are missing. Flag these with green status if blank on purpose."
    },
    {
      "pass": true,
      "rule": "j_qa",
      "title": "Quality assurance check",
      "desc": "Validates that a QA check was done prior to submitting a job.",
      "mandatory": false,
      "result": "Error",
      "ok": false,
      "msg": "Please run a QA."
    }
  ]
}


This job asks the user to run a QA, however the QA is not mandatory (pass is true):


{
  "pass": true,
  "ok": false,
  "items": [
    {
      "pass": true,
      "rule": "j_trans",
      "title": "Translations done",
      "desc": "Looks for missing translations or translations flagged as erroneous.",
      "mandatory": false,
      "result": "Success",
      "ok": true,
      "msg": null
    },
    {
      "pass": true,
      "rule": "j_qa",
      "title": "Quality assurance check",
      "desc": "Validates that a QA check was done prior to submitting a job.",
      "mandatory": false,
      "result": "Error",
      "ok": false,
      "msg": "Please run a QA for this job. None has been done yet."
    }
  ]
}




Copyright Wordbee - Buzzin' Outside the Box since 2008