Группы записей (Record Groups)

Цель лекции: научить слушателя создавать группы записей и ознакомить со стандартными встроенными подпрограммами, предназначенными для работы с Record Group.

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

Описание, назначения и свойства

Группы записей – это структурированные наборы данных, которые могут использоваться для передачи данных между модулями прикладных программ либо для заполнения списков значений или других элементов списка. Группа записей подобна как таблицам, так и представлениям базы данных. Как и таблица, группа записей содержит столбцы и строки, которые принадлежат той рабочей области, в которой определены. Так же, как и представление, группа записей создается на основе запроса, но является более гибкой, и не только по той причине, что группа записей для Oracle Forms локальна, но и потому что запрос, на основе которого создается группа записей, можно конструировать динамически, во время выполнения программы.

Группы записей можно разделить на два основных типа, которые вы можете определить в таблице свойств этого объекта:

Основные функциональные свойства группы записей:

Тип запроса – здесь вы можете выбрать тип запроса "Статический" или "Запрос". Их различия описаны выше. В зависимости от выбранного типа группа записей принимает разные функциональные свойства.

Если выбран тип "Запрос":

Если выбран тип "Статический":

Применение групп записей

Группы записей являются неотъемлемой частью списков значений LOV, так как LOV связан с определенной группой записей. Когда в мастере создания LOV – LOV Wizard – вы выбираете столбцы из одной или более таблицы для их отображения в LOV, вы на самом деле создаете группу записей, которая после завершения работы мастера появится в соответствующем узле навигатора. Если же вы создаете LOV вручную, то вам придется самим создавать группу записей, а затем присоединять ее к LOV. Подсоединение группы запросов к LOV может осуществляться как статически, так и динамически, во время выполнения программы.

Помимо LOV группы записей использует объект TREE VIEW – в этом объекте группа записей является одним из двух вариантов заполнения этого элемента. Создав группу записей, вы можете ее присоединить к TREE VIEW через его палитру свойств. Однако запросная группа для этого элемента строится не через обычный запрос, а через иерархический запрос. Создание групп записей для этого объекта мы рассмотрим в разделе, посвященном объекту TREE VIEW.

С помощью специального набора процедур и функций для работы с группами записей можно не только менять структуру группы в ходе выполнения программы, но и переопределять группу записей как для LOV, так и для TREE VIEW. Для динамического подключения групп записей к LOV и TREE VIEW используются две процедуры:

Строки групп записей внутренне пронумерованы последовательно начиная с 1, то есть 1, 2, 3 и т. д., поэтому если вам будет необходимо обратиться к каким-либо определенным строкам, то достаточно указать номер этой строки.

Создание группы записей

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

Для создания запросной группы выполните следующие шаги:

Созданная вами группа пока еще не имеет строк, поэтому для так называемого заполнения вам необходимо программно исполнить запрос с помощью процедуры POPULATE_GROUPЕсли на запросной группе записей основывается LOV, то Oracle Forms исполняет запрос, связанный с этой группой записей, при каждом вызове LOV либо при проверке LOV Validation. . Исполняемый запрос, естественно, должен быть связан с запросной группой.

После создания Запросной группы записей перейдите в палитру свойств группы записей и выберите свойство "Спецификация столбца" (Column Specification). При выборе этого свойства запускается окно Query Record Group Column Specification, в котором вы увидите выбранные вами столбцы (Column Names), их тип (Data Type) и размер (Length).

При выборе определенной колонки отображаются соответствующие ей структуры (тип, размер). Если вы удалите какой-нибудь столбец из Column Names, ваш запрос абсолютно не пострадает, а вот изменение запроса, будь то удаление, добавление или изменение запрашиваемого столбца в запросе, приведет и к его изменению в Query Record Group Column Specification.

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

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

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

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

Функции и процедуры для работы с группами записей

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

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

Создание и удаление групп:

Изменение структуры группы – эти подпрограммы неприменимы к статическим запросным группам:

Заполнение групп:

Получение значений ячеек:

Обработка строк:

Функции идентификаторов объектов:

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

Создание групп записей программно

Перед тем как перейти к рассмотрению этой темы и проработке представленных примеров, выполните следующие два шага:

SQL> create table ABOUT (
2 Name varchar2(10),
3 FName varchar2(12),
4 SName varchar2(12));

