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

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

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

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

  • Если в коллекции значений атрибута есть одинаковые, то они отображаются как одно значение.

    Например, с объектом связаны 3 сотрудника, из них двое с фамилией Иванов и один Петров. Значение атрибута будет: "Иванов, Петров".

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

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

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

    • как часть составного атрибута;
    • в качестве атрибута связи в контентах "Список связанных объектов" и "Параметры связанного объекта";
    • в качестве прямой ссылки для атрибута типа "Обратная ссылка";
    • в качестве параметра пользовательского действия по событию;
    • в качестве определяемого и определяющего атрибута в таблице соответствий;
    • в настройках счетчика времени;
    • в настройках ограничения при фильтрации в списках.
  • Поиск по атрибуту не производится, в том числе с помощью методов api.utils для поиска объектов.
  • Атрибут не участвует в конфигурации импорта.
  • Значение атрибута не хранится в базе данных и не редактируется скриптовыми методами, 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) описание атрибутов служит для расширенной формулировки вопросов.

  • Метки

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