• Show convenient version of this site
  • Deutsch
  • English
Contact
Newsletter
  • Products
    • ALS
      • Across Language Server
        • Translation Management
        • Terminology Management
        • Translation Memory
      • Editions
      • Interfaces
    • ATE
      • Across Translator Edition
      • Editions
      • Download
      • Across Account
    • Elanion
      • Overview
      • Login
  • Solutions
    • Customers
      • Enterprises
      • Language Service Providers
      • Translators
    • Industries
      • E-Commerce & Trade
      • Pharmaceuticals & medicine
      • IT & Software
    • Departments
      • Marketing & E-Commerce
      • Technical Documentation
      • Software User Interfaces
  • Services
    • Hosting
    • Training
    • Consulting
  • Partners
    • Language Service Providers
    • Universities
  • Company
    • Across Systems
    • News
    • Events
    • Career
    • Contact
  • Knowledge
    • Blog
    • Video Library
    • Case Studies
    • White Papers
    • Fact Sheets
    • File Formats
    • Expert Features
  • Support
    • New Functions
    • Online Help
    • FAQ
    • Support Request
    • Updates
Schedule Consultation
  • Online-Help
  • SDK
  • APIs
  • crossAPI SI
  • List of Objects in crossAPI SI
  • TaskManager
  • General Information
    • Connectors
    • LCIDs
    • GUIDs
    • Paragraph states and flags
    • crossTerm Web
    • crossTransform
      • crossTransform - examples
  • Connecting Third-party Systems
    • crossConnect for content systems
      • Requirements
      • Configuration
        • Configuring the connector
        • Job configuration
        • Testing crossConnect
      • Troubleshooting
    • crossConnect for External Editing
      • Purpose and usage
        • Use case - Machine translation
        • Use Case - Review and QA
        • Use case - Machine review
      • Requirements
      • Implementation
        • Across XLIFF format
          • Across-specific Extensions
          • <xliff> Element Attributes
          • <file> Element Extensions
          • <trans-unit> Element Extension
          • Paragraph States
          • Paragraph State Flags
          • <source> and <target> Element Content
          • <bpt> Element Attributes
          • <ph> Element Attributes
          • <x> Element Attributes
          • Across-specific Properties
          • Analysis Results
          • Sample Files
          • Across XLIFF - import, export and segmentation
          • Context information
          • Exporting best matches in Across XLIFF
          • Hyperlinks to XLIFF
        • Secure file handling with C#
        • Secure file handling with JAVA
        • Workflow and vendor configuration
          • Adding workflows to crossAutomate Host Manager
          • Adjusting preset watchfolders
          • The filter rules
          • External editing workflows
        • Sample code - Integrated solution
    • Generic File Connector
      • Process Overview
      • Exchange Folder Structure
      • Package Format
        • Control File
  • Display Texts
    • Solution approaches
    • The Across solution in detail
    • Requirements
    • Integration
    • The display text format
      • Line height vs. line spacing
      • DT-XML format structure
        • DT-XML - Main elements
        • Children of paragraphStyles and characterStyles
        • Children of the sizeInfos element
        • Children of the paragraph element
        • DT-XML v5 example
        • DT-XML v4 example
    • The display text package
      • Creating a display text package
  • APIs
    • APIs - Technology
    • crossTank API v1
      • Requirements
      • Testing the crossTank API installation
      • OData-URLs in Chrome
      • Example
    • crossTank API v2
      • Requirements
      • QuickStart
        • Searching for Translations
        • Creating Translations
      • crossTank API v2 Overview
        • Finding Translations
        • Creating Translations
        • Translation Properties
        • Formatting and Auto-Adjustment of Formatting and Numbers
      • C# Example
    • crossTerm API v1
      • Scenarios of use
        • Example - usage information
        • Example - finding terms
      • Requirements
      • Special Controllers
      • OData-URLs in Chrome
      • crossTerm API with C#
      • crossTerm API with Java
      • crossTerm API with JavaScript
    • crossTerm API v2
      • Requirements
      • QuickStart
        • Authentication Basics
        • First Request Examples
      • crossTerm API v2 Example in C#
        • Used Functions
      • crossTank API, crossTerm API v2 - Authentication
      • crossTerm API v2 - Examples of Use
        • Finding Terms of Entry
        • Searching Terminology via API
    • crossAPI SI
      • Requirements
      • Function Return Types
      • crossAPI SI and Java
        • Example: hot integration
        • Executing the hot integration example
      • List of Objects in crossAPI SI
        • AssignManager
        • Authorization
        • CheckInManager
        • CheckOutManager
        • CrossTankManager
        • CrossTermManager
        • DocumentManager
        • FileManager
        • LanguageJobManager
        • LanguageManager
        • LicenseManager
        • Message
        • ObjectManager - Overview
          • Part 1
          • Part 2
          • Part 3
        • ReportManager
          • ID values for analysis and analysis-result
        • ProjectManager - Overview
          • Part 1
          • Part 2
          • Attribute Information
        • SqlQuery
        • SystemManager
        • TaskManager
        • WanGridManager - Overview
          • Part 1
          • Part 2
      • Sample - transferring checkout files via FileManager
      • Sample - VBS
    • Text Preprocessing API
      • Introduction
      • How to browse the API
      • Sentence splitting
      • Abbreviations

