Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

Image Added

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

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

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

Note

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


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

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

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


Tip

Требуемая роль: admin.

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

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

    Section


    Column
    width40%


    Column
    width60%

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

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

    Panel

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

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




  4. Нажмите Сохранить, чтобы применить изменения.

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

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

Tip

Связанные списки связаны через ID текущей записи. То есть условием для связанного списка является [Наименование колонки] равно [ID текущей записи]. Чтобы создать более точные условия и установить сложные отношения между полями, создайте динамический связанный список скриптов.

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


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

Image Modified


Tip

Кнопка Создать недоступна на некоторых связанных списках. 

Tooltip
onlyIcontrue
appendIconinfo-filled
iconColorblurblue

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


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

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

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


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

Tip

Кнопка Изменить недоступна на некоторых связанных списках. 

Tooltip
appendIconinfo-filled
iconColorblue

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


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

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

Динамические связанные списки
Anchor
scripted related lists
scripted related lists


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

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

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

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

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

Укажите таблицу, содержащую исходные записи для этого списка.

Запрос к таблицеДДаВ этом поле вы можете написать скрипт, указывающий записи, которые нужно включить из таблицы, обрабатываемой этим отношением.

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

Info
  1. Объект current это объект таблицы, в которой создается запрос (таблица, указанная в поле Запрос от). 
  2. Объект parent – это ссылка на объект таблицы, указанной в поле Применить к.

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

Вы можете использовать любые методы серверного API Клиентский API в SimpleRecord Server-Side в качестве директив в объектах current и parent.

 


Table of Contents
absoluteUrltrue
classfixedPosition
printablefalse