Как найти строку перевода по ключу
Информацию о контексте строки перевода содержит колонка [Ключ]. С помощью ключа можно определить, где в системе используется та или иная строка перевода. Ключ отличается для конфигурационных ресурсов, например, названий кнопок и сообщений в системе, и ресурсов данных, например, локализуемых значений справочников.
На заметку
Перед началом локализации рекомендуем получить базовое представление об архитектуре системы и ознакомиться с разделом [Конфигурация].
Ключи конфигурационных ресурсов
Ключи конфигурационных ресурсов, например названий кнопок, колонок и других элементов интерфейса системы, текстов уведомлений и сообщений, формируются в формате <Тип ресурса>:<Имя схемы>:<Ключ>.
<Тип ресурса> — Configuration.
<Имя схемы> — имя схемы, к которой принадлежит строка перевода. Например, “ActivityPageV2” — это название схемы страницы активности, “ActivitySectionV2” — название схемы реестра раздела [Активности].
На заметку
Список всех схем конфигурации можно просмотреть в разделе [Управление конфигурацией] на вкладке [Конфигурация]–>[Схемы] в разделе [Управление конфигурацией].
На заметку
Названия схем пользовательских разделов можно определить, открыв раздел в мастере разделов. Названия схем для разделов, добавленных пользователями, генерируются на основании значения в поле [Код] на первой странице мастера разделов.
<Ключ> — расположение строки в схеме.
В строках конфигурационных ресурсов используются такие основные типы ключей:
-
“Caption” — заголовок схемы. Например, строка “Configuration:ActivityPageV2:Caption” содержит заголовок схемы “ActivityPageV2”.
-
“Columns” — ключ для строк, которые содержат заголовки колонок для схем объектов. Ключи “Columns” имеют структуру “Columns.<внутреннее название колонки>.Caption“. Например, строка “Configuration:Activity:Columns.Author.Caption” содержит заголовок колонки “Автор” в объекте “Активность“. Заголовки колонок объектов по умолчанию используются для отображения соответствующих полей на страницах и в реестрах разделов и деталей. Таким образом, выполнив локализацию колонки “Автор” объекта “Активности“, вы одновременно локализуете поле “Автор” в реестре раздела и на странице активности.
-
“LocalizableStrings” — ключ локализуемых строк схемы, добавленных разработчиком. Такие строки могут присутствовать в любых схемах (объекты, страницы, бизнес-процессы). Как правило, это нестандартные строки для схем страниц, меню, сообщений и т.д. Ключ “LocalizableStrings” имеет структуру “LocalizableStrings.<внутреннее название локализуемой строки>.Value“. Внутреннее название локализуемой строки задается разработчиком или генерируется автоматически мастером разделов. Например, строка с ключом “Configuration:ActivityPageV2:LocalizableStrings.CallTabCaption.Value” содержит заголовок вкладки [Звонки].
Ключи для строк конфигурационных ресурсов, используемых в бизнес-процессах:
-
“Parameters” — строка содержит заголовки и значения параметров бизнес-процессов. Синтаксис ключа для названия параметра процесса: “Parameters.<внутреннее имя параметра>.Caption“. Синтаксис ключа для перевода значения параметра процесса: “Parameters.<внутреннее имя параметра>.DisplayValue“. Например, строка с ключом “Configuration:CreateInvoiceFromOrder:Parameters.CurrentOrder.Caption” содержит название параметра “CurrentOrder” процесса “Создание счета на основании заказа“.
-
“EventsProcessSchema” — ключ строки встроенного бизнес-процесса объекта. Как правило, такие строки содержат сообщения об ошибках. Синтаксис таких ключей аналогичен синтаксису ключей бизнес-процессов и их элементов.
-
“BaseElements” — строка содержит информацию об элементе процесса. Синтаксис ключа зависит от типа информации. Например, “BaseElements.<внутреннее название элемента>.Caption” — ключ подписи на схеме бизнес-процесса, “BaseElements.<внутреннее название элемента>.Parameters.<внутреннее название параметра элемента>.Caption” — ключ названия параметра элемента, “BaseElements.<внутреннее название элемента>.Parameters.<внутреннее название параметра элемента>.Value” — ключ значения параметра элемента.
На заметку
Название схем бизнес-процессов можно посмотреть в разделе [Библиотека процессов], добавив в реестр раздела колонку [Название]. Подробнее >>>
На заметку
Строки переводов с отображаемыми значениями элементов бизнес-процессов, ключ которых заканчивается словом “DisplayValue”, не требуют локализации и не отображаются в интерфейсе переводов.
Ниже приведены примеры ключей конфигурационных ресурсов и их расшифровка.
-
Configuration:ActivityPageV2:LocalizableStrings.ActivityParticipantTabCaption.Caption — название вкладки [Участники] на странице активности.
“Configuration” — конфигурационный ключ.
“ActivityPageV2” — схема страницы активности.
”LocalizableStrings” — локализуемая строка.
“ActivityParticipantTabCaption” — вкладка [Участники].
“Caption” — название.
-
Configuration:Account:Columns.Type.Caption — заголовок колонки [Тип] объекта [Контрагент].
“Configuration” — конфигурационный ключ.
“Account” — схема объекта [Контрагент].
“Columns” — колонка объекта.
“Type” — имя колонки — [Тип].
“Caption” — заголовок колонки.
-
Configuration:ImportSettingsPage:EventsProcessSchema.LocalizableStrings.ErrorMessage.Value — сообщение об ошибке во встроенном бизнес-процессе схемы “ImportSettingsPage”.
“Configuration” — конфигурационный ключ.
“ImportSettingsPage” — схема страницы настроек импорта.
“EventsProcessSchema” — встроенный процесс схемы.
“LocalizableStrings” — локализуемая строка.
“ErrorMessage” — сообщение об ошибке.
“Value” — текст сообщения.
-
Configuration:AutoGeneratedPageUserTask:Parameters.InformationOnStep.Caption — название параметра [Информация по шагу] элемента [Автогенерируемая страница] бизнес-процесса.
“Configuration” — конфигурационный ключ.
“AutoGeneratedPageUserTask” — схема автогенерируемой страницы.
“Parameters” — параметр схемы.
“InformationOnStep” — параметр “Информация по шагу”.
“Caption” — заголовок параметра.
Ключи ресурсов данных
Ключи ресурсов данных, например, итогов или записей справочников, формируются в формате <Тип ресурса>:<Имя таблицы>.<Имя колонки>:<Ключ>.
<Тип ресурса> — Data.
<Имя таблицы> — имя таблицы, соответствующей таблице локализации. Например, [AddressType] указывает на таблицу типов адресов.
<Имя колонки> — имя колонки таблицы в базе данных. Например, [Description] для описания или [Name] для названия.
<Ключ> — id записи, которая изменяется, например, “fb7a3f6a-f36b-1410-6f81-1c6f65e50343”. Id записи можно найти в базе данных, а также, в некоторых случаях — в адресной строке браузера, открыв соответствующую запись.
Ниже приведены примеры ключей ресурсов данных и их расшифровка.
-
Data:ActivityCategory.Name:42c74c49-58e6-df11-971b-001d60e938c6 — название категории активности “Встреча”.
“Data” — ресурс данных.
“ActivityCategory” — справочник “Категории активностей”.
“Name:” — колонка “Название”.
“42c74c49-58e6-df11-971b-001d60e938c6” — id записи.
-
Data:ContactType.Name:60733efc-f36b-1410-a883-16d83cab0980 — название типа контакта “Сотрудник”.
“Data” — ресурс данных.
“ContactType” — справочник “Типы контактов”.
“Name” — колонка “Название”.
“60733efc-f36b-1410-a883-16d83cab0980” — id записи.
-
Data:SysDashboard.Caption:e2895654-6ce4-4ef8-a126-5f75f49d9073 — название вкладки итогов “Анализ активностей”.
“Data” — ресурс данных.
“SysDashboard” — таблица итогов.
“Caption” — колонка “Заголовок”.
“e2895654-6ce4-4ef8-a126-5f75f49d9073” — id записи.
Смотрите также
•Как использовать фильтры при выборе строк для перевода