Информацию о контексте строки перевода содержит колонка Ключ. С помощью ключа можно определить, где в системе используется та или иная строка перевода. Ключ отличается для конфигурационных ресурсов, например, названий кнопок и сообщений в системе, и ресурсов данных, например, локализуемых значений справочников.
На заметку. Перед началом локализации рекомендуем получить базовое представление об архитектуре системы и ознакомиться с разделом Конфигурация.
Ключи конфигурационных ресурсов
Ключи конфигурационных ресурсов, например названий кнопок, колонок и других элементов интерфейса системы, текстов уведомлений и сообщений, формируются в формате: <Тип ресурса>:<Имя схемы>:<Ключ>.
<Тип ресурса> – всегда “Configuration”. Это значение указывает на то, что строка является конфигурационным ресурсом.
<Имя схемы> — имя схемы, к которой принадлежит строка перевода. “Схемы” — это структурные элементы конфигураций Creatio. С точки зрения локализации, есть три основных типа схем: объекты (представляют таблицы базы данных), страницы и процессы. Например, “ActivityPageV2” — это название схемы страницы активности, “ActivitySectionV2” — название схемы реестра раздела Активности.
На заметку. Список всех схем конфигурации можно просмотреть в разделе Управление конфигурацией на вкладке Конфигурация —> Схемы в разделе Управление конфигурацией.
На заметку. Названия схем пользовательских разделов можно определить, открыв раздел в мастере разделов. Названия схем для разделов, добавленных пользователями, генерируются на основании значения в поле Код на первой странице мастера разделов.
<Ключ> — расположение строки в схеме.
В строках конфигурационных ресурсов используются такие основные типы ключей:
-
“Caption” — заголовок схемы. Например, строка “Configuration:ActivityPageV2:Caption” содержит заголовок схемы “ActivityPageV2”.
-
“Columns” — ключ для строк, которые содержат заголовки колонок для схем объектов. Ключи “Columns” имеют следующую структуру: “Columns.<column internal name>.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” — текст сообщения.
Configuration:ImportSettingsPage:EventsProcessSchema.LocalizableStrings.ErrorMessage.Value — сообщение об ошибке во встроенном бизнес-процессе схемы “ImportSettingsPage”.
- “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” — id записи.
Data:ActivityCategory.Name:42c74c49-58e6-df11-971b-001d60e938c6 — название категории активности “Встреча”.
- “Data” — ресурс данных.
- “ContactType” — справочник “Типы контактов”.
- “Name” — колонка “Название”.
- “60733efc-f36b-1410-a883-16d83cab0980” — id записи.
Data:ContactType.Name:60733efc-f36b-1410-a883-16d83cab0980 — название типа контакта “Сотрудник”.
- “Data” — ресурс данных.
- “SysDashboard” — таблица итогов.
- “Caption” — колонка “Заголовок”.
- “e2895654-6ce4-4ef8-a126-5f75f49d9073” — id записи.
Data:SysDashboard.Caption:e2895654-6ce4-4ef8-a126-5f75f49d9073 — название вкладки итогов “Анализ активностей”.