Лабораторная работа № 7. Создание табличных форм, параметризованных отчетов и форм «Главная/Детальная»
Задачи:
Создать приложение
Создать табличную форму
Создать параметризованный отчет
Создать форму «Главная/Детальная»
Создание приложения
Создайте в Application Builder новое приложение с помощью мастера:
Название приложения – ЛБ_7<фамилия в транслитерации>
Способ создания – «с нуля» (Start from scratch)
Добавьте в создаваемое приложение одну пустую (blank) страницу
Не копируйте разделяемые компоненты из другого приложения (Copy Shared Components from Another Application: No)
На шаге Attributes в окне Tabs выберите One Level of Tabs.
Схема аутентификации – Application Express.
Язык – Russian (ru)
Формат даты – DD.MON.YYYY
Тема – Theme 21.
Создание табличной формы
Мастер создания табличной формы позволяет создать форму для выполнения операций обновления, вставки и удаления над множеством записей в таблице БД. Дополнительно мастер создает процесс обновления над множеством записей, который проверяет значения контрольных сумм (сгенерированных по алгоритму MD5) перед выполнением процесса для того, чтобы предотвратить потерю обновлений.
Создайте страницу:
Тип страницы – Form
Тип формы – Tabular Form (Табличная форма)
Таблица, на которой основана форма, – EMPLOYEES
В качестве отображаемых столбцов выберите все столбцы, кроме EMPLOYEE_ID, PHONE_NUMBER и COMMISSION_PCT
Разрешенные операции (Allowed Operations): вставка, обновление, удаление (Update, Insert, Delete)
Первичный ключ – EMPLOYEE_ID
В качестве источника значений первичного ключа выберите существующий объект-последовательность (Existing sequence) EMPLOYEES_SEQ
В качестве обновляемых столбцов выберите все столбцы формы
Название страницы (Page Name) и название области (Region Title) – Табличная форма "Работники"
На шаге Tab Options выберите опцию Use an existing tab set and create a new tab within the existing tab set (Использовать существующий набор вкладок и создать новую вкладку в существующем наборе вкладок), в поле New Tab Label впишите Табличная форма ‘Работники’6
Для кнопок задайте русскоязычные ярлыки (Отменить, Отправить, Удалить, Добавить запись)
В окнах Branch to Page оставьте значения по умолчанию.
Запустите приложение. Обратите внимание на вкладки в верхнем правом углу страницы:
Табличная форма позволяет добавлять, редактировать и удалять сразу несколько записей.
Поля в столбце Hire Date дополните возможностью выбора даты из календаря:
Откройте страницу редактирования столбца Hire Date (Column Attributes: HIRE_DATE).
В поле Display As выберите Date Picker
В поле Number/Date Format выберите DD.MON.YYYY
В столбцах Job Id и Department Id добавьте возможность выбора соответственно должности и подразделения из выпадающего списка:
Создайте необходимые списки значений, скопировав их из Вашего предыдущего приложения:
Начните создание списков значений (см. ранее) и на шаге Source выберите As a Copy of an Existing List of Values.
На шаге Copy From выберите Ваше приложение, в котором уже созданы требуемые списки значений.
На шаге New Lists of Values в столбце To Name укажите названия создаваемых списков (DEPARTMENTS, JOBS), а в столбце Copy? – выберите Yes для копируемых списков.
Нажмите кнопку Copy List of Values.
Свяжите столбцы Job Id и Department Id с соответствующими списками значений (см. ранее).
В столбце Department Id должна быть возможность выбирать и отображать пустое значение.
Должны отображаться только значения из списка (в поле Display Extra Values должно быть выбрано No).
Добавьте возможность сортировки по столбцам.
Протестируйте форму: создайте 2-3 записи, измените их, а затем удалите. Обратите внимание, что операции создания и изменения записей должны заканчиваться отправкой страницы на сервер (нажатием на кнопку Отправить), а для удаления записей сначала необходимо их отметить, поставив флажок в крайнем левом столбце, а затем нажать кнопку Удалить:
Замечание: не изменяйте предложение SELECT (список выбираемых столбцов) в запросе, на котором основана табличная форма, после ее генерации. Это может привести к ошибке в контрольной сумме при попытке отправить измененные с помощью формы данные.
Например: нельзя изменять запрос SELECT last_name FROM employees
следующим образом: SELECT lower(last_name) FROM employees
Создание параметризованного отчета
В приложениях Oracle Application Express отчет – это отформатированный результат выполнения SQL-запроса. Параметризованный отчет – это отчет, в котором результат запроса зависит от данных, введенных на форме пользователем.
Создайте новую страницу для параметризованного отчета:
Тип страницы – Blank Page
Название и ярлык страницы – Параметризованный отчет "Работники".
Для создаваемой страницы должна быть создана новая вкладка в существующем наборе вкладок
Название (ярлык) вкладки – Параметризованный отчет ‘Работники’
На созданной странице необходимо создать 2 области: область для размещения элементов, представляющих критерии отбора (параметры отчета) и область для отображения результатов запроса.
Создайте на странице Параметризованный отчет "Работники" область для размещения элементов, представляющих критерии отбора:
Тип области – HTML
Тип контейнера HTML области – HTML
Заголовок области (Title) – Критерии отбора
В остальных полях оставьте значения по умолчанию.
Создайте на странице Параметризованный отчет "Работники" область для отображения результатов запроса:
Тип области – Report
Реализация отчета (Report Implementation) – Classic Report
Заголовок области (Title) – Работники&P3_TEXT.7. &P3_TEXT. – это подстановочная строка, которая будет определять содержание заголовка. Вы создадите соответствующий элемент чуть позже.
На шаге Источник (Source) введите следующий SQL запрос:
SELECT
EMPLOYEES.EMPLOYEE_ID EMPLOYEE_ID,
EMPLOYEES.FIRST_NAME FIRST_NAME,
EMPLOYEES.LAST_NAME LAST_NAME,
EMPLOYEES.PHONE_NUMBER PHONE_NUMBER,
EMPLOYEES.HIRE_DATE HIRE_DATE,
EMPLOYEES.JOB_ID JOB_ID,
EMPLOYEES.SALARY SALARY,
EMPLOYEES.COMMISSION_PCT COMMISSION_PCT,
EMPLOYEES.DEPARTMENT_ID DEPARTMENT_ID
FROM
#OWNER#.EMPLOYEES EMPLOYEES
WHERE
(lower(first_name) like '%' || lower(:P3_NAME) || '%' OR
lower(last_name) like '%' || lower(:P3_NAME) || '%')
AND nvl(department_id, -1) =
decode(:P3_DEPT, -1, nvl(department_id, -1), :P3_DEPT)
Обратите внимание:
В предложении WHERE с помощью функции lower() производится приведение значений столбцов и соответствующих критериев отбора к нижнему регистру. Это делает поиск не чувствительным к регистру.
Групповой символ % соответствует любому символу или группе символов
Функция decode() имеет следующий синтаксис:
DECODE(expr, search, result [, search, result ]... [, default ])
Функция последовательно сравнивает значение expr с каждым значением search. Если значение expr равно значению search, возвращается соответствующее значение result. Если совпадений не обнаружено, возвращается значение default. Если значение default не указано, возвращается null.
Остальные параметры оставьте со значениями по умолчанию.
Теперь необходимо создать элементы, на которые есть ссылки в заголовке области и в запросе: P3_NAME, P3_DEPT, P3_MGR и P3_TEXT:
Создайте в области Критерии отбора текстовое поле для ввода строки поиска работника по имени и фамилии:
Тип элемента – Page Control on this Page - Item
Тип отображения текстового элемента – Text Field
Название элемента – P3_NAME
Область – Критерии отбора
Ярлык для поля – Искать работника
Остальные параметры оставьте со значениями по умолчанию
Аналогичным образом в области Работники&P3_TEXT. создайте скрытое поле (Hidden) с именем P3_TEXT.
Создайте в области Критерии отбора поле с выпадающим списком выбора (Item - Select List):
Имя элемента – P3_DEPT
Значения должны браться из скопированного Вами ранее списка значений для подразделений (DEPARTMENTS)
Для неопределенных (Null) значений должен выводиться текст -Все- и возвращаться значение -1
Ярлык для поля – Подразделение
Остальные параметры оставьте со значениями по умолчанию
После того, как пользователь введет критерии отбора в созданные Вами поля, страница должна быть отправлена на сервер для того, чтобы запрос отчета выполнился с новыми параметрами:
Создайте на странице Параметризованный отчет "Работники" в области Критерии отбора кнопку для отправки (submit) страницы на сервер:
При определении позиции кнопки укажите Create a button displayed among this region's items.
Имя кнопки – P3_GO
Ярлык (Label) – Выполнить
Стиль кнопки (Button Style) – Template Based Button
Шаблон (Template) – Button
Запустите страницу и протестируйте ее работу следующим образом:
Очистите поля с критериями отбора и нажмите кнопку Выполнить. Отобразятся записи обо всех работниках.
Используя навигационную ссылку  в правом нижнем углу отчета, пролистайте 1-2 порции (страниц) записей.
Введите в поле Искать работника строку ров и нажмите кнопку Выполнить. По идее, должны были отобразиться записи о работниках, в чьих именах и фамилиях встречается заданная строка. Однако вместо этого может выводиться сообщение следующего вида:
Если отображается подобное сообщение об ошибке, то причина этого заключается в том, что при отправке запроса не была сброшена разбивка на страницы, в то время как результат запроса помещается на одной странице. Поэтому Вы фактически запросили 2-ю или 3-ю страницу отчета, состоящего только из одной страницы. Щелчок по ссылке reset pagination позволит корректно отобразить результат выполнения запроса.
Для исправления такого некорректного поведения необходимо сбрасывать разбивку на страницы при отправке страницы на сервер.
Отредактируйте переход (branch) Page на странице Параметризованный отчет "Работники", установив флажок reset pagination for this page: Page Processing - + - Branch – Page=”Параметризованный отчет “Работники””.
Протестируйте работу страницы, комбинируя различные критерии выбора записей.
Далее необходимо создать процесс, который устанавливает значение скрытого элемента P3_TEXT. Значение P3_TEXT используется в заголовке области, в которой отображаются сведения о работниках. В результате выполнения процесса заголовок должен принимать вид Работники <название подразделения>:
Создайте на странице Параметризованный отчет "Работники" процесс, устанавливающий значение скрытого элемента P3_TEXT:
В определении страницы в столбце Page Processing щелкните по иконке Create  и выберите Process.
На шаге Process Type выберите тип процесса – PL/SQL.
На шаге Process Attributes установите название процесса (Name) – Получить данные для заголовка. Остальные параметры оставьте без изменения.
На шаге Process в поле Enter PL/SQL Page Process введите следующий текст, представляющий собой анонимный PL/SQL блок:
DECLARE
l_dept varchar2(100);
BEGIN
:P3_TEXT := null;
IF :P3_DEPT != -1
THEN SELECT department_name
INTO l_dept
FROM departments
WHERE department_id = :P3_DEPT;
:P3_TEXT := :P3_TEXT || ' подразделения ' || l_dept;
END IF;
END;
В остальных полях оставьте значения по умолчанию.
Протестируйте работу формы:
Создание формы «Главная/Детальная» (Master/Detail)
Форма «Главная/Детальная» отражает отношение «один-ко-многим» между двумя таблицами в БД. Обычно такая форма отображает запись из главной таблицы и множество соответствующих ей записей из детальной (подчиненной) таблицы на одной HTML странице. С помощью этой формы пользователи могут вставлять, изменять и удалять записи в обеих таблицах.
Создайте страницу с формой «Главная/Детальная» для редактирования подразделения и его работников:
Тип страницы – Form (Master Detail Form)
На шаге Master Table and Columns:
Имя таблицы (Table / View Name) – DEPARTMENTS
Добавьте все столбцы таблицы в список отображаемых
На шаге Detail Table and Columns:
Имя таблицы (Table / View Name) – EMPLOYEES
Добавьте все столбцы таблицы в список отображаемых
На шаге Define Primary Key в качестве источников значений столбцов первичных ключей для главной и детальной таблиц выберите соответственно существующие последовательности (Existing sequence) DEPARTMENTS_SEQ и EMPLOYEES_SEQ
На шаге Master Options:
Оставьте выбранной опцию включить в форму элементы навигации по записям главной таблицы (Include master row navigation? – Yes)
Установите порядок перехода по записям (Master Row Navigation Order) в соответствие co значением столбца DEPARTMENT_NAME
Оставьте выбранной опцию создания отчета по главной таблице (Include master report? – Yes). Она означает, что в дополнение к форме будет создана страница с отчетом о подразделениях, содержащая ссылки на форму
На шаге Layout выберите вариант создания формы с возможностью редактирования детальной таблицы на той же странице (Edit detail as tabular form on same page)
На шаге Page Attributes:
Заголовок страницы с отчетом (Master) – Подразделения
Заголовок страницы с формой (Detail) – Главная/Детальная форма 'Подразделения/Работники'
Выберите опцию не добавлять на страницу область цепочки ссылок (- do not add breadcrumb region to page -)
На шаге Tab Options выберите опцию Use an existing tab set and create a new tab within the existing tab set (Использовать существующий набор вкладок и создать новую вкладку в существующем наборе вкладок) и для уже существующего набора вкладок в поле New Tab Label впишите Главная/Детальная форма ‘Подразделение/Работники’
Запустите приложение. Обратите внимание, что на вкладке Главная/Детальная форма ‘Подразделение/Работники’ отображается страница отчета о подразделениях:
Щелчок по иконке редактирования около нужного подразделения приводит к переходу на страницу Главная/Детальная форма 'Подразделения/Работники'. При этом в «главной» форме отображается выбранное на странице отчета подразделение:
На странице Главная/Детальная форма 'Подразделения/Работники' доработайте поля Manager Id и Location Id в области Departments и столбец Job Id в области Employees так, чтобы значения в них можно было выбирать с помощью выпадающих списков выбора (Select List):
Запустите приложение и протестируйте работу формы и переходы с использованием вкладок.
Задание к работе (все промежуточные результаты через кнопку PrintScreen сохранять в отдельном файле для показа преподавателю):
Проделайте все описанные действия.
Покажите результат преподавателю.
|
