This functionality is only available for certain module packages. Info / Copyright

Action: translate


Parameters

Description

TYPE 

Type of task that the action is to perform:

TRANSLATEPROJECT: Translate project
TRANSLATEPAGES: Translate specified pages
REMOVELANGUAGE: Remove language entry
EXPORTMISSINGTRANSLATIONS: Export missing-word list

IMPORTTOTRANSDB: Import database (dictionary)

EXPORTFROMTRANSDB: Export database (dictionary)

PROJECTNAME

Project name with complete file path (optional).
If nothing is entered, the selected project will be used if the action is to be run over the user interface (e.g. via the script or ribbon). When executing from the Windows command line, PROJECTNAME must be specified or ProjectAction has to be used before that. Otherwise a system message will appear.

IMPORTFILE 

Name of the file with the database (dictionary) to be imported. This parameter has an effect only if the TYPE parameter has the following value: IMPORTTOTRANSDB.

EXPORTFILE 

Name of the file with the exported missing-word list. This parameter has an effect only if the TYPE parameter has the following value: EXPORTMISSINGTRANSLATIONS.

CONVERTER 

Name of the converter (optional). This name is used as the input and output format. Default values:

  • XTrLanguageDbXmlConverterImpl.(native XML format; for TYPE = EXPORTFROMTRANSDB)
  • XTrLanguageDbXml2TabConverterImpl (for TYPE = IMPORTTOTRANSDB or TYPE = EXPORTMISSINGTRANSLATIONS)

This parameter has an effect only if the TYPE parameter has one of the following values: EXPORTMISSINGTRANSLATIONS, IMPORTTOTRANSDB or EXPORTFROMTRANSDB.

LANGUAGE 

Translation language (e.g. fr_FR).

USEPAGEFILTER

Determines whether only filtered pages or all project pages will be used (optional). Corresponds to the activation of the filter in the user interface. This parameter has an effect only if the TYPE parameter has the following value: TRANSLATEPAGES.
Default value: 0

PAGEFILTERNAME

Name of the page filter. Only those pages are translated that are filtered by the filter named PAGEFILTERNAME. This parameter has an effect only if the TYPE parameter has the following value: TRANSLATEPAGES.

PAGENAME 

Name of the page to be translated (optional).

PAGENAMEn

Names of the pages to be translated (optional). In this case, n is a number, e.g., /PAGENAME1:=EB3+ET1/2 /PAGENAME2:=EB3+ET1/4 /PAGENAME3:=EB3+ET1/7, etc. These parameters are only effective in connection with the following value of the TYPE parameter: TRANSLATEPAGES.

SELn

Object ID of the pages to be translated (optional). Here, n is a number, e.g., /SEL1:38/4/12/0. Alternative to PAGENAMEn. This parameter has an effect only if the TYPE parameter has the following value: TRANSLATEPAGES.

Note:

The source language cannot be removed from a project. If several languages are to be removed from a project, the languages will have to be specified individually and separated by a comma (e.g., /LANGUAGE:en_US,fr_FR,da_DK).

ClosedExample:

Translate project:

translate 
/TYPE:TRANSLATEPROJECT 
/PROJECTNAME:C:\Projects\EPLAN\ESS_Sample_Project.elk

Import database (dictionary):

translate 
/TYPE:IMPORTTOTRANSDB 
/CONVERTER:XTrLanguageDbXmlConverterImpl 
/IMPORTFILE:c:\test\TranslationDB_FULL.etd 
/LANGUAGE:de_DE

Remove translation from project:

translate 
/PROJECTNAME:C:\Projects\EPLAN\ESS_Sample_Project.elk 
/TYPE:REMOVELANGUAGE 
/LANGUAGE:en_US

Export missing-word list:

translate 
/TYPE:EXPORTMISSINGTRANSLATIONS 
/PROJECTNAME:C:\Projects\EPLAN\ESS_Sample_Project.elk 
/LANGUAGE:en_US 
/EXPORTFILE:d:\temp\missingTransFile.txt 
/CONVERTER:XE5LanguageDbXmlConverterImpl