Локализация веб-модуля
Contents
Веб-доступ может поддерживать различные региональные настройки, которые определяют язык пользовательского интерфейса, формат отображения дат и чисел.
Язык по умолчанию (на котором, например, будет отображена страница логина при первом входе пользователя) зависит от локализации браузера. Впоследствии будут использоваться последние выбранные региональные настройки. Страница входа на сайт веб-доступа всегда отображается с региональными настройками по умолчанию.
У каждого веб-модуля для каждой культуры должны быть файлы локализации.
Все строки локализации веб-доступа хранятся в файлах:
| • | <Корневой каталог>\Extension\DIRECTUM\<название веб-модуля>.localization.<Код языка>.xml – файл локализации веб-модуля; |
| • | <Корневой каталог>\DefaultSettings.localization.<Код языка>.xml – локализация по умолчанию; |
| • | <Корневой каталог>\bin\NpoComputer.WebAccess.localization.<Код языка>.xml – файл локализации базового веб-доступа. |
В качестве кода языка используются код языка и культуры в стандартном формате .NET. Например, русский язык – «ru-RU», английский язык и американская культура – «en-US».
Разработчик веб-сайта может:
| • | переопределить строку локализации по умолчанию или из базового веб-доступа. Для этого нужно в файлах локализации веб-модуля создать строки с таким же кодом, как у переопределяемой строки, задать значения строки на всех языках веб-модуля; |
| • | добавить строку в файл локализации веб-модуля. Для этого нужно добавить новую строку с одинаковым кодом в файлы локализации на всех языках веб-модуля. |
После изменения файлов локализации перезапустите группу приложения веб-доступа или службу IIS.
Структура файла локализации веб-модуля:
<?xml version="1.0" encoding="utf-8" ?>
<Localization>
<s key="{Код строки локализации}">Локализованное значение</s>
</Localization>
Localization – список строк локализации.
s – строка локализации.
key. Код строки локализации.
Сайт и компоненты всегда должны использовать локализацию из файлов \Extension\DIRECTUM. Сообщения, генерируемые внутри кода WebAccess.API, должны быть в файлах ресурсов этой сборки.
Приоритет строк в файлах локализации веб-модулей выше, чем в базовом веб-доступе. Если для какой-то локализации (например, ru-RU) строка не определена (например, LOCALIZATION_CODE), то в пользовательском интерфейсе в этой локализации будет отображаться код строки локализации с постфиксом кода локализации. В данном случае LOCALIZATION_CODE (ru-RU).
Все строки, описываемые в файлах локализации, можно получить, используя глобальную функцию L(code) в JavaScript и WAAPIEntry.L(Code) либо WAAPIEntry.Context.L(Code, Source) в .NET.
| © 2016 Компания DIRECTUM | Сообщество пользователей DIRECTUM |