Атрибут типа "Набор ссылок на бизнес–объекты"

Описание атрибута

Атрибут типа "Набор ссылок на бизнес–объекты" создается в случае необходимости реализации связи "Многие ко многим".

Выбор объекта в качестве значения атрибута означает создание связи между объектами. Удаление значения атрибута — разрыв связи.

Значение атрибута типа "Набор ссылок на бизнес–объекты":

  • Значением атрибута является набор названий связанных объектов (через запятую). Название объекта является ссылкой на карточку соответствующего объекта.
  • В значении атрибута отображается не более 20 объектов. Если предполагаемое количество связанных объектов превышает 20, то для их отображения рекомендуется использовать контент "Список связанных объектов".

Настройки атрибута

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

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

Параметры атрибута

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

Название параметра Описание и возможные значения Зависимость от других параметров
Название Название атрибута на карточках объектов и формах, на которых размещен данный атрибут  

Скрывать название атрибута

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

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

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

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

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

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

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

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

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

 
Код

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

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

Первые 8 символов кода атрибута должны быть уникальны среди данных типов атрибутов.

 

Вычислимый

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

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

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

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

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

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

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

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

 

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

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

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

Отображается, если установлен флажок "Вычислимый"

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

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

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

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

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

 

Правило определения

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

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

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

Отображается, если установлен флажок

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

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

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

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

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

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

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

 

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

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

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

Описание см. Редактирование атрибута в списке объектов

Доступен, если установлен флажок "Редактируемый"

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

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

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

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

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

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

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

 

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

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

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

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

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

Если флажок "Обязательный" установлен, то флажок "Обязательный для заполнения в интерфейсе" снят и недоступен для изменения

Уникальный

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

 

Класс объекта

Класс объекта, с которым будет создана связь.

В параметре "Класс объекта" можно выбрать только классы "Основного класса" (кроме класса "Компания" (root)).

Создать связь с объектами служебных классов нет возможности и поэтому список объектов служебного класса нельзя вывести в контенте "Список связанных объектов"

 

Типы объекта

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

Если атрибут создается в карточке класса, то связь устанавливается между объектами текущего класса любого типа и указанного класса/типа. Например, "Сотрудник" (employee) (тип любой) → "Команда" (team) (тип любой /указанные типы).

Если атрибут создается в карточке типа, то связь устанавливается только между объектами текущего типа и указанного класса. Например, "Сотрудник" (employee) (тип: Сотрудник ТП) → "Команда" (team) (тип любой /указанные типы).

Возможные значения параметра:

  • Ни один — связь не может быть создана ни с одним типом объектов указанного класса. Значение "Ни один" автоматически устанавливается, когда сняты флажки у класса и всех типов.
  • Класс объектов — связь может быть установлена с объектом любого типа данного класса. При установке флажка в классе объектов у всех типов проставляются флажки, недоступные для редактирования. Обходное решение см. Скрипт фильтрации значений и ограничения по типам.

    При снятии флажка в классе флажки у всех типов становятся доступными для редактирования.

  • Тип или типы объектов — связь может быть установлена только с объектами выбранных типов.

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

Изменение параметра "Типы объектов" в атрибуте не прерывает наследование самого атрибута, т.е. при установленном флажке "Наследовать параметры" возможно редактирование дерева "Типы объектов", подробное описание ограничения связи по типам

 

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

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

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

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

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

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

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

 

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

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

Отображается, если установлен флажок "Фильтрация значений при редактировании"

Скрывать архивные объекты

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

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

Параметр влияет на отображение атрибута в контентах "Параметры объекта", "Параметры связанного объекта", "Параметры на форме"

Отображается, если в конфигурационном файле dbaccess.properties включен параметр ru.naumen.core.server.attr.enableHideArchivedObjects (Атрибуты).

По умолчанию поле не отображается

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

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

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

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

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

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

