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:

In the TEXTML Administration perspective, connect to your server.
Locate the localizationManagers.xml file in the repository's /system/conf collection.
Check out the file and open it for editing.
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.

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>

Change the configuration options as required.

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 -->

Save, close, and check in the file.
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.