Languages(XmlMls, bidirectional)

SUMMARY

The tool ALPHA-VISION®XmlMls exports and reimports all language dependent string data. Its purpose is to allow translation of this data within Excel files.

CONTENTS

  1. Files
  2. Export
  3. Import
  4. Technical information

Files

XmlMls generates and reimports csv files, which can be accessed by using Excel. The naming convention of the csv files is according to the following:
'XmlMls_' + key of source language + '_TranslatedTo_' + key of target language + '.csv'

Each of the files has two rows, one for the source and one for the target lanugage. The row header contains the names of the source language and the corresponding target-language. Consequently, the first row holds all values of the source and the second row the values of the target language. In this second row, translators can work to create or update existing entries.

Note:
Please note, that the row headers and the first row entries, as well as the file names must not be changed in any way.

Export

To export the language relevant date, first chose the source language in the language selection combo box. Then start the export by clicking on the XmlMls export icon in the toolbar.

From all ALPHA-VISION® xml files that are located beneath the project directory, and for all XML-elements, that do have a text attribute with a key which matches the key of the selected language, an entry is written in each of the target-language .csv-files.

Import

To import, click on the XmlMls import icon in the toolbar, then chose the csv-file you want to import from the file dialog.

The source and the target language are set by the keys given in the file name and all ALPHA-VISION® xml language data beneath the project directory is updated with the data from the csv-file.

Note:
It is not possible to import more than one .csv file at once.
If the specified source language is not found in the project, the import fails.
If the specified target language is not found, XmlMls prompts to decide wether to create the new language or to cancel the import.

Technical information

The export is done by applying the file language-extract.xsl to all ALPHA-VISION® xml data. Likewise, the reimport language-import.xsl uses the exported .csv-data to update all ALPHA-VISION® xml language data. Both .xsl-files use the same secondary .xsl-file ParamFor_LangData.xsl where all necessary parameters for the export and reimport are given.

Note:
Please note that during the re-import the file empty.xml is given as xml-file to transform. This has to be done because by xslt-standard, any transformation has to operate on valid xml. So, to transform the .csv-file, which is not valid xml, this empty-xml-file is given, but the language-import.xsl actually uses the csv-file that is given by the xsl-parameters $csv or $csv-doc

A more detailed description of parameters and the strategy can be found as xml-comment in ParamFor_LangData.xsl and examples for the command line export and reimport are given in lang.bat.