Локализация

Языки локализации и язык по умолчанию

Чтобы локализация приложения стала возможной, в описании проекта должны быть заданы языки локализации и один из них должен быть указан как язык по умолчанию. Например:

Ид: 64d5452a-9771-4623-b589-c440739364a4
РежимСовместимости: 4.0
Разработчик: e1c
Имя: DemoProject
Версия: 1.0
Представление: "Demo CRM"
ЯзыкиЛокализации:
    - Русский
    - Английский
ЯзыкПоУмолчанию: Русский

Если не указать ни одного языка, это будет означать, что проект не нуждается в локализации. В качестве языков локализации можно выбрать только те, которые являются значениями перечисления Язык.

Элемент проекта вида «ЛокализованныеСтроки»

Используйте элемент проекта вида ЛокализованныеСтроки для хранения строк, которые должны быть переведены на другие языки. Эти строки могут использоваться в различных элементах и модулях проекта.

Элемент проекта вида ЛокализованныеСтроки содержит имена локализуемых строк и их значения на языке по умолчанию. Блоки идентификаторов разделены на две секции:

Строки

Строки можно использовать в описании элементов проекта и во встроенном языке.

Шаблоны

Шаблоны можно использовать только во встроенном языке. В них можно подставлять значения переменных.

Пример:

ВидЭлемента: ЛокализованныеСтроки
Ид: d0adc076-d030-4546-bd1a-8b497668b0fc
Имя: ЛокализованныеСтроки
ОбластьВидимости: ВПроекте
Строки:
    Мероприятия: Мероприятия
    Задачи: Задачи
    События: События
    Событие: Событие
    Роль: Роль
Шаблоны:
    ТекущееВремя: "Текущее время: %0"
    СозданаЗадача: "Создана задача \"$0\""
    СозданоСобытие: "Создано событие \"$0\""

Вы можете указать нужные строки как в YAML-файле, так и в палитре свойств элемента проекта вида ЛокализованныеСтроки.

Раздел проекта «Локализация»

Строки, которые должны быть локализованы, указываются в элементе проекта ЛокализованныеСтроки. Чтобы сохранить в проекте их значения на другом языке (язык может быть только тот, который вы указали в описании проекта в свойстве ЯзыкиЛокализации), вы должны добавить к проекту раздел Локализация. Если вы не сделали этого при создании элемента проекта вида ЛокализованныеСтроки, вы можете добавить этот раздел следующим образом:

В результате структура проекта будет выглядеть следующим образом:

Элемент локализации должен содержать только секции с именами и значениями локализуемых строк. Например:

Строки:
    Мероприятия: Activities
    Задачи: Tasks
    События: Events
    Событие: Event
    Роль: Role
Шаблоны:
    ТекущееВремя: "Current time: %0"
    СозданаЗадача: "Task \"$0\" created"
    СозданоСобытие: "Event \"$0\" created"

Использование в значениях свойств элементов

В случае использования локализованной строки в значениях свойств элементов, описанных в YAML, необходимо указать идентификатор локализованной строки, начиная с символа $. Идентификатор локализованной строки состоит из трех частей и выглядит следующим образом: $<Имя подсистемы>::<Имя элемента проекта локализованных строк>.<Имя локализованной строки в данном элементе>.

Представление: $$Нелокализованное представление

также позволяет вам задавать идентификаторы локализованных строк в палитре свойств элементов проекта и компонентов интерфейса. Для этого активируйте настройку Использовать локализованное значение для нужного свойства и выберите требуемое значение из списка. Например, для элемента проекта НавигационнаяКоманда из первого примера настройка свойства Представление будет выглядеть следующим образом:

Правила разрешения коллизий такие же, как и при обращениях к другим объектам встроенного языка:

• Если локализованные строки находятся в той же подсистеме, где и вызываются, то указание подсистемы после «$» необязательно.
• Если подсистема с нужными локализованными строками импортируется, то указание подсистемы после «$» необязательно.
• Коллизии локализованных строк с текущей и импортируемыми подсистемами разрешается в пользу локальных локализованных строк.
• Необходимо указывать нелокальную подсистему в идентификаторе локализованных строк, если подсистема используется, но не импортируется.

Использование во встроенном языке

Во встроенном языке можно обратиться к локализованной строке, указав имя элемента проекта вида ЛокализованныеСтроки и, через точку, имя локализованной строки. Если это строка-шаблон, то подставляемое значение можно передать в виде аргумента:

Сообщить(ЛокализованныеСтроки.ТекущееВремя("${Время.Сейчас()|ч:мм}"))

В этом примере используется строка-шаблон с именем ТекущееВремя, в которую подставляется отформатированное представление текущего времени:

"${Время.Сейчас()|ч:мм}"

Как запустить приложение с другим языком

Существует порядок, по которому определяет, какой язык нужно выбрать для конкретного пользователя. Этот порядок описан в следующем разделе.

Чтобы проверить, как работает приложение на другом языке локализации, необходимо запустить приложение и указать нужные региональные установки в параметре URL. Например, для английского языка:

http://localhost:9090/applications/DEMO?locale=en_EN

Текущее время: 5:37

При запуске с английскими региональными установками он выведет строку на английском языке:

Current time: 5:38

Порядок определения текущих региональных установок при подключении пользователя

• Параметр locale, передаваемый в URL. Например:

  http://localhost:9090/applications/DEMO?locale=en_EN

  Если параметр не указан или не поддерживается , то используется следующий пункт.
• Поддерживаемый приложением язык из списка предпочтительных языков браузера. Список языков браузера берется из значения HTTP-заголовка Accept-Language. В случае неудачи используется следующий пункт. Возможные причины неудачи:
  • В списке языков браузера нет ни одного языка из поддерживаемых .
  • Браузер устарел, и у него нельзя узнать предпочтительные языки.
• Локаль приложения (в панели управления Приложения > нужное приложение > Настройки > Общие > Локаль), которая задается при создании приложения. Если локаль приложения не указана, тогда используется следующий пункт.
• ЯзыкПоУмолчанию из файла описания проекта.