Связь типа "Вложение"

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

Описание связи типа "Вложение"

Связь типа "Вложение" представлена в двух вариантах:

  • Объект вложен в объект другого класса. Вложенный объект может быть создан в карточке родительского объекта.
  • Объект вложен в объект своего класса. Вложенный объект может быть создан в карточке родительского объекта и в карточке объекта класса "Компания".

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

События, произошедшие с вложенными объектами, отображаются в истории изменений самого объекта и также истории изменений объекта родительского класса в контенте "История изменений объекта".

Вложенные классы отображаются в свойствах родительского класса на вкладке "Атрибуты" (блок "Свойства класса").

Системные связи типа "Вложение"

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

  • в класс "Компания" (root) вложены объекты класса "Отдел" (ou);
  • в класс "Отдел" (ou) вложены объекты классов "Отдел" (ou) и "Сотрудник" (employee).

Создание и редактирование связи типа "Вложение"

Создание связи "Объекты вложены в объект другого класса"

Связь типа "Вложение" (вариант "Объекты вложены в объект другого класса") устанавливается при создании пользовательского класса объектов.

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

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

Классы объектов, вложенные в другой класс не наследуют настройки родительского класса.

Создание связи "Объекты вложены в объект своего класса"

Связь типа "Вложение" (вариант "Объекты вложены в объект своего класса") устанавливается:

  • При создании пользовательского класса объектов. Чтобы установить связь (вариант "Объекты вложены в объект своего класса"), на форме "Добавление класса" в поле "Объекты вложены в" выберите значение [в объект своего класса], см. Настройка классов и типов объектов.

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

    Чтобы установить связь (вариант "Объекты вложены в объект своего класса"), на форме "Редактирование класса" в поле "Объекты вложены в" выберите значение [в объект своего класса].

    Изменения в интерфейсе при выборе значения [в объекты своего класса]:

    • Добавляется новый атрибут "Родитель" (parent) для вложенного класса.
    • Объекты класса могут создаваться в контенте "Список вложенных объектов".
    • Изменяется представление для редактирования в атрибутах типа "Ссылка на бизнес-объект" и "Набор ссылок на бизнес-объект" со ссылкой на класс, который становится вложенным, списки выбора заменяются на деревья выбора.
    • Добавляется представление для редактирования "Иерархический список (услуга)" для услуги на странице "Параметры запросов" (если вложенным становится класс "Услуга" (slmService).

Редактирование связи "Объекты вложены в объект своего класса"

Связь типа "Вложение" (вариант "Объекты вложены в объект своего класса") может быть разорвана при редактировании пользовательского класса объектов и системного класса "Услуга" (slmService).

Чтобы разорвать связь, на форме "Изменение класса" в поле "Объекты вложены в" выберите значение [не указано].

Изменения в интерфейсе при выборе значения [не указано]:

  • Удаляются контенты "Список вложенных объектов".
  • Удаляется атрибут "Родитель" (parent).
  • Изменяется представление для редактирования услуги: "Иерархический список (услуга)" заменяется на "Иерархический список (соглашение и услуга)" на странице "Параметры запросов". Представление "Иерархический список (услуга)" удаляется.
  • Изменяется представление для редактирования в атрибутах типа "Ссылка на бизнес-объект" и "Набор ссылок на бизнес-объект" со ссылкой на класс, который становится НЕвложенным, деревья выбора заменяются на списки выбора.

Настройка добавления объектов вложенных классов

Объекты вложенных классов могут добавляться:

  • с помощью ссылки "Добавить" в верхнем меню.
  • в карточке родительского объекта (в контенте "Список вложенных объектов");
  • в карточке связанного объекта (в контенте "Список связанных объектов");
  • в карточке объекта класса "Компания" (для объектов, вложенных в объект своего класса).

Общее описание настройки добавления объектов см. Настройка действия "Добавление объекта".

Особенности добавления вложенных объектов в верхнем меню

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

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

Особенности добавления связанного объекта вложенного класса

Особенности создания связанного объекта вложенного класса по атрибуту типа "Набор ссылок на бизнес-объекты" :

  • Связь вложение типа [Объект вложен в объект своего класса]

    • если на форму добавления объекта выведен контент "Выбор родительского объекта", то у добавленного объекта атрибут "Родитель" (parent) заполняется указанным пользователем значением;
    • если контент "Выбор родительского объекта" отсутствует, то у добавленного объекта атрибут "Родитель" (parent) заполняется значением "Компания" (root).

  • Связь вложение типа [Объект вложен в другой класс]

    • если на форму добавления объекта выведен контент "Выбор родительского объекта", то у добавленного объекта атрибут "Родитель" (parent) заполняется указанным пользователем значением;
    • если контент "Выбор родительского объекта" отсутствует, то выводится сообщение об ошибке.

Особенности создания связанного объекта вложенного класса в списке по атрибуту типа "Обратная ссылка": у добавленного объекта атрибут "Родитель" (parent) заполняется значением "Компания" (root).

Редактирование родительского объекта

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

При перемещении объекта изменяется значение атрибута "Родитель" (parent).

Атрибут "Родитель" (parent)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  

Код

(нередактируемый)

parent

  

Тип

(нередактируемый)

Ссылка на бизнес-объект

 

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

(нередактируемый)

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

 

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

(нередактируемый)

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

 

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

(нередактируемый)
  • нет — вариант связи "Объекты вложены в объект своего класса";
  • да — вариант связи "Объекты вложены в объект другого класса"

 

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

(нередактируемый)

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

 

Уникальный

(нередактируемый)

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

 

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

(нередактируемый)

Класс объекта, с которым будет создана связь (кроме класса "Компания" (root)

 

Типы объекта

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

Ограничения по типам распространяются на представление для редактирования "Список выбора".

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

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

    На форме "Перемещение объекта", в поле "Объект - назначение":

    • для пользовательского класса, класса "Услуга" (service) и "Отдел" (ou) отображаются элементы [не указано] и "Компания".
    • для класса "Сотрудник" (employee) отображается только [не указано]
  • Класс объектов — связь может быть установлена с объектом любого типа родительского класса. При установке флажка в классе объектов у всех типов проставляются флажки, недоступные для редактирования. При снятии флажка в классе флажки у всех типов становятся доступными для редактирования.

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

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

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

 

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

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

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

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

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

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

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

 

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

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

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

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

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

  • "Ссылка на бизнес-объект" — отображается как название объекта выбранного класса/типа. Название объекта является ссылкой на карточку объекта

 

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

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

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

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

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

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

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

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

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

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

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

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

 

Описание

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

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

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

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

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

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

 

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

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

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

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

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

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

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

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

 

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

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

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

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

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

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

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

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

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

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

Структура

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

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

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