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

Описание настройки

У каждого объекта можно выводить название и номер с помощью системных атрибутов.

Системный атрибут "Название" (title)

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

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

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

Системный атрибут "Номер" (number)

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

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

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

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

Правило именования (шаблон составного атрибута) настраивается на форме редактирования атрибута "Название" (title).

Правило формирования номера настраивается на форме редактирования атрибута "Номер" (number).

Правила именования (шаблон составного атрибута) также могут настраивать для пользовательских атрибутов типа "Строка", правила формирования номера — для пользовательских атрибутов типа "Целое число".

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

Чтобы настроить правила, откройте форму редактирования атрибута, заполните параметры "Определяемый по правилу именования" /"Определяемый по правилу формирования номера" и нажмите кнопку Сохранить, см. Настройка атрибутов класса и типа объектов.

Подробное описание настройки правил именования и шаблона составного атрибута приведено в разделе с описанием параметров атрибута типа "Строка" (параметр "Определяемый по правилу именования" и "Составной").

Подробное описание настройки правил формирования номера приведено в разделе с описанием параметров атрибута типа "Целое число" (параметр "Определяемый по правилу формирования номера").

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

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

Правила, заданные для атрибутов "Название" (title) и "Номер" (number), отображаются в интерфейсе администратора:

  • На формах добавления и редактирования класса или типа объектов.

  • На карточке класса/типа в блоке "Свойства класса (типа)" в полях:

    • Правило формирования атрибута "Название" (title) (отображается правило именования или шаблон составного атрибута).
    • Правило формирования атрибута "Номер" (number).

    Если правила не заданы, то в полях "Правило формирования атрибута "Название" (title)" и "Правило формирования атрибута "Номер" (number)" отображается значение "[не указано]".

Особенности настройки

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

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

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

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

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

Нумерация уже существующих объектов

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

  • в системе уже существуют объекты определенного класса;
  • для данного класса задается правило нумерации объектов {N} — уникальный идентификатор в рамках системы.

Результат настройки: существующим объектам номер не присваивается (значение атрибута для нумерации равно null).

Решение: существующим объектам можно присвоить номер с помощью скрипта, который:

  • задает значение атрибута для нумерации у существующих объектов (подставляет вместо null числовое значение);
  • устанавливает для правила {N} или {ND} значение, от которого будет производиться отсчет номеров у новых объектов (описание методов api для правил нумерации).

Создание объектов скриптами

При добавлении или редактировании объекта при помощи скрипта, нумерация будет вести себя так:

  • при помощи скрипта можно создать дублирующий номер — уникальность будет нарушена;
  • номера созданных при помощи скрипта объектов не учитываются в общем счетчике;
  • при удалении объекта скриптом его номер не "освободится" и будет пропущен в общей нумерации.

Создание объектов импортом

При импорте объектов если создать атрибуты с номерами в AD и импортировать, то эти номера не будут учтены в общем счетчике.

Если же создавать объекты без этого атрибута, то система сама добавит этот атрибут и нумерация будет соблюдена