[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Collapse]eXpressApp Framework
 [Expand]Fundamentals
 [Expand]Getting Started
 [Collapse]Concepts
  [Expand]Application Solution Components
   Client-Side Mobile Application
  [Expand]Business Model Design
  [Expand]Application Model
  [Expand]UI Construction
  [Expand]Extend Functionality
  [Expand]Data Manipulation and Business Logic
  [Expand]Security System
  [Collapse]Localization
    Localization Basics
    Localize Standard XAF Modules and DevExpress Controls Used in an Application
    Localization Tool
    Culture-Specific Formatting
  [Expand]System Module
  [Expand]Extra Modules
  [Expand]Debugging, Testing and Error Handling
  [Expand]Filtering
  [Expand]Application Life Cycle
 [Expand]Design-Time Features
 [Expand]Deployment
 [Expand]Task-Based Help
  Frequently Asked Questions (FAQ)
 [Expand]API Reference
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
This documentation page describes implementations made in our v17.2 release cycle. To learn about functionality shipping with v18.1, navigate to our updated help file experience at docs.devexpress.com. Learn More

Localization Tool

The Localization Tool is intended to simplify localizing XAF applications. While you can perform localization directly in the Model Editor, in most cases the Localization Tool is more convenient. This topic provides general information for using this tool. Step-by-step instructions for using the Localization Tool are available in the How to: Localize an XAF Application topic.

Note

Check to see if the ready-to-use localizations of standard XAF modules and DevExpress controls are available for your language before using the Localization Tool. You can significantly decrease the number of strings to be translated.

Expanded Invoking the Localization Tool

The Localization Tool can be accessed via the Localization button located at the XAF Model Editor Toolbar. The tool is primarily intended to be used at design time. However, it is also available at runtime, so end-users and application administrators can access its features.

The Localization button is inactive when there are no translation languages added. You should add one or more languages, as described in the Localization Basics topic, in order to use the Localization tool.

Expanded Localization Window Elements

Grid

The Localization window provides a grid editor, containing the following columns.

Column Caption Is Editable Description
Property Name No The localizable property name.
Default Language Value Yes The property value in the default language.
Translated Value Yes The property value in the current translation language.
Is Calculated No A boolean value indicating whether or not the current property value is calculated based on another value. Typically, the calculated values should not be translated.
Is Translated No A boolean value indicating whether or not the current property value has a translated value in the current language. This column updates after saving changes.
Is Modified No A boolean value indicating whether or not the translated value was modified. This column updates after saving changes.
Node Path No The full path to the current property's node. Composed from node IDs, separated by backslashes.
Description No A current property description, that is also visible in the Model Editor in a yellow box below the property grid.

You can use common XtraGrid features - search and sort values, reorder, hide and show columns, apply grouping and filters.

The Default Language Value and Translated Value columns are editable inline. You can select multiple rows, when required. The CTRL+A shortcut selects all rows that are visible due to current filtering.

Toolbar

The localization window has the toobar.

The commands available on the toolbar are described in the table below.

Command Caption Shortcut Description
 Save CTRL+S Saves the changes.
 Import... CTRL+I Imports the translation from the CSV file.
 Export... CTRL+E Performs export to the CSV file. Exposes two choice items - Selected records and Modified records. The Is Translated and Is Calculated columns are excluded when exporting.
Translation Language   Provides a dropdown containing language aspects that are currently available in the Application Model. Use this command to choose the target translation language. To add a language, use the Language Manager dialog available in the Model Editor. Refer to the Localization Basics topic for details.
 Translate... CTRL+T Performs the automatic translation of selected values via the Microsoft Translator online service. An Internet connection is required to execute this command.
 Filters   Provides a dropdown with predefined filters. Choose the required filter or select Custom to specify a custom one with the Filter Editor.

The Export..., Import... and Translate... commands are also available in the grid context menus.

Expanded Filtering

The localizable properties in the grid can be filtered to suit the current demands. You can use the XtraGrid filtering capabilities, but its more convenient to use the Filter dropdown.

The following predefined filters are supplied.

Filter Name Description
None No filtering is applied. Choose this item to get the full list of localizable properties.
Untranslated non-calculated Selects the properties that have non-empty default language values with Is Translated and Is Calculated unchecked. Choose this item to see the list of properties to be translated. Typically, the localization process should be started
Untranslated calculated Selects the properties that have non-empty default language values with Is Translated unchecked and Is Calculated checked. Choose this item to check if there are calculated properties to be translated.
Untranslated Selects the properties that have non-empty default language values with Is Translated unchecked.
Translated Selects the properties that have non-empty default language values with Is Translated checked.
Non-calculated Selects the properties that have non-empty default language values with Is Calculated unchecked.
Calculated Selects the properties that have non-empty default language values with Is Calculated checked.
Custom Invokes the Filter Editor dialog. Choose this item to specify a custom filter.

