Атрибут типа "Элемент справочника"

Признак, управляющий отображением названия атрибута в интерфейсе.

• флажок снят — название атрибута отображается.

• флажок установлен:

  В интерфейсе оператора:

  • В контентах "Параметры объекта", "Параметры связанного объекта", блок "Подробнее" в "Комментарии": отображается значение атрибута, если оно заполнено, и пользовательская кнопка, если она настроена для атрибута.

    Если значение атрибута не заполнено, то атрибут не отображается и пустого места под атрибут не остается.

  • В контенте "Параметры на форме" и других формах отображается только поле ввода значения. Если атрибут обязательный, то вместо заголовка отображается звездочка обязательности.

  • В контентах со списками, включая контент "Иерархическое дерево", название атрибута не отображается в названии колонки списка.

    Название атрибута отображается на форме настройки полей сложного списка и формах настройки фильтрации и сортировки списка.

  • На форме расширенного поиска (если атрибут выведен на нее) название отображается.

  В интерфейсе администратора название отображается серым цветом в контентах на вкладке "Карточка объекта", "Форма добавления", "Форма редактирования" и на форме просмотра настроек атрибута

Идентификатор атрибута в системе.

Код должен быть уникален в рамках типа объектов, без учета регистра. Код может содержать от 1 до 14 символов, должен состоять только из символов латинского алфавита и цифр, начинаться с символа

Вычислимый

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

Устанавливается только на форме добавления атрибута.

• Флажок установлен — значение атрибута автоматически вычисляется по определенному алгоритму, указанному в скрипте.

  Каждый раз при обращении к атрибуту в интерфейсе оператора происходит вычисление скрипта и формирование значения. При невозможности корректного вычисления значения атрибута по скрипту, сообщение об ошибке записывается в лог. Вычислимый атрибут при этом остается пуст или заполняется значением по умолчанию, если оно задано.

• Флажок снят — значение атрибута устанавливается вручную.

Значение вычислимого атрибута:

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

Во вложенные типы объектов наследуется значение параметра "Вычислимый" вместе со значением параметра "Скрипт"

Скрипт для вычисления значения атрибута

• Скрипт вычисления значения атрибута с признаком "Вычислимый"
• Добавление и редактирование скрипта. Компонент работы со скриптом

В скрипте для вычисления значения атрибута не допустимо обращаться к внешнему источнику. Для взаимодействия с внешними системами необходимо использовать действие по событию типа "Скрипт" с признаком "Взаимодействие с внешней системой" или/и задачу планировщика.

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

Определяемый по таблице соответствий

Признак, определяющий вычисление значения атрибута по таблице соответствий.

• Флажок установлен — значение атрибута автоматически вычисляется по таблице соответствий и не редактируется в интерфейсе оператора.

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

• Флажок снят — значение атрибута редактируется в интерфейсе оператора.

Таблица соответствий, по которой вычисляется значение атрибута.

При добавлении атрибута в поле установлено значение [не указано].

При редактировании атрибута в поле выбирается таблица соответствий. Для выбора доступны таблицы соответствий, у которых данный атрибут указан как определяемый

Редактируемый

Признак, определяющий редактируемость атрибута в интерфейсе оператора.

• Флажок установлен — значение атрибута можно изменять на формах добавления и редактирования объекта в интерфейсе оператора.
• Флажок снят — значение атрибута не редактируется в интерфейсе оператора.

Редактируемость атрибута не влияет на выполнение специальных действий, например, "Смена ответственного", "Смена типа".

Для системных атрибутов значение параметра "Редактируемый" можно изменить, только если системное значение параметра "Редактируемый" = "Да".

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

Редактируемый в списках

Признак, определяющий редактируемость атрибута в списках объектов в интерфейсе оператора.

• Флажок установлен — значение атрибута можно изменять в списке объектов в интерфейсе оператора. При редактировании значения атрибута в ячейке списка будет использоваться представление для редактирования, указанное в параметре "Представление для редактирования".
• Флажок снят (по умолчанию) — значение атрибута в списке объектов не изменяется.

Обязательный

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

• Флажок установлен — значение атрибута является обязательным для заполнения в системе.
• Флажок снят — значение не обязательно для заполнения.

Проверка заполнения значения атрибута выполняется на следующих формах:

