Локализация разметки

Для разметки карточки можно предусмотреть различные варианты локализации.

Созданная разметка по умолчанию не содержит локализаций. Новые локализации добавляются вручную из Конструктора разметок. После добавления новых локализаций локализованные названия встроенных элементов управления будут загружены из сборок ресурсов при открытии разметки в Конструкторе разметок.

Чтобы использовать в разметке стандартные элементы управления, локализованные названия нужно настроить самостоятельно.

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

Когда карточка открывается в клиентских приложениях системы, язык карточек будет выбран в соответствии с локализацией, настроенной для приложения. В интерфейсе Конструктора разметок отображение локализации зависит от значения поля Локализация.

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

При копировании разметки из другого вида копируются только параметры по умолчанию. Если для вида, в который копируются разметки, заданы дополнительные локализации, для копируемых разметок будет сгенерирован собственный .xml файл с параметрами локализуемых свойств.

Добавить локализацию разметки

Добавление локализации при работе с системой Docsvision необязательно. Создавать новые локализации необходимо, когда при работе с Docsvision предполагается использовать несколько иностранных языков. Если требуется создать несколько вариантов перевода для новых "пользовательских" полей, добавляемых в карточки при внедрении системы.

Язык интерфейса напрямую зависит от языка клиентского приложения (задан в параметрах Windows-клиент или указан при старте РМА). При открытии клиентского приложения, язык интерфейса (главного окна приложений) будет определяться данными настройками, а язык разметки карточек будет определяться по следующим правилам:

Если для выбранного языка клиентского приложения не будет найдено соответствующей локализованной разметки, карточки откроются с разметкой по умолчанию.
Если для выбранного языка клиентского приложения будет найдена соответствующая локализация, в карточках будет показана разметка найденной локализации.

Так, если при работе с системой Docsvision предполагается использование только русского языка, добавление локализации RU не требуется. Если же предполагается использовать в работе, помимо русского, например, ещё и английский язык, рекомендуется в настройках Windows-клиент добавить две локализации — RU и EN.

Локализация добавляется для вида карточки. Для всех разметок вида будет доступен одинаковый набор локализаций.

Список локализаций для вида автоматически распространяется только на элементы управления. Описание настройки локализации для ленты карточек см. в данном разделе.

Чтобы добавить новую локализацию для разметки:

В главном окне Конструктора разметок выберите значения в полях Библиотека карточек и Вид карточки.

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

Рисунок 1. Элементы ленты для настройки локализаций разметки карточки
Нажмите кнопку , чтобы открыть окно Локализация разметок вида для редактирования локализаций.

Рисунок 2. Окно редактирования локализаций
Чтобы добавить локализацию, нажмите .

По умолчанию будет добавлена локализация en.

Рисунок 3. Первичное добавление локализации
Чтобы изменить вариант локализации, щелкните левой клавишей мыши по записи, которую нужно изменить. Затем выберите локализацию из выпадающего списка доступных и нажмите ОК.

Каждый язык может быть добавлен только один раз. При повторном выборе уже добавленного языка появится сообщение: Выбранная локаль уже добавлена.

Рисунок 4. Выбор языка локализации

При сохранении изменений для разметки будет сгенерирован .xml файл, в котором в дальнейшем будут сохранены параметры локализуемых свойств дополнительных элементов управления.
Выполните настройку локализации дополнительных элементов управления.

Локализация общих свойств "дополнительных" элементов управления

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

Инструкция по настройке локализации для данных свойств приведена в разделе "Настройка локализации".

Локализация специфических свойств "дополнительных" элементов управления

Для ряда элементов управления имеются специфические свойства, которые требуют добавления локализованных значений.

Элементы управления, имеющие специфические свойства:

Настройка локализации описана в секции Настройка локализации на странице описания каждого из данных элементов.

Удалить локализацию разметки

Чтобы удалить ранее созданную локализацию для разметки:

В главном окне Конструктора разметок выберите значения полей Библиотека карточек и Вид карточки.

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

Рисунок 5. Окно редактирования локализаций
Чтобы удалить локализацию, выберите из списка запись, которую требуется удалить, затем нажмите .

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

Локализация будет удалена.

При удалении строки локализации, будет также удалён .xml файл, в котором хранились настройки данной локализации.