You can use the custom filter to exclude certain nodes from your "to be translated list". For instance, you can skip the SystemExceptions node, as it contains exceptions addressed to developers and administrators, and invisible to end-users in normal application operation. The following image illustrates the corresponding customized filter based on the predefined Untranslated non-calculated filter.

Expanded Editing Values

The Default Language Value and Translated Value columns are editable inline. So, you can easily perform manual translation cell by cell, just like in a spreadsheet editor. Additionally, you can perform modifications of default language values when required. Values that do not fit the cell width are displayed multiline.

If you edit a value and press ENTER, the value below is focused automatically. If the translated value occurs several times, the following dialog is invoked.

If you choose Yes, all the similar values will be automatically replaced with your translation. You can check "Use always" to remember your choice and suppress this dialog until the next use of the Localization tool. The Save action passes changes to the Model Editor. Note that the Is Translated state is not updated immediately after translating a value. It changes only after executing the Save action. This behavior is implemented to avoid hiding the just translated value by the Translated filter.

The modified records are displayed in bold, as in the Model Editor's property grid.

Expanded Microsoft® Translator Service Support

The Translate... command is designed to perform an automatic translation of the selected values via the Microsoft® Translator service. This is a free online translation service provided by Microsoft. You can access its web front-end at http://www.microsofttranslator.com/. The Translate... action allows you to get the benefit of this service without leaving the Localization window. This action invokes the following dialog.

If the default language is not English, you can select one of the supported source languages. Then click Translate, and the selected default language values will be passed to the Microsoft Translator service. The translated values are modified with the results from the service. If the translation is time-consuming, the progress bar will be displayed. Of course, an active Internet connection is required. However, the automatic translation is not perfect and typically requires manual review.

Note

If you run the Localization Tool from the standalone Model Editor, and you are connecting to the Internet through a proxy server, it is recommended that you add the following setting to the Model Editor's configuration file.

<configuration>
    <system.net>
        <settings>
            <servicePointManager expect100Continue="false" />
...
This file is located in the same folder as the Model Editor executable (%PROGRAMFILES(x86)%\DevExpress 18.1\Components\Tools\eXpressAppFramework\Model Editor\DevExpress.ExpressApp.ModelEditor.v18.1.exe).

Refer to the How to: Create a Custom Translation Provider for the Localization Tool to see how to implement an alternative translation provider. Your custom translation provider can utilize another online translation service, such as Google Translate or a local dictionary.

Expanded Import/Export Functionality

The Export... command provides you with the ability to export selected, modified or all records to a CSV file.

The Is Translated and Is Calculated columns are omitted when exporting. The comma character is used as a separator. The output file encoding is UTF-8. Below is a sample of the output file (descriptions are skipped to save space).

"Property Name","en","de","Node Path","Description"
"Title","MainDemo - Outlook in 60 minutes!","MainDemo - Outlook in 60 Minuten!","Application","..."
"Subtitle","eXpressApp Framework demo application","eXpressApp Framework Demo-Anwendung","Application","..."
"ProtectedContentText","Protected Content","Geschutzter Inhalt","Application","..."
"Caption","Refresh","Aktualisieren","ActionDesign\Actions\Refresh","..."
"Caption","Save","Speichern","ActionDesign\Actions\Save","..."

You can pass the CSV file to a professional translator and ask him/her to edit the values in the Translated Value column using a spreadsheet or plaintext editor of his/her choice. The Description column text helps to see the context in this instance.

The Import... command provides you with the ability to import translations from the CSV file. This command replaces the default and translated values with values found in the specified CSV file. Rows with an invalid node path or property name are skipped. The CSV file encoding should be UTF-8. If the translator saved the CSV file in another encoding, you should convert it to UTF-8 before importing.

Expanded Typical Use Cases

  • The developer performs the localization

    If you are fluent in the target language, you can translate the localizable values, either manually or with the help of the Microsoft Translator service.

  • The developer creates a CSV file for professional translator

    If you have hired a professional translator, you can use the Export... | Selected records command to create a CSV file containing currently selected rows for him. The translated values can be loaded back via the Import command.

  • The localization of standard XAF modules and DevExpress controls is reused

    The common set of localizable values can be translated once, exported to the CSV files and reused in each new application. This approach can be used if there are no ready-to-use language resources for the target language. Use the Export... | Modified records command to export modified records only.

Expanded Settings Storage

The Localization Tool saves its settings between runs (grid settings, translation language and so on) in the system registry under the HKEY_CURRENT_USER\Software\Developer Express\eXpressApp Framework\Model Editor\Localization key. You can delete this key to reset settings.

Expanded See Also

Is this topic helpful?​​​​​​​