Command line call

The translation manager can be called up via the command line to automatically export or import texts. It works in the background without a graphical user interface. Information and error messages are written to the standard output channels "stdout" and "stderr" of the console. At the end, the programme returns a value in the environment variable "%ERRORLEVEL%" and may write an error list.

There are essentially four command line commands:

-E

Exporting texts. Alternative spelling: /E -e /e

-E ProjectFileName ExportFileName FileType TextSelection Source:Language

[Target:Language [Target:Language] ...] [[Additional:Language

[Additional:Language] ...] [SNE:SourceNotEmpty] [TG:TextGroups]

[Flt:Flatten] [MF:MultiFiles]

[CNT:ColumnNameType] [LPT:LanguagePlaceholderType] [VB:Verbose] [LOG[+]:LogFileName]

-I

Importing texts. Alternative spelling: /I -i /i

-I ProjectFileName ImportFileName TextSelection

[Target:Language [Target:Language] ...] [ISL:IdenticalSourceLanguage]

[CTP:CheckTextParameters] [VB:Verbose] [LOG[+]:LogFileName]

-H

Outputs the available command line commands. Alternative spelling: /H H -h /h h ? -? /? HELP

-O

Displays the user interface and opens the project. This command is intended for integrating the translation manager into other programmes in order to quickly open and edit a project.

Alternative spelling: /O -o /o

-O [ProjectFileName]

You can find an application example in the chapter Integration in other programmes.

Argument	Description of the
ProjectFileName	Full name of the project file (*.vw7). If the path or name contains a space, the full name must be enclosed in inverted commas. Example: "C:\Documents and settings\Project1\Project1.vw7"
ExportFileName	Complete file name for the export file. If the path or name contains a space, the full name must be enclosed in inverted commas. Example: "C:\Documents and settings\Project1\Export English.xls"
ImportFileName	Complete file name of the import file. If the path or name contains a space, the full name must be enclosed in inverted commas. Example: "C:\Documents and settings\Project1\Export English.xls"
FileType	Defines the file type for the texts to be exported. Possible values: "ExcelX", "Excel", "Text" or "Xliff". The "MF:1" setting automatically applies for "Xliff"
TextSelection (with command -E)	Defines which texts are to be exported. Possible values: "AllTexts" or "EmptyTexts".
TextSelection (for command -I)	Defines which texts are to be imported. Possible values: "AllTexts" or "EmptyTexts".
Source	Specification of the source/outgoing language. "Source" must be entered as a text constant, for the desired language "Language" must be replaced by a language identifier.
Target (with command -E)	Specify the target languages for which a translation is to be made. Several target languages can be specified for the export. The argument is optional: If it is omitted, all languages of the project are automatically exported as the target language. "Target" must be entered as a text constant; for the desired language, "Language" must be replaced by a language identifier.
Target (with command -I)	Specification of the target languages that have been translated and are now to be imported into the project. Several target languages can be specified for the import. The argument is optional: If it is omitted, all languages found in the file to be imported are automatically imported. "Target" must be entered as a text constant, for the desired language "Language" must be replaced by a language identifier.
Additional	Languages that can be exported to the files in addition to the target languages. Several additional languages can be specified for the export. The argument is optional: If it is omitted, no additional languages are exported. "Additional" must be entered as a text constant; for the desired language, "Language" must be replaced by a language identifier.
Language	Specification of the language, as language identifier (LCID), e.g. "1031" or "1033" or as language name, e.g. "de-DE" or "en-US"
SourceNotEmpty	If the text in the developer language is empty, the text definition is ignored when exporting. Possible values: 0 or 1. The argument is optional: If it is omitted, the setting 0 is used.
TextGroups	List of text groups to be exported. The argument is optional: If it is omitted, all text groups are exported.
Flatten	The nesting of the text groups is resolved into a flat list. Possible values: 0 or 1. The argument is optional: If it is omitted, the setting 0 is used.
MultiFiles	Specifies whether a file with all target languages or a file for each target language should be created. Possible values: 0 or 1. The argument is optional: If it is omitted, the setting 0 is used.
ColumnNameType	Defines the type of column headings for the languages. Possible values: "Llcid" or "SourceTarget". The argument is optional: If it is omitted, the "Llcid" setting is used.
LanguagePlaceholderType	Defines which identifier of the target language is formatted into the file name. Possible values: "Lcid", "Name" or "ThreeLetterWindowsLanguageName". The argument is optional: If it is omitted, the "Lcid" setting is used.
IdenticalSourceLanguage	Texts are only imported if the source language texts match. Possible values: 0 or 1. The argument is optional: If it is omitted, the setting 1 is used.
CheckTextParameters	Texts are only imported if the number, numbering and type of the text parameters are correct. Possible values: 0 or 1. The argument is optional: If it is omitted, the setting 1 is used.
Verbose	Determination of how detailed the information output is. Possible values: 0 or 1. The argument is optional: If it is omitted, the setting 0 is used.
LogFileName	Write information output to a log file. The argument is optional: If it is omitted, the outputs are written to the standard output channels.

When the programme is called via the command line, the programme returns the following values in the variable "%ERRORLEVEL%":

Value	Description of the
0	No errors have occurred. All texts were successfully exported or imported.
1	Warnings The programme starts, but ignores some arguments as they do not match the project. The ignored arguments are logged. Some texts were not exported or imported, or possibly not completely. The texts are logged with the cause.
2	Error The programme cannot start because arguments were specified incorrectly. The incorrect arguments are logged. Some texts were not exported or imported. The texts are logged with the cause.
3	An unexpected programme error has occurred. The programme aborts during the programme run.
4	The log file (LogFile) could not be opened. The programme terminates immediately.