Настройка свойств типов объектов

Раздел "Типы объектов" → "Расширенные свойства" веб-интерфейса администратора Avanpost IDM предназначен для управления свойствами типов объектов Системы (создания новых свойств и редактирования текущих свойств).


Рисунок – Раздел "Расширенные свойства"

Примечание:

Привязка созданных свойств к типам объектов Системы осуществляется в разделе "Типы объектов" → "Объекты" веб-интерфейса администратора Avanpost IDM. См. статью "6.1.8.2. Настройка типов и подтипов объектов" руководства по администрированию

Навигатор по разделу:

1. Создание нового свойства

Для создания нового свойства необходимо:

  1. На основной странице раздела "Расширенные свойства" веб-интерфейса администратора Avanpost IDM нажать .
  2. Выбрать тип свойства (Boolean/ Date/ DateTime/ File  и др. Подробнее о типах свойств см. Таблицу).
  3. Заполнить открывшуюся карточку свойства выбранного типа на вкладке "Основное":
    1. Название – задать системное название свойства, которое будет использоваться в дальнейшем при настройке процессов и разработке скриптов.
    2. Описание – задать произвольное описание свойства, которое будет отображаться в списке свойств в разделе "Расширенные свойства".
    3. Чекбокс "Уникальное свойство" – отметить, если требуется, чтобы у каждого объекта с этим свойством было уникальное значение.
    4. Чекбокс "Скрытое свойство" – отметить, если требуется скрыть данное свойство.
    5. Чекбокс "Не участвует в расчете динамических политик" – отметить, если требуется отключить участие свойства в расчете динамических политик.
    6. Чекбокс "Шифрованное значение" – отметить, если требуется шифровать значение данного свойства в БД.
    7. Значение по умолчанию – задать значение, которое будет установлено в свойстве по умолчанию.
  4. Заполнить карточку свойства на вкладке "Настройки контрола" (см. Таблицу).
  5. При необходимости добавить на вкладке "Валидация" скрипт валидации (валидатор) для свойства, который будет проверять значения свойства на соответствие заданным в валидаторе критериям (см. Таблицу).
  6. Нажать .

Таблица – Карточка свойства

Тип свойства

Вкладка "Настройки контрола"

(настройки отображения элемента интерфейса)

Валидация

(оценка значений полей на корректный формат ввода и настройка вывода ошибки по разным параметрам)

ArrayString – массив строковых значений

  • input – массив строковых значений, например json представлений

Заголовок – задать заголовок свойства, который будет отображаться в веб-интерфейсах Системы при просмотре свойств соответствующих объектов.

Заполнитель – задать подсказку-плэйсхолдер, которая будет отображена в поле данного свойства у объектов до ввода значения.

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

Добавление нового валидатора – выбрать из выпадающего списка один из вариантов для добавления проверки (можно добавить более одного валидатора, выбирая их в списке поочередно):

  1. "Required" – стандартная проверка на заполнение свойства, чтобы свойство стало обязательным для заполнения.
  2. "Script" – нестандартный скрипт валидации, написанный в разделе "Настройка процессов" → "Скрипты" веб-интерфейса администратора Avanpost IDM.
    1. Скрипт – выбрать из выпадающего списка требуемый скрипт.
Сообщение об ошибке – указать для каждого добавленного валидатора сообщение об ошибке, которое будет выводить Система в случае несоответствия значения свойства заданным в валидаторе критериям. Например, "Это поле обязательно для заполнения".

При указании сообщения об ошибке можно воспользоваться шаблоном:

Ошибка валидации: {{0}} {{1}}

  • Вместо {{0}} будет подставлено значение, которое пытались установить в свойстве.
  • Вместо {{1}} будет подставлен текст ошибки из скрипта валидации
  • select – выпадающий список из массивов строковых значений

Заголовок – задать заголовок свойства, который будет отображаться в веб-интерфейсах Системы при просмотре свойств соответствующих объектов.

