Размещение контента "Список связанных объектов"

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

Контент "Список связанных объектов" доступен для выбора, если у класса/типа объектов есть атрибуты типа "Ссылка на бизнес–объект", "Набор ссылок на бизнес-объекты" или "Обратная ссылка".

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

Список объектов, связанных по атрибуту связи напрямую или через цепочку связанных объектов

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

Название — введите название контента, используемое в системе.
Отображать название:
- флажок установлен — в интерфейсе оператора и в интерфейсе администратора отображаются название контента и иконка или . Нажатие на иконку или название сворачивает или разворачивает содержимое контента;
- флажок снят — в интерфейсе оператора название скрыто, в интерфейсе администратора название отображается серым цветом. Контент отображается только в развернутом виде.
Свернут по умолчанию — отображается, если установлен флажок "Отображать название":
- флажок снят (значение по умолчанию) — при открытии карточки контент будет отображаться в развернутом виде;
- флажок установлен — при открытии карточки контент будет отображаться в свернутом виде — только заголовок и иконка .
Пользователь может изменять состояние контента в интерфейсе оператора.
Код — введите уникальный идентификатор контента, без учета регистра. Значение заполняется автоматически. Выполняется транслитерация названия контента при переводе фокуса с поля "Название". Код можно изменить.

Код может содержать только символы латинского алфавита, цифры и знаки тире.
Вложен в — выберите место размещения контента на карточке или форме.

На карточке объекта для выбора доступны вкладки карточки и вкладки контента "Панель вкладок".

На форме добавления /форме редактирования для выбора доступна сама форма и вкладки контента "Панель вкладок".
Показывать в списке объекты, связанные с иерархией: флажок снят (по умолчанию).
Атрибут — выберите ссылочный атрибут, определяющий класс, объекты которого будут отображаться в списке. Глубина цепочки связей в дереве выбора ограничена 4 уровнями. На первом уровне расположены атрибуты связи текущего класса объектов.

Возможные значения:
- Любой атрибут типа "Набор ссылок на бизнес–объекты" и "Обратная ссылка" класса объектов, на карточке/форме которого размещается контент, и классов, связанных с ним.
- Атрибут типа "Ссылка на бизнес-объект" класса объектов, связанного с классом, на карточке/форме которого размещается контент, или с предыдущим связанным классом по атрибуту типа "Набор ссылок на бизнес–объекты" или "Обратная ссылка".
Вычислимый атрибут типа "Набор ссылок на бизнес-объекты" может быть выбран в контенте "Список связанных объектов" со следующими особенностями:
- атрибут может быть выбран только на первом уровне, в списке будут отображаться только объекты класса, на который ссылается вычислимый атрибут;
- список связанных объектов отображается только в представлении "простой список", в список выводится не более 20 объектов;
- ссылка "добавить связь" отсутствует.
Класс объектов списка — информационное поле, в котором указывается класс объектов, на который указывает ссылочный атрибут. Объекты данного класса будут отображаться в списке.
Типы объектов — типы объектов для отображения в контенте. Выбирается среди типов выбранного класса.

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

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

Возможные значения: группы атрибутов класса объектов, указанного в информационном поле "Класс объектов":
- если выбран класс/тип, то в списке отображаются группы атрибутов класса/типа;
- если выбрано несколько типов, то в списке отображаются группы атрибутов общие для этих типов.
Подробное описание групп атрибутов в классе объектов, см. Группы атрибутов.
Условие отображения контента — условием отображения контента является определенное значение атрибута или нескольких атрибутов объекта, на карточке которого расположен контент, или связанного с ним объекта, подробнее.
Представление — выберите вид списка в карточке объекта:
- "Простой список" — список представляет собой таблицу с заданным набором столбцов. Максимально в простом списке отображается 100 объектов. Есть возможность просмотра списка архивных объектов. Сортировки, фильтрации объектов и массовых действий с объектами списка не предусмотрено.
- "Сложный список" — список представляет собой таблицу с заданным набором столбцов. Предоставляет возможность настройки отображения столбцов, сортировки, фильтрации, постраничной навигации, массовых действий.
  
  Есть возможность настроить вид списка объектов по умолчанию, который будет отображаться в интерфейсе оператора, если в поле для выбора вида списка установлено значение "[Выберите вид]", см. Вид списка объектов по умолчанию .
  
  Есть возможность настроить ограничения фильтрации списка объектов, см. Настройка ограничений фильтрации списка объектов.
Если в параметре "Атрибут" выбран вычислимый атрибут типа "Набор ссылок на бизнес–объекты", то список связанных объектов отображается только в представлении "простой список" (поле "Представление" не доступно для редактирования) и в список выводится не более 20 объектов;
Название формы добавления связи — введите название формы, которая открывается при нажатии на ссылку или кнопку Добавить связь. По умолчанию: "Добавление связи с объектом класса "название Класса".

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

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