• форма добавления
• форма редактирования
• форма быстрого добавления и редактирования
• форма массового редактирования
• форма смены ответственного
• форма смены статуса
• форма смены типа

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

Обязательность системного атрибута можно изменить, если установлен флажок "Редактируемый" и системное значение параметра "Обязательный" = "нет". Пользовательские атрибуты по умолчанию являются необязательными.

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

Обязательный для заполнения в интерфейсе

Признак, определяющий обязательность заполнения значения атрибута в интерфейсе оператора.

• Флажок установлен —значение атрибута является обязательным для заполнения на формах добавления и редактирования в интерфейсе оператора, если атрибут выведен на формы.
• Флажок снят — значение не обязательно для заполнения.

Проверка заполнения значения атрибута выполняется на следующих формах:

• форма добавления
• форма редактирования
• форма редактирования параметров контента
• форма быстрого добавления и редактирования
• форма массового редактирования
• форма смены ответственного
• форма смены статуса

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

  Атрибут, обязательный для заполнения в интерфейсе, не выводится на системную форму смены типа.

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

Уникальный

Признак уникальности значения атрибута.

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

Уникальность системного атрибута можно изменить, если установлен флажок "Редактируемый" и системное значение параметра "Уникальный" = "нет".

Уникальность, установленная в классе объектов, наследуется во все вложенные в него типы и не может быть изменена в типе. Настройка наследования параметров атрибутов в типах не влияет на наследование уникальности.

Справочник

Справочник, набор элементов которого может являться значением данного атрибута

Фильтрация значений при редактировании

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

• Флажок установлен — при редактировании атрибута в интерфейсе оператора список возможных значений визуально ограничен:

  • в поле выбора в виде раскрывающегося списка отображаются только допустимые объекты;
  • в поле выбора в виде дерева отображаются допустимые объекты и их вышестоящие по иерархии элементы: папки справочников, каталоги и родительские объекты, для выбора доступны только допустимые объекты.

  Условия фильтрации списка значений атрибута задаются в скрипте.

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

• Флажок снят — ограничения возможных значений атрибута нет.

Поле ввода скрипта фильтрации значений при редактировании

Скрипт возвращает список значений, доступных для выбора в качестве значения атрибута.

• Скрипт фильтрации значений атрибута при редактировании
• Добавление и редактирование скрипта. Компонент работы со скриптом

Вычисление значения при редактировании

Признак, определяющий автоматическое заполнение значения атрибута на формах добавления и редактирования в интерфейсе оператора.

• Флажок установлен —значение атрибута автоматически заполняется/перерасчитывается на формах добавления и редактирования объекта. Для расчета значения атрибута используется скрипт.
• Флажок снят — значение заполняется вручную

Поле ввода скрипта для вычисления значения атрибута

Скрипт возвращает значение атрибута.

• Скрипт вычисления значения атрибута при редактировании
• Добавление и редактирование скрипта. Компонент работы со скриптом

Представление для отображения

Указывает, как выглядит атрибут в интерфейсе оператора.

• Выделение названия цветом — отображается название элемента справочника в рамке, залитое соответствующим цветом.

• Изображение — отображается изображение элемента справочника "Иконки для элементов управления". Если изображение не задано, то отображается белый кружок с серым контуром и всплывающей подсказкой: "Изображение элемента справочника не задано".

  Изображение хранится в справочнике в размере: ширина до 128 пикселей, высота до 64 пикселей. В контентах типа "Параметры объекта" и "Параметры связанного объекта" изображение отображается в том же размере, в котором хранится в справочнике. При отображении в списках объектов изображение пропорционально масштабируется: ширина до 50 пикселей, высота до 24 пикселей.

• Индикатор цвета — отображается индикатор цвета элемента в виде кружка заданного цвета.

  Если цвет не задан, то отображается белый кружок с серым контуром и всплывающей подсказкой: "Цвет элемента справочника не задан".

• Название — отображается название элемента справочника.
• Название и изображение — отображается изображение и название элемента, изображение располагается перед названием элемента. Если элементу не присвоено изображение, отображается только название элемента.
• Название и индикатор цвета — отображается индикатор цвета и название, индикатор располагается перед названием элемента. Если цвет не задан, то отображается только название элемента.

Скрывать при отображении, если не заполнен

Признак, определяющий отображение атрибута, у которого не заполнено значение, на карточке объекта.

