Documentation Center

TranslationManagement 2.5 CreateTranslationFromVersion [internal]

Starts the translation management process. The translation management is done for the given version and logical id.


Parameters

NameTypeDirectionDescription
psAuthContextStringInOutDeprecated proprietary authentication context only used by .ASMX web services based on internal username/password authentication. Claims based security standards drive all the WCF .SVC web services, making this parameter redundant.
psLogicalIdStringInOutThe logical identifier of the object.
  • If no identifier is specified, a new GUID is generated.
  • When an identifier is supplied, the identifier must comply with the element name limitations .
psVersionStringInOutThe version of the object. When no exact version is given, the version number will be returned.
plOutProgressIdLongOutThe unique identifier of the new event.

Requirements are:
  • The user must have write access for the folder in which the object is going to be updated.
  • The object where translation management is triggered on must exist and one of the existing languages must have a (R)eleased or (O)ut-of-date status.
A short typical scenario is (although out-of-scope here):
  • Translation Management is triggered on a version of a logical identifier.
    • If the logical identifier is invalid, you will receive an error (InvalidLogicalId, -156).
    • The given version can only contain an exact version number or "latest". Otherwise you will receive an error ( InvalidVersionNr, -142).
    • If the given logical identifier and version combination does not exist, you will receive an eror (ObjectNotFound, -102).
    • If the given logical identifier and version do not have a language in (R)eleased or (O)ut-of-date status you will receive an error (NoReleasedSourceDocumentFound, -253).
    • If translation management is disabled for the logical identifier, you will receive an error (InfoShareInvalidOperation, -25)
  • An asynchronous task is triggered (CREATETRANSLATIONFROMLIST) with the released or out of date language objects of the logical identifier and version
  • From the available (R)eleased or (O)ut-of-date language objects, it will do calculations which languages can be generated. It will verify where the logical identifier is used and pick up possible requested languages. It will then use the XML Translation Settings > languagepaths element to know which languages it can generate from the released language objects.
Note that:
  • All logical identifiers within Content Manager are in uppercase.
  • A unique event progress id is returned.