TaskManager

  • Unless stated otherwise, all objects are available in the following Across versions:
  • 5.7
  • 6.0
  • 6.3
  • 7.0
Tip

Function-specific return values are listed with each function.

For more information on return values and a complete list of error codes, see Function Return Types.

Function
Description
TaskManager.CancelJob
Cancels the specified job. The function only works for jobs created from TaskManager functions.
TaskManager.ExportTaskToEwu
Exports a task to an EWU (External Processing Work Unit) file.
TaskManager.ExportTaskToXliff
Exports a task to an XLIFF file.
TaskManager.GetJobProgress
Returns the progress of a job. The function only works for jobs created from TaskManager functions.
TaskManager.GetJobResult
Returns the result of a finished job. The function only works for jobs created from TaskManager functions.
TaskManager.GetJobStatus
Returns the status of a job. The function only works for jobs created from TaskManager functions.
TaskManager.GetTaskDeadline
Returns the due date of a specified task.
TaskManager.GetTaskFinishDate
Returns the finish date of a specified task.
TaskManager.GetTaskGuid
Gets the GUID of a task.
TaskManager.GetTaskGuid2
Gets the GUID of a target language editing task and supports access to tasks of partitioned documents.
TaskManager.GetTaskProgress
Returns the progress of a task.
TaskManager.GetTaskState
Returns the state of a task.
TaskManager.GetTaskStatistics
Returns the statistics of a task.
TaskManager.ImportTaskFromEru
Imports an ERU (External Processing Response Unit) file to a task.
TaskManager.ImportXliffToTask
Imports an XLIFF file to a task.
TaskManager.IsTaskAssigned
Returns whether a task is assigned or not.
TaskManager.IsTaskFinished
Returns whether a task is finished or not.
TaskManager.SetTaskConfirmed
Sets a task to confirmed.
TaskManager.SetTaskDeadline
Sets the due date of a specific task.
TaskManager.SetTaskFinished
Sets a task to finished or unfinished.
TaskManager.SetTaskProgress
Sets the task progress.
TaskManager.SetTaskStartDate
Sets the start date of a task to the given date and time. Checks if date and time is allowed as a start date for the task.
TaskManager.SwitchTaskParagraphState
Changes one paragraph state to another for the specified task. The task cannot be read-only, i.e. it needs to be ready for processing like when it is opened in the Across client.

TaskManager.CancelJob

Cancels the specified job. The function only works for jobs created from TaskManager functions.

Parameters

 
Type
Name
Description
1
string
ST
A security token for use in other crossAPI SI functions.
2
string
JobGuid
The GUID of the job.

Return Values

Result
Type/Value
Interpretation
Success
Is always empty.
Error
17
Job does not exist.
Error
87
Job already finished.
Error
88
Canceling is not supported for the job.

TaskManager.ExportTaskToEwu

Exports a task to an EWU (External Processing Work Unit) file.

Parameters

 
Type
Name
Description
1
string
ST
A security token for use in other crossAPI SI functions.
2
string
TaskGuid
GUID of the task.
3
string
OutputFileName
The name of the output file. You have to enter a path.
4
string
ToolGuid
Guid of the external processing tool.
Attention

