| Table of Contents |
|---|
| Note |
|---|
If the API changes in an incompatible manner this is listed explicitly in the "important release notes" section of each releases changelog. |
...
Name | Type | Info |
id | int | GET only |
taskGuid | string | GET only |
entityVersion | integer | GET only, set by server |
| modified | date | GET only, contains the last modification timestamp of the task entity |
taskNr | string | |
| foreignId | string | optional, is a 120 character long freetext field, not shown in the GUI. Can be used in installations where translate5 is used embedded only, to track the taskId of the management system for example. |
taskName | string | |
| description | string | optional, max 500 character long textual description of the project / task |
| foreignName | string | optional, is a 255 character long, see foreignId. |
sourceLang | string/integer | POST accepts: integers (internal ID), rfc5646 string values, LCIDs (must be prefixed with "lcid-" for example lcid-1031 ), GET returns always the internally used language Id |
targetLang | string/integer/array | POST accepts: integers (internal ID), rfc5646 string values, LCIDs (must be prefixed with "lcid-" for example lcid-1031 ), GET returns always the internally used language Id. If array of target languages is provided, for each target language, separate task (project task) will be created |
relaisLang | string/integer | POST accepts: integers (internal ID), rfc5646 string values, LCIDs (must be prefixed with "lcid-" for example lcid-1031 ), GET returns always the internally used language Id |
locked | date | GET only |
lockingUser | string | GET only |
lockingUsername | string | GET only |
| lockedInternalSessionUniqId | string | GET only |
state | string | POST: can be omitted, is set automatically to "import" GET: returns the current state of the task |
workflow | string | The name of the workflow used in the task |
| workflowStep | integer | The workflow step nr |
| workflowStepName | string | The name of the current workflow step |
pmGuid | string | |
pmName | string | |
wordCount | integer | |
| date | The date field is deprecated. Use LEK_taskUserAssoc deadlineDate instead. |
referenceFiles | boolean | GET only |
terminologie | boolean | GET only |
| orderdate | datetime | |
| enddate | datetime | GET only, contains the datetime when task is set to status end (calculated) |
edit100PercentMatch | boolean | POST only |
| lockLocked | boolean | POST only |
| emptyTargets | boolean | GET only, flag if task has contained only empty targets on import time and is therefore a translation job, or otherwise contained some translations and is a review job |
| importAppVersion | string | GET only, contains the translate5 version used at import time |
| customerId | integer | The client for the task (= id from table LEK_customer) |
enableSourceEditing | boolean | POST only |
| autoStartImport | boolean | POST only, optional, defaults to true. set it to false to prevent an automatic start of the import - for additional configuration, preprocessing before the real import. |
qmSubEnabled | boolean | GET only |
qmSubFlags | auto | GET only |
qmSubSeverities | auto | GET only |
userState | string | As defined by the workflow. |
userRole | string | GET only |
userStep | string | GET only |
| segmentFields | auto | GET only, list with associated segment fields |
| userPrefs | auto | GET only, list with associated default user preferences |
users | auto | GET only, list with associated users |
| taskassocs | auto | With Language Resources: GET only, list with associated Language Resources |
userCount | integer | GET only |
| fileCount | integer | GET only |
| exportRunning | string | GET only |
defaultSegmentLayout | boolean | GET only |
importUpload | HTTP Upload | POST only |
| usageMode | string | Currently 'competitive' or 'cooperative' or 'simultaneous'. competitive: only the first user accepting the task may work on it. Note: if no value is provided on task creation, the value will be evaluated from this config runtimeOptions.import.initialTaskUsageMode This config is overridable on client level |
| segmentFinishCount | integer | GET only, calculated(reviewed/translated depends on the workflow step) number of segments in the current workflow |
| segmentCount | integer | GET only, total number of segments in the current task |
| workflowProgressSummary | string | GET only; Workflow step progress for each workflow step. Response layout: [
{workflowStep: translation, status: finished, progress: 100},
{workflowStep: proofreading, status: running, progress: 33},
{workflowStep: translatorCheck, status: open, progress: 0}
] |
visualReview | file | POST only, Plugin Visual Review only. Adds a (single) file as the source for the visual review. If the import zip already contains a "visualReview" folder with review sources this file will be added to the ones provided in the zip. Filetype can be "pdf" or "html" |
| visualReviewHtml | array | POST only, Plugin Visual Review only. An URL to a website that will be taken as a source(more info about the source linking here: Visual: Upload rules for layout sources) for the visual review.The URL will be downloaded with all linked ressources. Overwrites any sources provided via "visualReview" or in the import package. The provided URL has to be fully qualified like "https://www.translate5.net/en/translate5-open-source-translation-system/" and has to be accessible without login etc. |
mappingType | string | POST only, Plugin Visual Review only. Defines, if the visual review is mapped to the source or target of the segments. Defaults to "source". ( source | target ) |
| taskType | string | GET only. Possible values:
See below section task types for details. |
| projectId | integer | GET only, project id of the task. For taskType default,project and instanttranslate-pre-translate this will have the same value as the id. For tasks with taskType projectTask, this will have the value of the root task(task with taskType project) of the project task collection |
| importProgress | integer | GET only (the task must be in state import or matchanalysis), Current import(or running matchanalysis worker) total progress. |
...