Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

token

The connection token

Required

projectid

The project

Required

locale

Must be the project source language

Required

name

The path/name of the file

Required

newmode

The new translation mode:

  • TranslateNo - This file is not to be
translatedTranslateYesOnline
  • translated
  • TranslateYesOnline - The file is marked for online
translationTranslateYesOffline
  • translation
  • TranslateYesOffline - The file is marked for offline translation

Required

parser

Use when "newmode" is set to "TranslationYesOnline" only. Required. Indicates the document format. See Parser configuration for values.

Conditional

parserconfig

Use when "newmode" is set to "TranslationYesOnline" only.

The name of the parser configuration for the ParserDomain document format. If empty, the default configuration is selected. Otherwise specify an existing configuration name.

Conditional

includedtarget

Use when "newmode" is set to "TranslationYesOnline" only.

Used for certain document formats only which include both source and target texts. At the writing of this configuration, this parameter applies to POT files only. If set, then the system will pre-translate texts from the translations supplied in the document.

Conditional

reference

Optional when "newmode" is "TranslationYesOnline" or "TranslationYesOffline

" A user defined and optional document reference which can be used as an alternative user-defined document identifier. The system does not require this reference to be unique within a project.

Optional

version

Optional when "newmode" is "TranslationYesOnline" or "TranslationYesOffline"

A user defined and optional version information.

Optional

versiondate

Optional when "newmode" is "TranslationYesOnline" or "TranslationYesOffline"

An optional date that can be set for this document.NOT YET IMPLEMENTED.

Optional

...

The method executes asynchronously. It returns the id of the asynchronous operation or 0 if the operation has completed immediately:

Code Block
languagexml
<int xmlns="http://schemas.microsoft.com/2003/10/Serialization/">2147483647</int>

 

If not 0 then your software should poll the status of the operation every 5 seconds. See Asynchronous operations, operation "asyncoperations/{operationid}/status".