There must be a corresponding license for the tool.

Return Values

Result
Type/Value
Interpretation
Success
string
The GUID of the job.
Error
18
Unable to create job.
Error
53
Task does not exist.

TaskManager.ExportTaskToXliff

Exports a task to an XLIFF file.

Parameters

 
Type
Name
Description
1
string
ST
A security token for use in other crossAPI SI functions.
2
string
TaskGuid
GUID of the task.
3
string
OutputFileName
The name of the output file. You have to enter a path.

Return Values

Result
Type/Value
Interpretation
Success
string
The GUID of the job.
Error
18
Unable to create job.
Error
53
Task does not exist.
Error
202
You do not have a license for XLIFF import/export.

TaskManager.GetJobProgress

Returns the progress of a job. The function only works for jobs created from TaskManager functions.

Parameters

 
Type
Name
Description
1
string
ST
A security token for use in other crossAPI SI functions.
2
string
JobGuid
The GUID of the job.

Return Values

Result
Type/Value
Interpretation
Success
int
The progress of the job in percent.
Error
17
Job does not exist.
Error
21
Job has been canceled.
Tip

Other return values are possible. They depend on the executed job and mean the job itself failed.

Attention

Do not use this method to find out whether a job is finished or not. A progress of 100 does not necessarily mean that the job is finished already. Use GetJobStatus instead.

TaskManager.GetJobResult

Returns the result of a finished job. The function only works for jobs created from TaskManager functions.

Parameters

 
Type
Name
Description
1
string
ST
A security token for use in other crossAPI SI functions.
2
string
JobGuid
The GUID of the job.

Return Values

Result
Type/Value
Interpretation
Success
int
The progress of the job in percent.
Error
17
Job does not exist.
Error
21
Job has been canceled.
Error
43
The job has not yet been completed.
Tip

Other return values are possible. They depend on the executed job and mean the job itself failed.

TaskManager.GetJobStatus

Returns the status of a job. The function only works for jobs created from TaskManager functions.

Parameters

 
Type
Name
Description
1
string
ST
A security token for use in other crossAPI SI functions.
2
string
JobGuid
The GUID of the job.

Return Values

Result
Type/Value
Interpretation
Success
int
The status of the job.
  • The following values are possible:
  • 0 - in progress
  • 1 - finished successfully
  • 2 - finished with errors
Error
17
Job does not exist.

TaskManager.GetTaskDeadline

Returns the due date of a specified task.

Parameters

 
Type
Name
Description
1
string
ST
A security token for use in other crossAPI SI functions.
2
string
TaskGuid
GUID of the task.

Return Values

Result
Type/Value
Interpretation
Success
DateTime
The due date of the task.
Error
53
Task does not exist.

TaskManager.GetTaskFinishDate

Returns the finish date of a specified task.

Parameters

 
Type
Name
Description
1
string
ST
A security token for use in other crossAPI SI functions.
2
string
TaskGuid
GUID of the task.

Return Values

Result
Type/Value
Interpretation
Success
DateTime
The due date of the task.
Error
53
Task does not exist.

TaskManager.GetTaskGuid

Gets the GUID of a task.

Parameters

 
Type
Name
Description
1
string
ST
A security token for use in other crossAPI SI functions.
2
string
DocumentGuid
The GUID of the document.
3
int
SourceLanguageLcid
The LCID of the source language.
4
int
TargetLanguageLcid
The LCID of the target language.
5
string
TaskTemplateGuid
The GUID of the task template.

Return Values

Result
Type/Value
Interpretation
Success
string
Contains the guid of the task.
Error
15
Language does not exist.
Error
16
Document does not exist.
Error
24
Workflow does not exist.
Error
27
Task template does not exist.
Error
53
Task does not exist.
Error
180
The document is not ready because it is being checked in.

TaskManager.GetTaskGuid2

Gets the GUID of a target language editing task and supports access to tasks of partitioned documents.

Parameters

 
Type
Name
Description
1
string
ST
A security token for use in other crossAPI SI functions.
2
string
DocumentGuid
The GUID of the document.
3
int
SourceLanguageLcid
The LCID of the source language.
4
int
TargetLanguageLcid
The LCID of the target language.
5
string
PartitionIndexes
A list of partition indexes separated by ;.
6
string
TaskTemplateGuid
The GUID of the task template.