Заполнитель – задать подсказку-плэйсхолдер, которая будет отображена в поле данного свойства у объектов до ввода значения.

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

Тип источника данных – выбрать источник возможных значений для свойства:

  • Скрипт – требуется в поле "Скрипт" выбрать один из скриптов получения объектов, написанных в разделе "Настройка процессов" → "Скрипты" веб-интерфейса администратора Avanpost IDM. 
  • Статический список – требуется задать все значения списка вручную. Для добавления значения в список необходимо:
    1. Нажать .
    2. Указать в поле "Значение" именование, которое будет использоваться для данного значения этого свойства при разработке скриптов и бизнес-процессов.
    3. Указать в поле "Отображаемое значение" текстовое значение, которое будет отображаться в веб-интерфейсах Системы при управлении объектами, обладающими данным свойством
Boolean – логический тип свойства
  • Checkbox – чекбокс (флажок)
Заголовок – задать заголовок свойства, который будет отображаться в веб-интерфейсах Системы при просмотре свойств соответствующих объектов
  • Select – выпадающий список со значениями: Да/ Нет
Заголовок – задать заголовок свойства, который будет отображаться в веб-интерфейсах Системы при просмотре свойств соответствующих объектов
Date – тип свойства дата в формате ДД.ММ.ГГ

Заголовок – задать заголовок свойства, который будет отображаться в веб-интерфейсах Системы при просмотре свойств соответствующих объектов.

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

DateTime – тип свойства дата и время в формате
ДД.ММ.ГГ, ЧЧ:ММ

Заголовок – задать заголовок свойства, который будет отображаться в веб-интерфейсах Системы при просмотре свойств соответствующих объектов.

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

File – файловый тип свойства

Заголовок – задать заголовок свойства, который будет отображаться в веб-интерфейсах Системы при просмотре свойств соответствующих объектов.

Чекбокс "Несколько файлов" – включает возможность загрузки нескольких файлов

Integer

Целочисленный тип свойства

  • input – целочисленные значения

Заголовок – задать заголовок свойства, который будет отображаться в веб-интерфейсах Системы при просмотре свойств соответствующих объектов.

Заполнитель – задать подсказку-плэйсхолдер, которая будет отображена в поле данного свойства у объектов до ввода значения.

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

Добавление нового валидатора – выбрать из выпадающего списка один из вариантов для добавления проверки (можно добавить более одного валидатора, выбирая их в списке поочередно):

  1. "Required" – стандартная проверка на заполнение свойства, чтобы свойство стало обязательным для заполнения.
  2. "Script" – нестандартный скрипт валидации, написанный в разделе "Настройка процессов" → "Скрипты" веб-интерфейса администратора Avanpost IDM.
    1. Скрипт – выбрать из выпадающего списка требуемый скрипт.
  3. "Max" – проверка, что значение свойства не превышает заданного в валидаторе значения.
    1. Значение – указать максимальное значение для свойства.
  4. "Min" – проверка, что значение свойства не меньше заданного в валидаторе значения.
    1. Значение – указать минимальное значение для свойства.

Сообщение об ошибке – указать для каждого добавленного валидатора сообщение об ошибке, которое будет выводить Система в случае несоответствия значения свойства заданным в валидаторе критериям. Например, "Это поле обязательно для заполнения".

При указании сообщения об ошибке можно воспользоваться шаблоном:

Ошибка валидации: {{0}} {{1}}

  • Вместо {{0}} будет подставлено значение, которое пытались установить в свойстве.
  • Вместо {{1}} будет подставлен текст ошибки из скрипта валидации
  • select – выпадающий список из целочисленных значений

Заголовок – задать заголовок свойства, который будет отображаться в веб-интерфейсах Системы при просмотре свойств соответствующих объектов.

Заполнитель – задать подсказку-плэйсхолдер, которая будет отображена в поле данного свойства у объектов до ввода значения.

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

