Related Lists

Связанные списки отображаются в нижней части форм и отображают записи, связанные с текущей записью, в виде таблиц, Например, запись Таблица (sys_db_table) содержит связанный список колонок. Он отображает записи из таблицы Колонки (sys_db_column), связанные с текущей записью.

Существует два типа связанных списков: 

• Ссылочные связанные списки имеют прямую ссылку на другую таблицу через ID текущей записи. Например, запись в таблице А содержит ID записи из таблицы Б. Тогда запись из таблицы Б, на которую ссылаются, будет иметь связанный список с записью из таблицы А в нем. Эта связь устанавливается колонками типа Reference, List и Document ID.
• Синтетические связанные списки не имеют прямых ссылок друг на друга. Смотрите раздел Связанные списки скриптов.

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

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

Добавление связанного списка

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

1. Откройте форму, на которую вам необходимо добавить связанный список. 
2. В бургер-меню выберите Настройка → Связанные списки.

3. Настройте наборы связанных списков, перемещая элементы из окон:
   

   

   
   

   Окно Доступно для выбора содержит список связанных таблиц, которые вы можете добавить на форму.

   Окно Выбрано содержит список связанных таблиц, которые отображаются на форме. 

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

   • Чтобы переместить элементы, перетаскивайте их или используйте кнопки и.
   • Чтобы убрать или добавить все колонки, нажмите кнопку или.
   • Чтобы изменить порядок отображения полей, используйте  и .
   • Чтобы переместить несколько элементов подряд, выберите их, удерживая клавишу Shift, а затем перетащите их в нужную область.
   • Чтобы перенести несколько разбросанных элементов, выберите их, удерживая клавишу Ctrl, а затем перетащите их в нужную область.
4. Нажмите Сохранить, чтобы применить изменения.

Перед стрелкой (→) отображается заголовок таблицы, в которой хранятся связанные записи. После стрелки (→) отображается поле, относящееся к текущей записи. То есть, Задачи инцидента → Родитель будет отображать записи из таблицы Задачи инцидента, у которых в поле Родитель значение содержит ID текущей записи.

В одной таблице может быть более одного поля: таблица Запросы на изменение (itsm_change_request) может ссылаться на текущую запись в полях Вызвано инцидентами, Родитель, Связанные инциденты и Решенные инциденты.

Создание записи в связанном списке

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

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

1. Откройте запись, к которой вам нужно добавить связанную запись. 
2. Перейдите в область Связанные списки и откройте необходимую вкладку.
3. Нажмите Сохранить, заполните поля.
4. Нажмите Сохранить или Сохранить и выйти.

Добавление записей через связанный список

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

Чтобы дополнить запись в связанный список, выполните следующие шаги:

1. Откройте запись, к которой вам нужно добавить связанную запись. 
2. Перейдите в область Связанные списки и откройте необходимую вкладку.
3. Нажмите Изменить.
4. Используя два окна, выберите записи для привязки к текущей записи.
5. Нажмите Сохранить.

Динамические связанные списки

Динамические связанные списки отличаются от ссылочных связанных списков – они связанны синтетически скриптом. То есть вы можете добавить отношения между таблицами, которые не ссылаются друг на друга в колонках типа Reference, List или Document ID. Эти списки можно настроить с помощью таблицы Динамические связанные списки (sys_related_list_script).

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

1. Перейдите в Настройка системы → Динамические связанные списки.
2. Нажмите Сохранить и заполните поля.
3. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.

Поля формы Динамические связанные списки

В своем скрипте вы можете свободно использовать объекты current и parent. Основная цель этого скрипта – сгенерировать запрос, который будет применен к таблице, указанной в поле Запрос от.