Отображается, если установлен флажок "Вычисление значения при редактировании"

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

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

  • "Набор ссылок на бизнес-объекты" — отображается как список названий объектов выбранных классов (через запятую). Каждое название объекта является ссылкой на карточку соответствующего объекта

 

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

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

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

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

Отображается, если снят флажок "Обязательный"

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

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

  • Ссылка на невложенный класс объектов (параметр "Класс объекта"):

    • "Список выбора" — список выбора одного или нескольких значений атрибута. Особенности работы с представлением в интерфейсе оператора см. Раскрывающийся список.
    • "Список выбора с папками" — список выбора одного или нескольких значений атрибута. В списке отображаются папки каталога класса, на который ссылается атрибут, с иерархией вложенных элементов, см. Каталоги и папки. Особенности работы с представлением в интерфейсе оператора см. Список выбора с папками.
  • Ссылка на класс объектов, вложенный в себя или в другой класс (параметр "Класс объекта"):

    • "Дерево выбора" — дерево выбора одного или нескольких значений атрибута. Особенности работы с представлением в интерфейсе оператора см. Дерево выбора.
    • "Дерево выбора с папками" — дерево выбора одного или нескольких значений атрибута. На первом уровне в дереве отображаются узлы папок каталога класса, на который ссылается атрибут, с иерархией вложенных элементов, см. Каталоги и папки. Особенности работы с представлением в интерфейсе оператора см. Дерево выбора с папками.
    • "Список выбора";
    • "Список выбора с папками".
  • Ссылка на класс объектов, вложенный в другой класс (параметр "Класс объекта"):

    • "Дерево выбора";
    • "Дерево выбора с папками";
    • "Список выбора";
    • "Список выбора с папками";
    • "Поле быстрого выбора" — дерево объектов для выбора одного или нескольких объектов, вложенных в объекты другого класса. Для выбора доступны только вложенные элементы дерева. Класс объектов, выбираемых в поле быстрого выбора, указывается в параметре "Класс объектов". Особенности работы с представлением в интерфейсе оператора см. Поле быстрого выбора.

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

 

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

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

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

Отображается, если установлен флажок "Редактируемый"

Описание

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

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

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

Отображение описания атрибута в интерфейсе оператора (всплывающая подсказка или информационное поле в контенте) настраивается при настройке пользовательских форм:

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

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

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

 

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

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

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

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

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

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

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

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

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

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

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

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

Расширенное редактирование связей

Признак использования формы добавления связи.

Возможные значения:

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

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

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

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

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

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

Отображение значения "Плоский список с полнотекстовым поиском" включается в конфигурационном файле dbaccess.properties

Группа атрибутов в списке

Группа атрибутов, которая определяет набор колонок в списке объектов на форме добавления связи.

Для выбора доступны группы атрибутов класса /типа объектов, с которым устанавливается связь:

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

Отображается, если в параметре "Расширенное редактирование связей" выбрано значение "плоский список"

Редактирование только через расширенную форму

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

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

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

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

Структура

Структура, которая применяется для построения иерархического списка на форме добавления связи.

Подробное описание работы с иерархическими списками см. Иерархическое дерево объектов

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

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

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

Для выбора доступны формы быстрого добавления и редактирования, созданные для класса, в котором определен атрибут, и имеющие общие типы объектов с атрибутом (типы объектов, указанные для формы, совпадают с типами, указанными в параметрах атрибута)

Отсутствует, если в параметре "Класс объектов" выбран "Запрос" (serviceCall)

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

Если форма выбрана, то на любых формах рядом с полем выбора значения данного атрибута отображается ссылка для редактирования объектов, на которые указывает данный атрибут, см. Настройка редактирования объектов на формах (Быстрое редактирование объекта).

Для выбора доступны формы быстрого добавления и редактирования, созданные для класса, в котором определен атрибут, и имеющие общие типы объектов с атрибутом (типы объектов, указанные для формы, совпадают с типами, указанными в параметрах атрибута)

Отсутствует, если в параметре "Класс объектов" выбран "Запрос" (serviceCall)

Метки

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

Подробное описание работы с метками см. Метки