Тип источника данных – выбрать источник возможных значений для свойства:

  • Скрипт – требуется в поле "Скрипт" выбрать один из скриптов получения объектов, написанных в разделе "Настройка процессов"→"Скрипты" веб-интерфейса администратора Avanpost IDM.
  • Статический список – требуется задать все значения списка вручную. Для добавления значения в список необходимо:
    1. Нажать .
    2. Указать в поле "Значение" именование, которое будет использоваться для данного значения этого свойства при разработке скриптов и бизнес-процессов.
    3. Указать в поле "Отображаемое значение" целочисленное значение, которое будет отображаться в веб-интерфейсах Системы при управлении объектами, обладающими данным свойством

String

Строковый тип свойства 


 

  • input – текстовые значения одной строкой, скрипты

Заголовок – задать заголовок свойства, который будет отображаться в веб-интерфейсах Системы при просмотре свойств соответствующих объектов.

Заполнитель – задать подсказку-плэйсхолдер, которая будет отображена в поле данного свойства у объектов до ввода значения.

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

Формат – выбрать один из вариантов формата из выпадающего списка:

  • "text" – для хранения строки текста;
  • "json" – для хранения представлений в формате JSON;
  • "javascript" – для хранения кода javascript

Добавление нового валидатора – выбрать из выпадающего списка один из вариантов для добавления проверки (можно добавить более одного валидатора, выбирая их в списке поочередно):

  1. "Required" – стандартная проверка на заполнение свойства, чтобы свойство стало обязательным для заполнения.
  2. "Script" – нестандартный скрипт валидации, написанный в разделе "Настройка процессов" → "Скрипты" веб-интерфейса администратора Avanpost IDM.
    1. Скрипт – выбрать из выпадающего списка требуемый скрипт.
  3. "IsEmail" – проверка, является ли значение свойства e-mail адресом.
  4. "Pattern" – проверка соответствия значения свойства заданному шаблону.
    1. Шаблон – указать регулярное выражение, которому должно будет соответствовать значение свойства.
    2. Без учета регистра – отметить чекбокс, если требуется не проверять регистр в значении свойства.
  5. "MinLength" – проверка, что длина значения свойства не меньше заданного количества символов.
    1. Значение – указать минимальное количество символов для значения.
  6. "MaxLength" – проверка, что длина значения свойства не больше заданного количества символов.
    1. Значение – указать максимальное количество символов для значения.
  7. "EndsWith" – проверка, что значение свойства заканчивается заданным набором символов.
    1. Шаблон – указать набор символов, которым должно заканчиваться значение свойства.
    2. Без учета регистра – отметить чекбокс, если требуется не проверять регистр в значении свойства.
  8. "StartsWith" – проверка, что значение свойства начинается заданным набором символов.
    1. Шаблон – указать набор символов, которым должно начинаться значение свойства.
    2. Без учета регистра – отметить чекбокс, если требуется не проверять регистр в значении свойства.
  9. "NotEmpty" – проверка, что значение поля не пустое.

Сообщение об ошибке – указать для каждого добавленного валидатора сообщение об ошибке, которое будет выводить Система в случае несоответствия значения свойства заданным в валидаторе критериям. Например, "Это поле обязательно для заполнения".

При указании сообщения об ошибке можно воспользоваться шаблоном:

Ошибка валидации: {{0}} {{1}}

  • Вместо {{0}} будет подставлено значение, которое пытались установить в свойстве.
  • Вместо {{1}} будет подставлен текст ошибки из скрипта валидации
  • select – выпадающий список из текстовых значений

Заголовок – задать заголовок свойства, который будет отображаться в веб-интерфейсах Системы при просмотре свойств соответствующих объектов.

Заполнитель – задать подсказку-плэйсхолдер, которая будет отображена в поле данного свойства у объектов до ввода значения.

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

