Enable and configure the sequential localization method

You configure IXIASOFT CCMS to use the CCMS Desktop sequential localization method by enabling the SequentialLocalizationManagerService and SequentialImageLocalizationManagerService managers in the localizationManagers.xml file.

Note: In DRM, these managers are called:
  • SequentialLocalizationManagerServiceWithContainer
  • SequentialImageLocalizationManagerServiceWithContainer

The following code shows the sequential localization manager classes in the localizationManagers.xml file.

<!-- Sequential Localization Manager, with auto-translation disabled -->
<manager class="com.ixiasoft.cms.controller.localization.sequential.SequentialLocalizationManagerService" 
   name="Sequential Localization manager">
   <config name="substantialChange">false</config>
   <config name="full.context">false</config>
   <config name="context.document.type">Dita2Pdf</config>
   <config name="include.default.images">true</config>
   <config name="in.context.exact.matches">false</config>
   <config name="translatable.attributes">alt,navtitle</config>
   <!-- <config name="import.translations.skip.review">true</config>-->
   <!-- <config name="translation.autotranslation.fulltranslation.status">Localization:translated</config> -->
   <!-- <config name="retranslated.state"></config> -->
   <!--<config name="translated.state.type">review</config> -->   
</manager>

<manager class="com.ixiasoft.cms.controller.localization.sequential.SequentialImageLocalizationManagerService"  
   name="Sequential Image Localization manager"
   type="image">
</manager>
Table 1. Sequential localization method options for CCMS Desktop
Option Function
substantialChange Currently not supported for the sequential localization method. Leave the field as is.
full.context Specifies whether to package in the localization kit only the files that require translation (false) or to package all the files, even if they do not need to be translated (true).

Default value is false.

Suppose a map that contains five topics, but only two topics have been updated. When full.context=true, the five topics are included in the localization kit to provide context for the files that need to be translated. When full.context=false, only the two updated topics are included in the kit.

context.document.type Specifies how to output the context documents, such as originals.zip and lasttranslation.zip.

The value must match one of the output types defined for your deployment. Enter the output type name as it appears in the outputtypes.xml file (for example, Dita2xhtml or Dita2Pdf).

If you do not want these context documents, leave this field empty.

include.default.images Specifies whether images should be provided as part of the localization kit for context.
Note: Such images are not provided in a format that can be used for localization; they are provided for context only.

Default value is false.

in.context.exact.matches Specifies whether to perform auto-translation when preparing the localization kit. If in.context.exact.matches is set to true, auto-translation is enabled. The sequential localization manager checks the previous version of the language object and will auto-translate elements that were previously translated and haven't changed.

If in.context.exact.matches is set to false, auto-translation is disabled. The sequential localization manager does not perform auto-translation and sends the content in the original language.

Default value is false.

translatable.attributes

Identifies an attribute as localized content and prevents the sequential localization manager from resetting the attribute.

By default, if auto-translation is enabled, the sequential localization manager resets attributes to the latest value in Authoring when preparing the localization kit. To prevent the sequential localization manager from resetting the attribute when auto-localization is enabled, add it to the translatable.attributes configuration option. Separate each attribute with a comma; for example:
<config name="translatable.attributes">alt,navtitle</config>
import.translations. skip.review Specifies if an object bypasses the status "review" (or the equivalent in your deployment) when it is re-imported into the Content Store after localization. Valid values are:
  • False: Puts the status to "review". This is the default value.
  • True: Skips the status "review" and puts it in the status defined by the translation.autotranslation.fulltranslation.status option or to the next status in the workflow if the option is not set.
translation.autotranslation. fulltranslation.status Specifies the status for documents that were fully translated by the auto-translation process. For example:
Localization:machine translated
Note: This status must be a valid status configured in your workflow. If you specify a status that is not in your workflow, this option will be ignored.
There is no default value for this option. If you don't specify it, the documents will be put in the standard workflow status (for example, Localization:review)
translated.state.type Specifies the type of state of the object when it is re-imported into the Content Store after localization. Valid values are:
  • review: Re-imported objects are set with the review state which corresponds to the status of "Localization:review" (or the equivalent in your deployment). This is the default value.
  • end: Re-imported objects are set with the end state which corresponds to the status of "Localization:done" (or the equivalent in your deployment).
retranslated.state Specifies the state that the topics will be in after they are retranslated from source with the Localization > Retranslate from source command. This must be a valid state in your deployment.
Important: Make configuration changes in a test environment and confirm they work before copying them to a production environment. For dedicated SaaS deployments, test the changes and then ask IXIASOFT Customer Support to copy the changes to your production environment.

To enable and configure the CCMS Desktop sequential localization method:

  1. In the TEXTML Administration perspective, connect to your server.
  2. Locate the localizationManagers.xml file in the repository's /system/conf collection.
  3. Check out the file and open it for editing.
  4. Search for the SequentialLocalizationManagerService class.
    By default, the sequential localization manager is enabled in the localizationManagers.xm file; that is, its <manager> element is not commented out.
  5. To use the sequential localization manager, make sure that the <manager> elements for the SequentialLocalizationManagerService and SequentialImageLocalizationManagerService classes are not commented out, as shown below:
    <manager class="com.ixiasoft.cms.controller.localization.sequential.SequentialLocalizationManagerService"  
       name="Sequential Localization manager">
          <config name="substantialChange">false</config>
          <config name="full.context">false</config>
          <config name="context.document.type">Dita2Pdf</config>
          <config name="include.default.images">true</config>
          <config name="in.context.exact.matches">false</config>
          <config name="translatable.attributes">alt,navtitle</config>
          <!-- <config name="import.translations.skip.review">true</config>-->
          <!-- <config name="translation.autotranslation.fulltranslation.status">Localization:translated</config> -->
          <!-- <config name="retranslated.state">retranslated</config> -->
          <!--<config name="translated.state.type">review</config> -->
          <!-- <config name="import.translations.skip.review">true</config>-->
    </manager>
    
    <manager class="com.ixiasoft.cms.controller.localization.sequential.SequentialImageLocalizationManagerService" 
       name="Sequential Image Localization manager"
       type="image">
    </manager>
  6. Change the configuration options as required.
  7. Since only one localization manager can be enabled at any time, make sure that the concurrent localization manager is commented out.
    For example:
    <!-- Concurrent localization method -->
    <!-- manager 
    class="com.ixiasoft.cms.controller.localization.NodeBasedLocalizationManagerService" 
         name="Node based Localization manager">
         <config name="substantialChange">false</config>
    </manager -->
  8. Save, close, and check in the file.
  9. Inform users of the changes.
    The changes will be applied automatically once users close and then reopen their CCMS Desktop. Users can also apply the changes without restarting their CCMS Desktop by clicking IXIASOFT CCMS > Synchronize Configuration. Additionally, refresh IXIASOFT CCMS Web so that users will see the change reflected there.