Связи (relations): различия между версиями

← Предыдущая правка

Текущая версия от 09:35, 16 октября 2026

Между двумя источниками данных можно установить связь типа главный-подчиненный (или родительский-дочерний).

Например:

одна запись в запросе LaboratoryFilter может иметь множество подчиненных записей в запросе Indicators;
оба запроса имеют поле lab_id, по которому можно установить связь.

Есть 2 способа построить отчет с подобными взаимоотношениями.

Способ 1 - Бэнды

Первый способ дает возможность строить отчеты типа главный-подчиненный (master-detail).

Алгоритм

Для этого используются два бэнда Данные:

главный бэнд привязывается к главному источнику данных;
подчиненный бэнд привязывается к подчиненному источнику данных;
в фильтре подчиненного источника задается выражение (сопоставление соответствующих полей).

[Indicators.lab_id] == [LaboratoryFilter.lab_id]

Результат

Итоговый отчет может выглядеть, например, так:

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

Способ 2 - Связи

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

Мы видим, что среди полей источника Indicators есть ссылка на родительскую таблицу LaboratoryFilter.

Алгоритм

Таким образом, для реализации такого типа отчета нужно:

создать связь между источниками данных;
перетащить в дереве данных из подчиненного источника поле родительского источника [Indicators.LaboratoryFilter.lab_name];
перетащить в дереве данных из подчиненного источника поле [Indicators.ind_name].

Результат

Итоговый отчет будет выглядеть следующим образом:

Если его запустить, мы увидим следующее:

Создание связи

Для того чтобы создать связь:

в окне Данные нажать кнопку Действия и выбрать пункт Новая связь... - откроется окно Редактор связи:

выбрать главную и подчиненную таблицы;
выбрать одну или несколько пар полей – для каждой таблицы соответственно;
закрыть редактор связи кнопкой ОК.

Созданную связь можно увидеть в окне Данные (если выбрать подчиненный источник данных и раскрыть список его полей - среди полей мы увидим связь с родительским источником):

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

Для того чтобы отредактировать связь:

откройте список полей дочернего источника данных;
найдите нужную связь;
нажмите кнопку Редактировать... на панели инструментов.

При этом будет вызван редактор связи, который мы рассматривали выше.

@@ Строка 7: / Строка 7: @@
 Есть 2 способа построить отчет с подобными взаимоотношениями.
-===Способ 1===
+==Способ 1 - Бэнды==
-Первый способ дает возможность строить отчеты типа "главный-подчиненный" (master-detail).
+Первый способ дает возможность строить отчеты типа <code>главный-подчиненный</code> (<code>master-detail</code>).
-Для этого используются два бэнда "Данные".
+===Алгоритм===
+Для этого используются два бэнда <code>Данные</code>:
+*главный бэнд привязывается к главному источнику данных;
+*подчиненный бэнд привязывается к подчиненному источнику данных;
+*в фильтре подчиненного источника задается выражение (сопоставление соответствующих полей).
+:<syntaxhighlight lang="java">
+[Indicators.lab_id] == [LaboratoryFilter.lab_id]
+</syntaxhighlight>
-Главный бэнд привязывается к главному источнику данных, подчиненный бэнд – к подчиненному источнику. Наш пример может выглядеть так:
+===Результат===
+Итоговый отчет может выглядеть, например, так:
 [[Файл: data_link_1.png|center|border]]
-Такой отчет, если его запустить, напечатает список показателей для каждой лаборатории:
+Если такой отчет запустить, то на печать будет выведен список показателей для каждой лаборатории со следующей структурой:
 [[Файл: data_link_2.png|center|border|500px]]
-===Способ 2===
+==Способ 2 - Связи==
-Второй способ позволяет из подчиненного источника обращаться к главному.
+Второй способ позволяет из подчиненного источника обращаться к главному, учитывая имеющуюся связь между двумя источниками:
+[[Файл: data_link_3.png|center|border]]
+Мы видим, что среди полей источника <code>Indicators</code> есть ссылка на родительскую таблицу <code>LaboratoryFilter</code>.
+===Алгоритм===
+Таким образом, для реализации такого типа отчета нужно:
+*[[Связи (relations)#Создание связи|создать связь между источниками данных]];
+*перетащить в дереве данных из подчиненного источника поле родительского источника <code>[Indicators.LaboratoryFilter.lab_name]</code>;
+*перетащить в дереве данных из подчиненного источника поле <code>[Indicators.ind_name]</code>.
+===Результат===
+Итоговый отчет будет выглядеть следующим образом:
-Покажем это на примере. Допустим, мы хотим распечатать список всех продуктов. Для этого нам нужен один бэнд "Данные", который подключен к таблице Products:
+[[Файл: data_link_4.png|center|border]]
+Если его запустить, мы увидим следующее:
+[[Файл: data_link_5.png|center|border|500px]]
-Такой отчет, если его запустить, напечатает все продукты из всех категорий. Допустим, мы рядом с каждым продуктом хотим напечатать имя категории, к которой он относится. Без использования связи это было бы затруднительно, т.к. все, что мы знаем о категории – это ее идентификатор (поле CategoryID в таблице Products). Имя категории хранится в поле CategoryName таблицы Categories. С помощью связи мы можем обратиться к имени категории следующим образом:
+==Создание связи==
-[Products.Categories.CategoryName]
+Для того чтобы создать связь:
+*в окне <code>Данные</code> нажать кнопку <code>Действия</code> и выбрать пункт <code>Новая связь...</code> - откроется окно <code>Редактор связи</code>:
+[[Файл: data_link_6.png|center|border]]
+*выбрать главную и подчиненную таблицы;
+*выбрать одну или несколько пар полей – для каждой таблицы соответственно;
+*закрыть редактор связи кнопкой <code>ОК</code>.
-При этом FastReport выполнит следующие действия:
+Созданную связь можно увидеть в окне <code>Данные</code> (если выбрать подчиненный источник данных и раскрыть список его полей - среди полей мы увидим связь с родительским источником):
-возьмет текущую строку в таблице Products;
+[[Файл: data_link_3.png|center|border]]
-в таблице Categories найдет строку, которая является родительской;
-для найденной строки вернет значение поля CategoryName.
-В общем случае форма обращения к полю родительской таблицы допускает неограниченное количество предков таблицы:
-[дочерняя_таблица.ее_родитель.родитель_родителя.и_так_далее.поле]
+==Редактирование связи==
-Чтобы добавить в отчет такое поле данных, откройте таблицу Products в окне "Данные". Вы увидите, что среди ее полей есть ссылка на родительскую таблицу Categories:
-[[Файл: data_link_3.png|center|border|500px]]
-Если перетащить показанное на рисунке поле в отчет, мы получим объект "Текст" с текстом:
-[Products.Categories.CategoryName]
-Наш отчет будет выглядеть следующим образом:
-[[Файл: data_link_4.png|center|border|500px]]
+Для того чтобы отредактировать связь:
+*откройте список полей дочернего источника данных;
+*найдите нужную связь;
+*нажмите кнопку <code>Редактировать...</code> на панели инструментов.
-Если его запустить, мы увидим следующее:
+При этом будет вызван редактор связи, который мы рассматривали выше.
-[[Файл: data_link_5.png|center|border|500px]]
-==Создание связи==
-==Редактирование связи==