Название объекта

Атрибуты для названия объекта
Составное название
Правило именования

Атрибуты для названия объекта

У каждого объекта можно отображать название с помощью системного атрибута "Название" (title). Системный атрибут "Название" (title) определен для каждого класса/типа объектов.

Значение атрибута "Название" (title) может:

указываться произвольно;
формироваться по заданным правилам именования;
вычисляться по определенному шаблону составного атрибута.

Так же можно создать пользовательский атрибут типа "Строка", подробнее в разделе Атрибут типа "Строка".

Составное название

Значение атрибута "Название" (title) и пользовательского атрибута типа "Строка" может вычисляться по определенному шаблону составного атрибута.

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

Место выполнения настройки

Форма редактирования атрибута "Название" (title).

Форма добавления и форма редактирования пользовательского атрибут типа "Строка".

Выполнение настройки

Откройте форму редактирования атрибута, заполните поля и нажмите Сохранить.

Поля с параметрами названия:

Составной:
- Флажок установлен — значение атрибута заполняется автоматически и состоит из значений нескольких атрибутов, коды которых указаны в поле "Шаблон".
Если значение системного атрибут "Название" (title) уже используется в шаблоне других составных атрибутов, т.е. в каком-либо классе/типе существует составной атрибут, в шаблоне которого присутствует атрибут типа "Ссылка на бизнес-объект", ссылающийся на класс с текущим атрибутом "Название" (title), то такой атрибут нельзя определить как составной.
Шаблон.

Шаблон составного атрибута может содержать:
- Строковые константы — произвольные строковые константы: буквы, цифры, словосочетания и т.д.
- Коды атрибутов — коды невычислимых и несоставных системных и пользовательских атрибутов текущего класса/типа.
  
  Код атрибута задается в виде: ${attr}, где attr — код атрибута.
  
  Например, шаблон: ${name} ${price} ${quantity}.
  
  Могут использоваться:
  - код атрибута типа: "Вещественное число", "Временной интервал", "Дата", "Дата/время", "Ссылка на бизнес-объект" (в том числе агрегируемые атрибуты); "Строка", "Целое число", "Элемент справочника";
  - код системного атрибута "Тип объекта" (metaclass);
  - код системного атрибута "Статус" (state).
  Не используются:
  - код системного атрибута "Пароль" (password) системного класса "Сотрудник" (employee);
  - код системного атрибута "Уникальный идентификатор" (UUID);
  - код текущего составного атрибута;
  - код другого составного атрибута;
  - код атрибута типа "Ссылка на бизнес-объект", ссылающийся на текущий класс/тип;
  - код атрибута типа "Ссылка на бизнес-объект", если в классе, на который ссылается данный атрибут, атрибут "Название" (title) является составным;
  - код атрибутов типа "Атрибут связанного объекта".
  Для отображения значений атрибутов шаблона используются стандартные представления для отображения. Для атрибутов типа "Элемент справочника" и "Статус" всегда используется представление "Название". В атрибутах типа "Дата" и "Дата/время" время отображается в часовом поясе сервера.

Результат настройки

Шаблон составного атрибута будет применяться для наименования только новых объектов. Значение атрибута вычисляется один раз при создании объекта.

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

Изменение наименования уже существующих объектов

Условия настройки:

в системе уже существуют объекты определенного класса;
для данного класса задается или изменяется правило наименования или шаблон составного атрибута. К смене правила также относится смена типа объекта, если в новом типе уставлено другое правило).

Результат настройки: у существующих объектов названия не изменяются.

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

Методы API описаны в разделе Пересчет значения составного атрибута.

Правило именования

Значение атрибута "Название" (title) и пользовательского атрибута типа "Строка" может формироваться по заданным правилам именования.

Для класса "Запрос" (serviceCall) применение правил именования для системного атрибута "Название" (title) обязательно, по умолчанию используется правило "{N}.

Правила именования, установленные в классе/типе, по умолчанию наследуется во все вложенные в него типы. Правила могут быть изменены во вложенных типах, в этом случае наследование настроек прерывается.