Тип источника данных – выбрать источник возможных значений для свойства:

  • Скрипт – требуется в поле "Скрипт" выбрать один из скриптов получения объектов, написанных в разделе "Настройка процессов"→"Скрипты" веб-интерфейса администратора Avanpost IDM.
  • Статический список – требуется задать все значения списка вручную. Для добавления значения в список необходимо:
    1. Нажать .
    2. Указать в поле "Значение" именование, которое будет использоваться для данного значения этого свойства при разработке скриптов и бизнес-процессов.
    3. Указать в поле "Отображаемое значение" текстовое значение, которое будет отображаться в веб-интерфейсах Системы при управлении объектами, обладающими данным свойством
  • text – текстовые значения с множеством строк

Заголовок – задать заголовок свойства, который будет отображаться в веб-интерфейсах Системы при просмотре свойств соответствующих объектов.

Заполнитель – задать подсказку-плэйсхолдер, которая будет отображена в поле данного свойства у объектов до ввода значения.

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

Количество строк ввода – задать количество строк для текстового поля данного свойства

Time – тип свойства "Время"

Заголовок – задать заголовок свойства, который будет отображаться в веб-интерфейсах Системы при просмотре свойств соответствующих объектов.

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

Добавление нового валидатора – выбрать из выпадающего списка один из вариантов для добавления проверки (можно добавить более одного валидатора, выбирая их в списке поочередно):

  1. "Required" – стандартная проверка на заполнение свойства, чтобы свойство стало обязательным для заполнения.
  2. "Script" – нестандартный скрипт валидации, написанный в разделе "Настройка процессов" → "Скрипты" веб-интерфейса администратора Avanpost IDM.
    1. Скрипт – выбрать из выпадающего списка требуемый скрипт.

Сообщение об ошибке – указать для каждого добавленного валидатора сообщение об ошибке, которое будет выводить Система в случае несоответствия значения свойства заданным в валидаторе критериям. Например, "Это поле обязательно для заполнения".

При указании сообщения об ошибке можно воспользоваться шаблоном:

Ошибка валидации: {{0}} {{1}}

  • Вместо {{0}} будет подставлено значение, которое пытались установить в свойстве.
  • Вместо {{1}} будет подставлен текст ошибки из скрипта валидации

Uri – тип свойства, представляющий собой ссылку на файл

Заголовок – задать заголовок свойства, который будет отображаться в веб-интерфейсах Системы при просмотре свойств соответствующих объектов.

Заполнитель – задать подсказку-плэйсхолдер, которая будет отображена в поле данного свойства у объектов до ввода значения.

Подсказка – задать текстовую подсказку для заполнения значений данного свойства у объектов, которым оно будет присвоено. (например, "Введите ссылку на файл в хранилище или файловом ресурсе")

Разрешенные схемы – выбрать URI-схемы, которые будут разрешены для свойства. 

По умолчанию выставлены: "http", "https".

Также для добавления  доступны:

  • about;
  • data;
  • feed;
  • file;
  • ftp;
  • git;
  • imap;
  • mailto;
  • news;
  • pop;
  • rsync;
  • sftp;
  • ssh;
  • tel;
  • urn.

Как открывать ссылку – выбрать один из вариантов, как будет открываться заданная в качестве значения свойства ссылка:

  • В новой вкладке;
  • В текущей вкладке;
  • В новом окне

2. Редактирование свойства

Для изменения свойства необходимо:

  1. В строке нужного свойства нажать и выбрать "Редактировать".
  2. Внести изменения в карточку выбранного свойства.
  3. Нажать .


Рисунок – Редактирование свойства

3. Удаление свойства

Для удаления свойства необходимо:

  1. В строке нужного свойства нажать и выбрать "Удалить".
  2. Во всплывающем окне отметить при необходимости чекбокс "Удалить все свойства данного типа". (Если данное свойство есть у хотя бы одного объекта, то для его удаления требуется удалить все свойства данного типа у объектов.)
  3. Подтвердить удаление.


Рисунок – Удаление свойства

Обсуждение