• Флажок установлен — если значение атрибута не указано, то атрибут не отображается в контентах "Параметры объекта", "Параметры связанного объекта", "Информация о пользователе".
• Флажок снят — атрибут всегда отображается.

Значение параметра не влияет на отображение атрибута на формах добавления и редактирования

Представление для редактирования

Вид поля выбора значения атрибута на формах добавления и редактирования объекта и вид поля значения атрибута по умолчанию на текущей форме.

• "Дерево выбора" — для выбора одного значения.
• "Список элементов справочника" — для выбора одного значения.

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

Скрывать при редактировании, если нет значений для выбора

Признак, определяющий отображение на формах атрибута, у которых нет значений для выбора.

• Флажок установлен — если у атрибута нет доступных для выбора значений, то название и поле выбора значений данного атрибута не отображается на форме добавления и форме редактирования объекта в контентах "Параметры на форме", "Выбор родительского объекта", форме смены статуса, форме смены привязки, форме смены типа объекта. Значение атрибута на форме считается неуказанным, т.е. пустым.
• Флажок снят — атрибут всегда отображается на форме добавления объекта и формах редактирования.

Описание

Подробное описание атрибута и рекомендации по его использованию, отображаемые в интерфейсе оператора.

Для ввода описания используется поле ввода "Текст в формате RTF".

Отображение описания атрибута в интерфейсе оператора настраивается при настройке контента, в котором отображается атрибут, при помощи параметра "Показывать описание атрибутов. Возможные значения параметра: всплывающая подсказка или информационное поле в контенте.

• Контент "Параметры объекта"
• Контент "Параметры связанного объекта"
• Контент "Параметры на форме"

Отображение описания атрибута в интерфейсе оператора настраивается при настройке пользовательских форм:

• Форма смены типа объекта
• Форма смены ответственного
• Форма быстрого добавления и редактирования
• Форма массового редактирования

Описание атрибута может применяться в качестве контекстной справки по каждому атрибуту.

Если значение параметра не указано, то описание атрибута в интерфейсе оператора не отображается.

Пример. При реализации процесса проведения опросов, в атрибутах класса "Анкета" (questionary) описание атрибутов служит для расширенной формулировки вопросов.

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

Сортировка списка элементов справочника при редактировании значения атрибута:

• По коду (по умолчанию) — сортировка элементов списка в рамках одного уровня иерархии выполняется лексикографически по коду элемента.
• По названию — сортировка элементов списка в рамках одного уровня иерархии выполняется лексикографически по названию элемента.

Значение по умолчанию

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

Значение по умолчанию не устанавливается для системно нередактируемых атрибутов.

Виды значения по умолчанию: фиксированное или вычислимое.

Фиксированное значение по умолчанию (флажок "Вычислимое" снят):

• указывается в поле "Значение", вид поля соответствует выбранному для атрибута представлению для редактирования;
• отображается в списке атрибутов (столбец "По умолчанию") в выбранном для атрибута представлении для отображения;
• отображается в контентах на карточке объекта или формах добавления и редактирования объекта (для пользовательских атрибутов).

Вычислимое значение по умолчанию (флажок "Вычислимое" установлен):

• значение по умолчанию указывается в поле "Скрипт":

  • Скрипт вычисления значения по умолчанию для атрибута
  • Добавление и редактирование скрипта. Компонент работы со скриптом
• значение по умолчанию отображается в списке атрибутов (столбец "По умолчанию") в виде строки: "Скрипт".

Правила использования значения по умолчанию:

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

• Если на форме добавления объекта изменяется тип объекта, то значение атрибута заменяется на значение по умолчанию, при выполнении следующих условий:

  • для атрибута в выбранном типе указано значение по умолчанию;
  • до этого момента пользователь не изменял значение по умолчанию вручную на форме добавления.
• Если параметр "Значение по умолчанию" устанавливается для существующего атрибута, то значение данного атрибута у существующих объектов не меняется.
• Если параметр "Значение по умолчанию" устанавливается для нового атрибута, то во всех ранее созданных объектах значение атрибута остается пустым.

Особенность установки значения по умолчанию при применении скрипта фильтрации: если в результате выполнения скрипта фильтрации значение по умолчание не содержится в отфильтрованном списке, то значение по умолчанию не устанавливается и поле атрибута остается не заполненным