Атрибут типа "Атрибут связанного объекта"

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

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

Ограничения и особенности работы с атрибутом типа "Атрибут связанного объекта":

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

  • Атрибут не доступен в настройках системы:

    • как часть составного атрибута;
    • в качестве атрибута связи в контентах "Список связанных объектов" и "Параметры связанного объекта";
    • в качестве прямой ссылки для атрибута типа "Обратная ссылка";
    • в качестве параметра пользовательского действия по событию;
    • в качестве определяемого и определяющего атрибута в таблице соответствий;
    • в настройках счетчика времени;
    • в настройках ограничения при фильтрации в списках.
  • Поиск по атрибуту не производится.
  • Атрибут не участвует в конфигурации импорта.
  • Значение атрибута не хранится в базе данных и не редактируется скриптовыми методами, REST и SOAP.

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

    Количество объектов в возвращаемой коллекции всегда не больше 21. Это связано с оптимизацией получения значения, поэтому в скриптах рекомендуется получать значение по цепочке атрибутов.

    Чтобы получить полный список значений, необходимо получить его значение через цепочку атрибутов:

    • через ссылку на связанный объект получаем значение атрибута;
    • обращаемся напрямую к значению атрибута в связанном объекте и получаем массив значений.

    Пример скрипта:

    def linkedObjects = subject.linkToAnother // получаем из атрибута linkToAnother текущего объекта массив, состоящий из ссылок на связанные объекты

    def valueOfRealtedObjects = linkedObjects*.linkToElement // формируем из ранее полученного из linkToAnother массива, массив значений из интересующих атрибутов

    либо одной строкой:

    subject.linkToAnother*.linkToElement

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

    Если для формирования связи используется атрибут типа "Набор ссылок на бизнес-объекты", то критерии фильтрации подчиняются правилу "хотя бы в одном из связанных":

    • содержит = значение содержится хотя бы в одном из связанных объектов;
    • не содержит = значение не содержится хотя бы в одном из связанных объектов;
    • с ... по, за последние 'n' дней, сегодня (критерии для атрибутов типа "Дата/время") в результаты фильтрации попадают те объекты, в которых хотя бы одно значение атрибута связанного объекта удовлетворяет этому условию;
    • равен, не равен, больше, больше, меньше (критерии для атрибутов типа "Временной интервал", "Целое число") в результаты фильтрации попадают те объекты, в которых хотя бы одно значение атрибута связанного объекта удовлетворяет этому условию;
    • содержит да, содержит нет (критерии для логического атрибута) в результаты фильтрации попадают те объекты, в которых хотя бы одно значение атрибута связанного объекта удовлетворяет этому условию.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  
Код

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

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

  

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

Флажок снят и недоступен для изменения. Значения атрибутов данного типа НЕ редактируются

 

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

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

 

Уникальный

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

 
Атрибут связи

Класс связанного объекта.

Для выбора доступны все ссылочные атрибуты класса, для которого добавляется атрибут (тип атрибутов "Ссылка на бизнес-объект", "Набор ссылок на бизнес-объекты", "Обратная ссылка", агрегируемые атрибуты в рамках агрегирующего атрибута) и классов связанных с ним, кроме вычислимых.

Глубина цепочки связей в дереве выбора ограничена 3 уровнями.

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

Отображается класс объектов, определенный по атрибуту связи

 
Атрибут связанного класса

Атрибут связанного класса, значение которого будет отображаться в значении атрибута.

Для выбора доступны атрибуты связанного класса, с учетом ограничений по типам (если у ссылочного атрибута, выбранного как "Атрибут связи", есть ограничения по типам).

Для агрегирующего атрибута можно выбрать как агрегируемые атрибуты, так и сам агрегирующий атрибут.

Для выбора не доступны:

  • для всех классов: вычислимые атрибуты, атрибуты типа "Атрибут связанного объекта" и атрибут "Тип объекта" (metaClass).
  • для класса "Сотрудник" (employee): атрибуты "Лицензия" (license), Группы пользователей сотрудника, отдела, команд" (all_Group)
  

Показывать значение атрибута

Значение атрибута связанного класса с учетом иерархии

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

  • Связанного объекта (по умолчанию);
  • Родителя связанного объекта;
  • Родителя 2-ого уровня связанного объекта и так далее до 10 уровня включительно;
  • Родителя верхнего уровня.

Возможные значения, если "Атрибут связанного класса" = "Родитель" (parent):

  • Родителя связанного объекта (по умолчанию);
  • Родителя 2-ого уровня связанного объекта и так далее до 10 уровня включительно;
  • Родителя верхнего уровня

Параметр отображается, если в цепочке атрибута связи нет атрибута типа "Набор ссылок на бизнес-объекты" и класс связанного объекта вложен в объект своего класса

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

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

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

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

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

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

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

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

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

Если выбран атрибут связанного класса типа "Ссылка на бизнес-объекты", значение атрибута связанного объекта содержит значение атрибута связанного объекта.

Если выбран атрибут связанного класса типа "Набор ссылок на бизнес-объекты", то значение атрибута связанного объекта содержит коллекцию значений атрибута всех связанных объектов.

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

 

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

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

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

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

Разделять по разрядам

Определяет разбиение значения атрибута по разрядам:

  • Флажок снят (по умолчанию) — разбиения по разрядам нет.

  • Флажок установлен — при вводе значения вручную и при вставке значения (Ctrl+V) целая часть числа разделяется по разрядам, между разрядами ставится пробел.

    На карточках и в списках значение атрибута отображается с разрядами (в том числе значения, введенные до установки параметра)

Отображается, если выбран атрибут связанного объекта типа "Целое число" или "Вещественное число"

Ограничение на ввод десятичных знаков

Определяет наличие ограничения на ввод десятичных знаков. В поле можно ввести только число от 1 до 10.

Если число десятичных знаков указано, то:

  • В поле ввода значения атрибута отображается маска ввода (например, 0.000), где количество нолей после запятой равно заданному числу десятичных знаков. При попытке вставить (Ctrl+V) значение неподходящее по маске, часть значения обрезается.

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

    Для ранее введенных значений с большим количеством знаков после запятой при отображении используется математическое округление до указанных в параметре единиц (значение в базе данных не изменяется). При редактировании отображаются все знаки и выводится сообщение "Превышено количество десятичных знаков".

Если число десятичных знаков не указано, то маска ввода отсутствует и ограничений на ввод значения нет

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

Описание

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

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

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

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

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

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

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

 

Метки

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

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