Для выбора доступны все профили доступа, существующие в системе. Если не выбран ни один профиль, то ограничения видимости контента нет.
Расположение — выберите расположение контента на карточке или форме: на всю ширину вкладки, справа или слева. Ширина правой и левой колонки определяется в режиме разметки, см. Режим разметки. Верхний левый контент всегда выделяется голубым фоном.

Список объектов, связанных по прямой и обратной связи

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

Описание параметров контента "Список связанных объектов" см. Список объектов, связанных по атрибуту связи напрямую или через цепочку связанных объектов.

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

Атрибут — выберите атрибут типа "Набор ссылок на бизнес-объекты", у которого параметр "Класс объекта" указывает на класс объектов, на карточке/форме которого размещается контент. Связь должна быть первого уровня.

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

Пример. Отображение списка связанных запросов в карточке запроса

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

В классе "Запрос" (serviceCall) добавьте атрибут "Список связанных запросов" типа "Набор ссылок на бизнес-объекты" класса "Запрос" (serviceCall).
При размещении в карточке запроса контента "Список связанных объектов" в поле "Атрибут" выберите данный атрибут и установите флажок "Показывать объекты с двух сторон связи".

В интерфейсе оператора: в карточке запроса 1 в списке связанных запросов добавляется связь с запросом 2. В карточке запроса 2 в списке связанных запросов будет отображаться запрос 1.

Список связанных объектов с учетом иерархии

В списке связанных объектов можно отображать объекты, связанные с множеством объектов определенного класса, образующих иерархическую структуру. Корневой объект иерархии должен быть связан с текущим объектом, в карточке которого размещается контент, или текущий объект сам может являться корнем иерархии. Иерархическая структура объектов строится в рамках одного класса через атрибут с кодом "parent" или аналогичный пользовательский атрибут.

Особенности заполнения параметров контента для отображения списка связанных объектов с учетом иерархии:

Включите флажок "Показывать в списке объекты, связанные с иерархией".

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

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

Отображение списка в интерфейсе оператора

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

Определяется корневой объект иерархии по параметру "Построить иерархию объектов (вниз), начиная с объекта" для текущего объекта. Если атрибут не заполнен, то список будет пуст.
Выполняется поиск всех объектов, у которых:
- класс объекта соответствует указанному в параметре "Класс объектов иерархии";
- в атрибуте, указанном в параметре "В иерархии потомки связаны с предками через атрибут", хранится ссылка на корневой объект иерархии.
Выполняется поиск всех объектов, у которых:
- класс объекта соответствует указанному в параметре "Класс объектов иерархии";
- в атрибуте, указанном в параметре "В иерархии потомки связаны с предками через атрибут", хранятся ссылки на объекты, найденные на предыдущем шаге 2.
Повторяется пункт 3 до тех пор, пока на очередном шаге есть объекты, которые могут добавляться в иерархию.
В итоговый список выводятся все объекты, на которые указывает ссылочный атрибут, выбранный в параметре "Объекты иерархии связаны с объектами списка через атрибут". Ссылка проверяется у всех объектов иерархии, в том числе у корневого объекта иерархии.

Примеры использования контента

Пример 1. На карточке сотрудника с ролью "Руководитель отдела" можно отобразить следующие списки:

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

Чтобы отобразить на карточке руководителя отдела список запросов, включающих запросы, которые инициировали сотрудники вложенных отделов, и запросы в ответственности данных сотрудников, добавьте на карточку сотрудника контент "Список связанных запросов" с параметрами:

"Построить иерархию объектов (вниз), начиная с объекта" — выберите атрибут "Отдел сотрудника" (parent), определенный в классе "Сотрудник" (employee).
"В иерархии потомки связаны с предками через атрибут" — указывается атрибут "Родительский отдел" (parent), определенный в классе "Отдел" (ou).
"Объекты иерархии связаны с объектами списка через атрибут" — выберите пользовательский атрибут "Запросы сотрудника", определенный в классе "Сотрудник" (employee). Отдел и сотрудник связаны между собой по пользовательскому атрибуту "Сотрудники отдела".
"Класс объектов иерархии" — указывается класс "Запрос" (serviceCall).

Пример 2. На карточке проекта и карточке ответственного за проект можно отобразить всю структуру подзадач (подэтапов). При условии, что "задача/этап" класс, вложенный в себя.

Пример 3. На карточке ИТ-актива можно отобразить список всех его компонентов. Тот же список можно отобразить на карточке сотрудника — материально ответственного лица.

Влияние прав на отображение контента

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

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