Атрибут типа "Атрибут связанного объекта"
Описание и особенности атрибута
Атрибут типа "Атрибут связанного объекта" предназначен для просмотра в списках и на карточках различных атрибутов связанного объекта.
Ограничения и особенности работы с атрибутом типа "Атрибут связанного объекта":
- При перевыборе значения атрибута связи на формах добавления и редактирования значение атрибута связанного объекта не обновляется.
- В атрибуте связанного объекта не отображаются изменения, сделанные через быстрые формы добавления и редактирования.
-
Атрибут не доступен в настройках системы:
- как часть составного атрибута;
- в качестве атрибута связи в контентах "Список связанных объектов" и "Параметры связанного объекта";
- в качестве прямой ссылки для атрибута типа "Обратная ссылка";
- в качестве параметра пользовательского действия по событию;
- в качестве определяемого и определяющего атрибута в таблице соответствий;
- в настройках счетчика времени;
- в настройках ограничения при фильтрации в списках.
- Поиск по атрибуту не производится.
- Атрибут не участвует в конфигурации импорта.
- Значение атрибута не хранится в базе данных и не редактируется скриптовыми методами, REST и SOAP.
-
Атрибут может использоваться в скриптах вычисления значения при редактировании, фильтрации при редактировании, вычислимом значении по умолчанию. При получении значения атрибута, для которого в параметре "Атрибут связи" есть хотя бы один атрибут типа "Набор ссылок на бизнес-объекты, всегда возвращается коллекция.
Количество объектов в возвращаемой коллекции всегда не больше 21. Это связано с оптимизацией получения значения, поэтому в скриптах рекомендуется получать значение по цепочке атрибутов.
Чтобы получить полный список значений, необходимо получить его значение через цепочку атрибутов:
- через ссылку на связанный объект получаем значение атрибута;
- обращаемся напрямую к значению атрибута в связанном объекте и получаем массив значений.
Пример скрипта:
def linkedObjects = subject.linkToAnother // получаем из атрибута linkToAnother текущего объекта массив, состоящий из ссылок на связанные объекты
def valueOfRealtedObjects = linkedObjects*.linkToElement // формируем из ранее полученного из linkToAnother массива, массив значений из интересующих атрибутов
либо одной строкой:
subject.linkToAnother*.linkToElement
-
Значение атрибута может использоваться для фильтрации объектов в сложных списках. Критерии фильтрации определяются типом атрибута связанного объекта.
Если для формирования связи используется атрибут типа "Набор ссылок на бизнес-объекты", то критерии фильтрации подчиняются правилу "хотя бы в одном из связанных":
- содержит = значение содержится хотя бы в одном из связанных объектов;
- не содержит = значение не содержится хотя бы в одном из связанных объектов;
- с ... по, за последние 'n' дней, сегодня (критерии для атрибутов типа "Дата/время") в результаты фильтрации попадают те объекты, в которых хотя бы одно значение атрибута связанного объекта удовлетворяет этому условию;
- равен, не равен, больше, больше, меньше (критерии для атрибутов типа "Временной интервал", "Целое число") в результаты фильтрации попадают те объекты, в которых хотя бы одно значение атрибута связанного объекта удовлетворяет этому условию;
- содержит да, содержит нет (критерии для логического атрибута) в результаты фильтрации попадают те объекты, в которых хотя бы одно значение атрибута связанного объекта удовлетворяет этому условию.
Настройки атрибута
Параметры атрибута заполняются при добавлении и редактировании атрибута.
Добавление атрибута в классе или типе объектов приводит к повышенной нагрузке системы и занимает продолжительное время. Добавление атрибута рекомендуется выполнять во время минимальной нагрузки на систему или во время технологических блокировок.
Параметры атрибута
Параметры атрибута заполняются при добавлении и редактировании атрибута.
Название параметра | Описание и возможные значения | Зависимость от других параметров |
---|---|---|
Название | Название атрибута на карточках объектов и формах, на которых размещен данный атрибут | |
Скрывать название атрибута |
Признак, управляющий отображением названия атрибута в интерфейсе.
|
|
Код |
Идентификатор атрибута в системе. Код должен быть уникален в рамках типа объектов, без учета регистра. Код может содержать от 1 до 14 символов, должен состоять только из символов латинского алфавита и цифр, начинаться с символа |
|
Редактируемый |
Флажок снят и недоступен для изменения. Значения атрибутов данного типа НЕ редактируются |
|
Обязательный |
Флажок снят и недоступен для изменения. Значения атрибутов данного типа необязательны для заполнения |
|
Уникальный |
Флажок снят и недоступен для изменения. Значения атрибутов не уникальны. |
|
Атрибут связи |
Класс связанного объекта. Для выбора доступны все ссылочные атрибуты класса, для которого добавляется атрибут (тип атрибутов "Ссылка на бизнес-объект", "Набор ссылок на бизнес-объекты", "Обратная ссылка", агрегируемые атрибуты в рамках агрегирующего атрибута) и классов связанных с ним, кроме вычислимых. Глубина цепочки связей в дереве выбора ограничена 3 уровнями. |
|
Класс объекта |
Отображается класс объектов, определенный по атрибуту связи |
|
Атрибут связанного класса |
Атрибут связанного класса, значение которого будет отображаться в значении атрибута. Для выбора доступны атрибуты связанного класса, с учетом ограничений по типам (если у ссылочного атрибута, выбранного как "Атрибут связи", есть ограничения по типам). Для агрегирующего атрибута можно выбрать как агрегируемые атрибуты, так и сам агрегирующий атрибут. Для выбора не доступны:
|
|
Показывать значение атрибута |
Значение атрибута связанного класса с учетом иерархии Возможные значения:
Возможные значения, если "Атрибут связанного класса" = "Родитель" (parent):
|
Параметр отображается, если в цепочке атрибута связи нет атрибута типа "Набор ссылок на бизнес-объекты" и класс связанного объекта вложен в объект своего класса |
Скрывать архивные объекты |
Признак, определяющий, будут ли скрываться архивные объекты в значении атрибута:
Параметр влияет на отображение атрибута в контентах "Параметры объекта", "Параметры связанного объекта", "Параметры на форме" |
Отображается, если в конфигурационном файле dbaccess.properties включен параметр ru.naumen.core.server.attr.enableHideArchivedObjects По умолчанию поле не отображается |
Представление для отображения |
Указывает, как выглядит атрибут в интерфейсе оператора. Представление определяется типом атрибута связанного класса. Если выбран атрибут связанного класса типа "Ссылка на бизнес-объекты", значение атрибута связанного объекта содержит значение атрибута связанного объекта. Если выбран атрибут связанного класса типа "Набор ссылок на бизнес-объекты", то значение атрибута связанного объекта содержит коллекцию значений атрибута всех связанных объектов. Если выбран атрибут связанного класса типа "Агрегирующий атрибут", то происходит объединение всех элементов и значение атрибута связанного объекта может содержать и команды, и сотрудников, и отделы |
|
Скрывать при отображении, если не заполнен |
Признак, определяющий отображение атрибута, у которого не заполнено значение, на карточке объекта.
Значение параметра не влияет на отображение атрибута на формах добавления и редактирования |
Отображается, если снят флажок "Обязательный" |
Разделять по разрядам |
Определяет разбиение значения атрибута по разрядам:
|
Отображается, если выбран атрибут связанного объекта типа "Целое число" или "Вещественное число" |
Ограничение на ввод десятичных знаков |
Определяет наличие ограничения на ввод десятичных знаков. В поле можно ввести только число от 1 до 10. Если число десятичных знаков указано, то:
Если число десятичных знаков не указано, то маска ввода отсутствует и ограничений на ввод значения нет |
Отображается, если выбран атрибут связанного объекта типа "Вещественное число" |
Описание |
Подробное описание атрибута и рекомендации по его использованию, отображаемые в интерфейсе оператора. Для ввода описания используется поле ввода "Текст в формате RTF". Отображение описания атрибута в интерфейсе оператора (всплывающая подсказка или информационное поле в контенте) настраивается при настройке контента, в котором отображается атрибут (параметр "Показывать описание атрибутов) Отображение описания атрибута в интерфейсе оператора (всплывающая подсказка или информационное поле в контенте) настраивается при настройке пользовательских форм:
Описание атрибута может применяться в качестве контекстной справки по каждому атрибуту. Если значение параметра не указано, то описание атрибута в интерфейсе оператора не отображается. Пример. При реализации процесса проведения опросов, в атрибутах класса "Анкета" (questionary) описание атрибутов служит для расширенной формулировки вопросов |
|
Метки |
Одна или несколько меток, определяющих процессы, в которых используется данный атрибут. Метка устанавливается для пользовательских атрибутов основных классов и типов объектов. Подробное описание работы с метками см. Метки |
|