Return Values

Result
Type/Value
Interpretation
Success
string
Contains the guid of the task.
Error
15
Language does not exist.
Error
16
Document does not exist.
Error
24
Workflow does not exist.
Error
27
Task template does not exist.
Error
53
Task does not exist.
Error
180
The document is not ready because it is being checked in.

TaskManager.GetTaskProgress

Returns the progress of a task.

Parameters

 
Type
Name
Description
1
string
ST
A security token for use in other crossAPI SI functions.
2
string
TaskGuid
GUID of the task.

Return Values

Result
Type/Value
Interpretation
Success
int
The progress of the task in percent.
Error
53
Task does not exist.

TaskManager.GetTaskState

Returns the state of a task.

Parameters

 
Type
Name
Description
1
string
ST
A security token for use in other crossAPI SI functions.
2
string
TaskGuid
GUID of the task.

Return Values

Result
Type/Value
Interpretation
Success
int
  • The state of the task:
  • 0: Task is unassigned
  • 1: Task is unconfirmed
  • 2: Task has been rejected
  • 3: Task has been confirmed
  • 4: Task is a WAN task. It is unknown whether it has been confirmed or not
  • 5: Task is finished
Error
16
Document does not exist.
Error
53
Task does not exist.

TaskManager.GetTaskStatistics

Returns the statistics of a task.

Parameters

 
Type
Name
Description
1
string
ST
A security token for use in other crossAPI SI functions.
2
string
TaskGuid
GUID of the task.

Return Values

Result
Type/Value
Interpretation
Success
string
The statistics as an XML structure. See below for information on the exact structure.
Error
53
Task does not exist.
Error
148
Cannot load statistics.

The returned XML structure has the following layout:

<?xml version="1.0" encoding="UTF-16"?> 
<TaskStatistics 
     Type="[task template name" 
     Description="[description of the task: project name, document name, percentage]" 
     SourceLanguage="[source language name]" 
     TargetLanguage="[target language name]" 
     Deadline="[deadline date]" 
     Translations="[amount of added translations]" 
     SourceTerms="[amount of added source language terms]" 
     TargetTerms="[amount of added target language terms]" 
     TermEntries="[amount of added term entries]" 
     AmountOfTime="[hours, minutes and seconds spent on this task]"/>

Date and time are formatted according to the current locale.

TaskManager.ImportTaskFromEru

Imports an ERU (External Processing Response Unit) file to a task.

Parameters

 
Type
Name
Description
1
string
ST
A security token for use in other crossAPI SI functions.
2
string
TaskGuid
GUID of the task.
3
string
InputFileName
The path to the input file.
4
string
ToolGuid
Guid of the external processing tool.
Attention

There must be a corresponding license for the tool.

Return Values

Result
Type/Value
Interpretation
Success
string
The GUID of the job.
Error
53
Task does not exist.

TaskManager.ImportXliffToTask

Imports an XLIFF file to a task.

Parameters

 
Type
Name
Description
1
string
ST
A security token for use in other crossAPI SI functions.
2
string
TaskGuid
GUID of the task.
3
string
InputFileName
The path to the input file.

Return Values

Result
Type/Value
Interpretation
Success
string
The GUID of the job.
Error
18
Unable to create job.
Error
53
Task does not exist.
Error
202
You do not have a license for XLIFF import/export.
Tip

Progress queries can be carried out via GetJobProgress. Status queries can be carried out via the GetJobStatus function.

TaskManager.IsTaskAssigned

Returns whether a task is assigned or not.

Parameters

 
Type
Name
Description
1
string
ST
A security token for use in other crossAPI SI functions.
2
string
TaskGuid
GUID of the task.

Return Values

Result
Type/Value
Interpretation
Success
Error
53
Task does not exist.

TaskManager.IsTaskFinished

Returns whether a task is finished or not.

Parameters

 
Type
Name
Description
1
string
ST
A security token for use in other crossAPI SI functions.
2
string
TaskGuid
GUID of the task.

Return Values

Result
Type/Value
Interpretation
Success
int
0 if the task is not finished and 1 if it is finished.
Error
53
Task does not exist.

TaskManager.SetTaskConfirmed

Sets a task to confirmed.

