Определить контекст строки перевода по колонке “Ключ”

PDF
Продукты
Все продукты

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

На заметку. Перед началом локализации рекомендуем получить базовое представление об архитектуре системы и ознакомиться с разделом Конфигурация.

Ключи конфигурационных ресурсов 

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

<Тип ресурса> – всегда “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 — название параметра Информация по шагу элемента Автогенерируемая страница бизнес-процесса.

Рис. 1 — Примеры строк перевода для конфигурационных ресурсов и соответствующие им элементы на странице контакта
scr_chapter_multilanguage_keys_configuration_keys_list.png

Ключи ресурсов данных 

Ключи ресурсов данных, например, итогов или записей справочников, формируются в формате: <Тип ресурса>:<Имя таблицы>.<Имя колонки>:<Ключ>.

<Тип ресурса> — всегда “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 — название вкладки итогов “Анализ активностей”.

Рис. 1 — Примеры строк перевода для ресурсов данных и соответствующее им поле справочника на странице контрагента
scr_chapter_multilanguage_keys_data_keys_list.png