Configure the incremental localization process

The incremental localization process for IXIA CCMS Desktop allows you to start the localization process without having all the objects in the Authoring:done status or the equivalent status in your deployment.

Important: The incremental localization process is applicable only to the sequential localization model.
Note: If you localize individual topics and images, MadCap Software strongly recommends that you implement the incremental localization process.

Normally, the map and all its children should be in the Authoring:done status, or the equivalent in your deployment, before you can start the localization process. When you implement the incremental localization process, you define each acceptable status before the objects can be sent to the Localization cycle. For example, instead of having the map, the topics, and all the images in Authoring:done before starting the localization process, you can configure it so you can begin the localization process even if some of the topics are still in Authoring:work.

To incorporate the incremental localization process in the workflow, you need make the following changes in the configuration files:
  • Add a new status called Localization:do not translate to the configuration files which defines the available statuses for each object. The Localization:do not translate status identifies the objects that are not authorized to be translated.
  • In the Localize action in the access rights configuration file, define the required statuses for objects at the time they get sent to the Localization cycle.
  • In the localize_api action in the access rights configuration file, define which statuses for each object are set to Localization:tb translated when they are sent to the Localization cycle. All statuses not defined in the localize_api action are automatically set to Localization:do not translate when they are sent to the Localization cycle.
  • In the Prepare kit action in the access rights configuration file, you define which objects and in which status are included in the localization kit.

Objects set to Localization:do not translate are excluded from localization kits that are prepared by IXIA CCMS.

To configure the incremental localization process:
Note: Because your deployment may have different status types, use those equivalents for those specified in this task.
  1. In the TEXTML Administration perspective, connect to your server.
  2. Locate the status.xml file in the repository's /system/conf collection.
  3. Check out the file and open it for editing.
  4. In the section <collection="/content/localization/" >, add the do not translate state by copying the following lines and pasting them inside the states element.
    Important: Do not alter the name of the state from do not translate.
    <state level="0" name="do not translate" type="work">
    	<lockable>
    		<objtypes>
    			<type>none</type>
    		</objtypes>
    	</lockable>
    	<milestone/>
    	<nextStates/>
    </state>

    It should look like the following example:

    <cycle collection="/content/localization/" description="" initial="false" lastworkcycle="false"
    	level="0" name="Localization" type="localization">
    	<nextCycle/>
    	<states>
    		<state level="0" name="do not translate" type="work">
    			<lockable>
    				<objtypes>
    					<type>none</type>
    				</objtypes>
    			</lockable>
    			<milestone/>
    			<nextStates/>
    		</state>	
    		<state initial="true" level="0" name="tb translated" type="work">
    			<lockable>
    				<objtypes>
    					<type>image</type>
    				</objtypes>
    			</lockable>
    			<nextStates>
    				<next>in translation</next>
    			</nextStates>
    		</state>
    		
    		[ . . . ]
    
    	</states>	
    </cycle>	
  5. Repeat the previous steps you completed for status.xml to add the new state to the following files:
    • map_status.xml
    • topic_status.xml
    • image_status.xml
  6. Save, close, and check in the files.
  7. Open the Access Manager window.
    1. Right-click your docbase.
    2. Click CCMS Admin.
    3. Click Manage Access.
  8. In the Actions column, click Localize and click Lock to configure the localization process.
  9. For each condition, define which objects in which statuses can be sent to the Localization cycle:
    1. In the Conditions column, click a condition.
    2. Click the arrow next to an object to expand the list of cycles.
    3. Click the arrow next to Authoring to expand the list of statuses.
    4. Select each status which is authorized to be sent to the Localization cycle.
    5. Repeat for each object.
    6. Repeat for each condition.

    For example, if you wanted to allow the map and all its children to be able to be sent to the Localization cycle regardless their status, you would select all the statuses for all the objects.

  10. In the Actions column, click localize_api to define which statuses are set to Localization:tb translated for when objects are sent to the Localization cycle. All other statuses will be set automatically to Localization:do not translate.
  11. For each condition, define which statuses can be sent through the localization process:
    1. In the Conditions column, click a condition.
    2. Click the arrow next to an object to expand the list of cycles.
    3. Click the arrow next to Authoring to expand the list of statuses.
    4. Select each status for which you want to authorize to be translated.
    5. Repeat for each condition.

    For example, if you only wanted objects in Authoring:done and Authoring:accepted, you would select only those statuses. This means that objects with an Authoring:done and Authoring:accepted status are set to Localization:tb translated when they get sent to the Localization cycle. All objects in any other status are set to Localization:do not translate.

  12. In the Actions column, click Prepare kit.
  13. For each condition, define which objects in which statuses you can prepare a localization kit from:
    1. In the Conditions column, click a condition.
    2. Click the arrow next to an object to expand the list of cycles.
    3. Click the arrow next to Localization to expand the list of statuses.
    4. Select each status you want included in the localization kit.
    5. Repeat for each object.
    6. Repeat for each condition.

    For example, if you want to allow users to only prepare localization kits from maps in status Localization:tb translated, then you would select only Localization:tb translated for maps.

  14. In the Actions column, click Retranslate.
  15. For each condition, define which objects can be re-translated:
    1. In the Conditions column, click a condition.
    2. Click the arrow next to an object to expand the list of cycles.
    3. Click the arrow next to Localization to expand the list of statuses.
    4. Select each status you want included in the localization kit.
    5. Deselect do not translate.
    6. Repeat for each condition.
    Tip: It is recommended to selected all the statuses, except do not translate.
  16. Save, close, and check in the file.
  17. Test your implementation. If it is not behaving as expected, verify the access rights are configured correctly for each object and status in each condition.
  18. 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 IXIA CCMS > Synchronize Configuration. Additionally, refresh IXIA CCMS Web so that users will see the change reflected there.