Relationships are different from related lists in that queries to the related tables are performed by the script.
Relationships can be configured via the Relationship (sys_related_list_script) table.
To set up a scripted related list, please complete the steps below:
- Navigate to {your_instance_url}/list/sys_related_list_script;
- Click New, fill in the form and click Save.
Relationships form fields
| Field | Description |
|---|---|
| Name | Relationship name displayed in the list. |
| Apply to | This field references to tables dictionary (the Table (sys_db_table) table). Specify the table on the forms of which this related list will be displayed. |
| Query from | This field references to tables dictionary (the Table (sys_db_table) table). Specify the table containing the source records for this list. |
| Query with | In this field |
Это таблица sys_related_list_script.
Ключевое
Name - имя синтетического связанного списка
Apply to - к какой форме мы это применяем. На форме какой таблицы. Ссылка (reference) на sys_db_table. Нужно указать таблицу. По смыслу это ссылка на таблицу. Отображается Title таблицы. На формах записей, которые относятся к этой таблице, мы будем выводить наш ССС.
Query from - референс на таблицу, из которой мы будем вынимать записи для этого списка.
Далее самое интересное.
Query with - скрипт, который нам формирует условие выборки. Есть несколько ключевых моментов:
- Есть объект current, это самое важное, это объект таблицы, для которой мы создаем наш query (таблицы из поля query from). По смыслу мы создаем какой-то запрос, который будет делать выборку для этого листа. И ключевое, что в этом скрипте должно быть, это, current.addQuery, и дальше какой-то там query, или какие-то addCondition, и тд тд и тд, и в итоге для current мы должны сформировать какой-то запрос, и соответственно исходя из этого он будет показывать записи.
- Есть объект parent, это ссылка на объект формы из apply to. Parent это форма записи, current это лист таблицы из query from. Вот, собственно говоря, и все. Исходя из этого query, мы формируем запрос и выводим обычный стандартный релейтед лист как положено.
Надо описать обязательно объекты parent и current, потому что от них все зависит, они все делают. Скрипт может быть в принципе любым.