Parameters

 
Type
Name
Description
1
string
ST
A security token for use in other crossAPI SI functions.
2
string
TaskGuid
GUID of the task.
3
bool
Confirmed
Specifies whether the task should be set to confirmed or not.

Return Values

Result
Type/Value
Interpretation
Success
Error
53
Task does not exist.
Error
210
Cannot confirm task.
Error
211
Cannot unconfirm task.

TaskManager.SetTaskDeadline

Sets the due date of a specific task.

Parameters

 
Type
Name
Description
1
string
ST
A security token for use in other crossAPI SI functions.
2
string
TaskGuid
GUID of the task.
3
DateTime
Deadline
The date by which the task should be finished.

Return Values

Result
Type/Value
Interpretation
Success
Is always empty.
Error
138
Cannot set deadline.

TaskManager.SetTaskFinished

Sets a task to finished or unfinished.

Parameters

 
Type
Name
Description
1
string
ST
A security token for use in other crossAPI SI functions.
2
string
TaskGuid
GUID of the task.
3
bool
Finished
Specifies whether to set the task to finished or not.
4
bool
WithParents
Specifies whether the parent objects will also be considered or not.
  • If true, Across checks recursively if the change of the task state also changes the states of the
  • language
  • document
  • project

Return Values

Result
Type/Value
Interpretation
Success
Is always empty.
Error
53
Task does not exist.
Error
89
Task cannot be finished. More detailed information can be found in the error description.
Error
112
Is not ready to be finished.
Error
194
Task cannot be unfinished.

TaskManager.SetTaskProgress

Sets the task progress.

Parameters

 
Type
Name
Description
1
string
ST
A security token for use in other crossAPI SI functions.
2
string
TaskGuid
GUID of the task.
3
int
TaskProgress
Sets the progress of the task.

Return Values

Result
Type/Value
Interpretation
Success
Error
53
Task does not exist.

TaskManager.SetTaskStartDate

Sets the start date of a task to the given date and time. Checks if date and time is allowed as a start date for the task.

  • The start date of a task needs to be:
  • the same or later than the creation date of a task
  • earlier than the task's due date
  • the same or later than the preceding task's due date

Parameters

 
Type
Name
Description
1
string
ST
A security token for use in other crossAPI SI functions.
2
string
TaskGuid
GUID of the task.
3
DateTime
StartDate
The new value for the start date.

Return Values

Result
Type/Value
Interpretation
Success
Is always empty.
Error
53
Task does not exist.
Error
227
Cannot set start date.

TaskManager.SwitchTaskParagraphState

Tip

Available from Across v7.0 15444.

Changes one paragraph state to another for the specified task. The task cannot be read-only, i.e. it needs to be ready for processing like when it is opened in the Across client.

Tip

Unlike LanguageManager.SwitchLanguageParagraphState, this function can switch the state of paragraphs when another task of the same target language is involved in a crossGrid package. Changed paragraphs will then no longer be overwritten, should the crossGrid package be uploaded again afterwards.

Parameters

 
Type
Name
Description
1
string
ST
A security token for use in other crossAPI SI functions.
2
string
TaskGuid
GUID of the task.
3
DateTime
OriginalStateGuid
The GUID of a paragraph state that should be replaced. The GUID can be obtained via the GetParagraphStateGuidByName function.
Attention

The paragraph state needs to be valid for the task.

4
string
TargetStateGuid
The GUID of a paragraph state that should replace the original one. The GUID can be obtained via the GetParagraphStateGuidByName function.

Return Values

Result
Type/Value
Interpretation
Success
int
The number of changed paragraphs.
Error
23
Document extension is not supported.
Error
24
Workflow does not exist.
Error
41
The paragraph state does not exist.
Error
42
Unable to set paragraph state. More detailed information can be found in the error description.
Error
53
Task does not exist.
Error
180
The document is not ready because it is being checked in.
Error
225
The language content cannot be changed.
Error
241
The paragraph state is not involved in the task.
Error
242
The language cannot be loaded.
Register for our Newsletter now

Our newsletter provides you with exclusive news about the Across Language Server, often even before the official announcement. The newsletter also provides you with early information on events, webinars, and training sessions.

  • Legal Notice
  • GTC
  • Privacy Statement
  • Cookies
  • info@across.net