Deactivation and activation

To prevent an action from running in the message translation, you can comment it in the Translation Configurator using several methods:

  • Using the Edit > Deactivate menu option.
  • Selecting Deactivate from the right-click menu.
  • Using the Deactivate toolbar button.

Uuncomment it by selecting the Activate option, so that it can be performed in the message translation.

Commented lines are rendered in gray.

Note: In the Site Document, disabled actions are displayed in gray.

Comment criteria

For those actions that can have sub-actions, such as IF, ELSE, and ITERATE, if they are commented out, all sub-actions are commented out. They cannot be uncommented individually unless the ancestor is uncommented.

When the ancestor is uncommented, all the sub-actions return to their original status.

For example:

  • If there is a commented COPY under an uncommented IF, and you comment out IF, then COPY is commented. If you uncomment IF, then COPY keeps commented.
  • If there is an uncommented COPY under an uncommented IF, and you comment out IF, then COPY is commented. If you uncomment IF, then COPY becomes uncommented.
  • If you comment out an IF that has an ELSE, then ELSE is commented out. It cannot be uncommented individually unless the corresponding IF is uncommented. You can still individually comment an ELSE when IF is uncommented.

When you copy or cut an action and paste it, the pasted action keeps its original status. The pasted action stays commented when it is pasted under a commented ancestor.

For example:

  • When you copy or cut a commented action that is on the top level, no matter where you paste it, the pasted action stays commented.
  • When you copy or cut an uncommented action and paste it into a commented IF, ELSE, or ITREATE, the pasted action becomes commented.
  • You can copy or cut an action under a commented IF, ELSE, or ITERATE. After this, you can paste it into the top level or under an uncommented IF, ELSE, or ITERATE. The pasted action keeps the same state it had before its original ancestor was commented. If you paste it under a commented IF, ELSE, or ITERATE, then the pasted action stays commented.

Move operations such as Move Up or Move Down can be selected on an action. The state of the action follows the same rule as those after the copy/paste operation is applied.

If no row is selected in the action table, then both Activate and Deactivate are not available.

For a single selection, both Activate and Deactivate are not available in these instances:

  • The action has a commented ancestor.
  • The action is a commented ELSE and its sibling IF is also commented.

An exception to this is when Activate is enabled on a commented action and Deactivate is enabled on an uncommented action.

For multiple selections:

  • If any of these selections belong to one of the single selection cases, then both Activate and Deactivate are not available.
  • If all the selections are commented, then Activate is enabled and you can uncomment those selections by clicking it.
  • If all the selections are uncommented, then Deactivate is enabled and you can comment those selections by clicking it.
  • If all the selections are not commented, then Deactivate and Activate are enabled.
Note: You can still change the properties of a commented action, similar to editing an uncommented action. The change is saved into the xlt file, similar to saving the change of an uncommented action.

When you select the File > Compile menu option to compile a translation file, it calls the hcixlttest xltfile command, which compiles the .xlt file.

If a translation file has an invalid action option, address, and so on, then an error is reported. If an invalid action is commented out, or it has a commented ancestor, then the error is not reported by the hcixlttest command. That is, it is not validated.