Мы с вами уже детально ознакомились с созданием группы записей в режиме проектирования. Теперь перейдем к следующему этапу – созданию групп записей программно. Рассмотрим два примера: создание запросной и незапросной группы.

Создание запросной группы:

/*WHEN-BUTTON_PRESSED*/
DECLARE
group_id RecordGroup;
query_ok NUMBER;
row_count number;
BEGIN
/* создаем группу prod_group и присваиваем ее идентификатор
** переменной group_id */
group_id := Create_Group_From_Query('about_group',
'SELECT Name,FName, SName
FROM ABOUT
WHERE rownum<10');
/* теперь исполним запрос новой группы, используя переменную
** group_id для идентификации группы */
query_ok := Populate_Group(group_id);

/* если запрос неудачный, то прерываем этот триггер вызовом
** предварительно определенного исключения */
IF query_ok <> 0 THEN
RAISE Form_Trigger_Failure;
END IF;
IF query_ok = 0 THEN
message('SQL maked succesfull');
END IF;
END;

/*WHEN-BUTTON_PRESSED*/
DECLARE
group_id RecordGroup;
col1_id GroupColumn;
col2_id GroupColumn;
col3_id GroupColumn;
query_ok number;
total_rows NUMBER;
new_row NUMBER;
BEGIN
/* Создаем незапросную группу с именем my_group и присваиваем ее
** идентификатор переменной group_id.
*/
group_id := Create_Group('about_no_query_group');
/* Добавляем в новую группу три колонки, используя для идентификации
** группы переменную group_id. Первые две колонки типа CHAR_COLUMN и
** их длина должна определяться.
** Третья типа NUMBER_COLUMN и параметр длины не принимает
*/
col1_id := Add_Group_Column(group_id,'col1_id',CHAR_COLUMN,50);
col2_id := Add_Group_Column(group_id,'col2_id',CHAR_COLUMN,50);
col3_id := Add_Group_Column(group_id,'col3_id',NUMBER_COLUMN);
query_ok := Populate_Group(group_id);
/* если запрос неудачный, то прерываем этот триггер вызовом
** предварительно определенного исключения */
END;

/*WHEN-BUTTON_PRESSED*/
Add_Group_Column('about_no_query_group','N_AME',CHAR_COLUMN);
Set_Group_Char_Cell('about_no_query_group .N_AME',2,'Nik');

/*WHEN-BUTTON_PRESSED*/
Add_Group_Row('about_group',2);

Add_Group_Row('about_group', END_OF_GROUP);

/*WHEN-BUTTON_PRESSED*/
Delete_Group_Row('about_group',1);

/*WHEN-BUTTON_PRESSED*/
:ABOUT.zap_gr:=Get_Group_Row_Count('about_group');

/*WHEN-BUTTON_PRESSED*/
:ABOUT.no_zap_gr:=Get_Group_Row_Count('about_no_query_group');

/*WHEN-BUTTON_PRESSED*/
:ABOUT.no_zap_gr:=Get_Group_Row_Count('about_no_query_group');

Теперь запустите форму и попробуйте создать запросную и незапросную группу, посчитать количество строк в группе до и после удаления или вставки. Для ответа на вопрос "Создана ли группа или удалена?" можно выполнить такую проверку:

Пометка строк в группе записей

Программно вы можете не только считать количество строк, устанавливать новые или изменять предыдущие значения, но и выделять (помечать) из существующей группы интересующий вас набор данных, удовлетворяющий, к примеру, какому-то одному значению. Функции и процедуры, связанные с пометкой, имеют окончание "_ SELECTION". Опишем назначение каждой из них более подробно.

Теперь рассмотрим простой пример: "Пометить как выбранные все строки, в которых встречается имя Вова". Для этого выполните следующие шаги:

/*WHEN-BUTTON_PRESSED*/
DECLARE
C_OUNT NUMBER;
count_names NUMBER;
group_id RecordGroup;
BEGIN

group_id:= FIND_GROUP('about_group');

C_OUNT := Get_Group_Row_Count(group_id);

FOR i IN 1..C_OUNT LOOP
IF Get_Group_Char_Cell('about_group.Name',i) =
'Вова' THEN
Set_Group_Selection(group_id,i);
END IF;
END LOOP;
count_names := Get_Group_Selection_Count(group_id);
:ABOUT.ZAP_GR:=TO_CHAR (count_names);
END;

Get_Group_Selection('about_group',2);