State Flags

State flags are used to specify the (translation) status of a translation unit. The predefined state flags available for translation units are as defined in the XLIFF Specification 1.1 (which is the underlying data standard of RC-WinTrans).

The following table shows all of the state flags defined in the XLIFF Specification 1.1. There is one state flag that is an extension of RC-WinTrans- this is the “x-changed“ flag.

Value	Description	Defined
final	Indicates the terminating state.	XLIFF specification
needs-review-translation	Indicates that only the text of the item needs to be reviewed.	XLIFF specification
needs-translation	Indicates that the item needs to be translated.	XLIFF specification
new	Indicates that the item is new. For example, the translation units that were not in a previous version of the document.	XLIFF specification
signed-off	Indicates that changes are reviewed and approved.	XLIFF specification
translated	Indicates that the item has been translated.	XLIFF specification
x-changed	Indicates the translation unit is translated but the source text has changed (afterwards).	RC-WinTrans extension

Further information on the XLIFF Specification 1.1 can be found at:

http://www.oasis-open.org/committees/xliff/documents/xliff-specification.htm.

Initial State

Initially, a single translation unit has no state assigned to it after the resource file is added to a project.

Visibility

Text Table View

The state flag for a translation unit is shown in the "State"5 column of the Text Table view (Project window).

Statistics (Pie Graph)

The distribution of state flags is displayed visually in a pie graph in the Statistics dialog.

State Flag Changes

Manual State Changes

See: "Setting Item Attributes and State Flags."

Automatic State Changes)

RC-WinTrans sets/changes the state flag for a translation unit as required. The following actions/processes can force a state flag change:

1.	After editing/entering a translation in the Translation Edit bar the state of the current translation unit will automatically be set to “translated.“ The state is set to “needs-translation“ if the target text is deleted in the Translation Edit bar.
2.	The state is set to “new“ or “x-changed“ after an update process is performed (updating the database after source file changes). The “new“ state flag is applied if the translation unit was recently added during the update process. The “x-changed“ state flag is used if the update process has updated the source text for a translation unit that has already been translated.

State Flag Changes

There are four state flags that are automatically set by RC-WinTrans as required. They are the “translated,“ the “needs-translation,“ the “new,“ and the “x-changed“ state flags.

TIP: The user can determine when and where to use certain state flags (set manually).
RC-WinTrans only sets the four previously mentioned state flags (“translated,“ “needs-translation,“ “new,“ and “x-changed“) automatically because these flags define the state of the translation unit as the result of a certain process which has modified the source or target text.

^ TOP ^