Лабораторная работа №3. Создание исходного приложения
Задачи:
Создать простейшее приложение-отчет.
Связать две таблицы в одном отчете.
Создать отчет и форму для таблицы EMPLOYEES.
Выполнить расчеты в отчете.
Создание простейшего приложения
Для создания приложения активизируют Application Builder. Затем:
Щелкните по кнопке Create >. Появится мастер создания приложения (Create Application).
На шаге Method оставьте Database и щелкните Next>.
На шаге Name:
Name – введите имя торговой корпорации, соответствующее Вашей фамилии в транслитерации (в рассмотренном примере имя приложения - КГТУ).
Application – оставьте автоматически сгенерированное значение (это уникальный идентификатор приложения, с которым работает система и который помогает пользователю сориентироваться).
Create Options – выберите Start from scratch (с нуля).
Schema – выберите схему БД, содержащую объекты, с которыми будет работать приложение. Щелкните Next>.
Далее добавьте страницы в приложение. Для этого:
На шаге Pages установите следующее в секции Add Page:
Select Page Type – оставьте значение по умолчанию – Blank.
Page Name – введите Главная.
Щелкните по кнопке Add Page. Созданная страница появилась в списке страниц приложения в верхней секции (Create Application).
Затем добавьте страницу с отчетом о подразделениях, основанном на таблице DEPARTMENTS. Для этого в секции Add Page установите следующее:
Select Page Type – выберите Report.
Subordinate to Page – выберите Главная (это необходимо для определения иерархии страниц в приложении).
Page Source – оставьте значение Table.
Table Name – выберите DEPARTMENTS. В списке отображаются все таблицы и представления схемы, с которой ассоциировано приложение.
Implementation – выберите Classic.
Щелкните Add Page. Страницы, перечисленные в секции Create Application, отображают иерархию страниц в приложении.
Далее измените имя страницы, установленное по умолчанию – Departments, – на Подразделения:
Щелкните по ссылке Departments.
В секции Page Definition измените Page Name на Подразделения.
Щелкните Apply Changes.
В секции Create Application щелкните Next >.
После добавления страниц необходимо определить некоторые параметры уровня приложения:
На шаге Shared Components оставьте No и щелкните Next>.
На шаге Attributes:
Authentication Scheme оставьте Application Express.
Language – выберите Russian (ru).
Date Format – введите маску DD.MON.YYYY,щелкните Next>.
На шаге User Interface Theme выберите тему Theme 21 и щелкните Next>.
На шаге Confirm проверьте введенные данные и щелкните Create Application.
Две созданные страницы – Главная и Подразделения – по умолчанию отображаются в виде иконок на странице приложения в Application Builder. Обратите внимание, что Oracle APEX автоматически добавил в приложение страницу Login.
Чтобы просмотреть приложение, необходимо запустить его. APEX на основе данных, сохраненных в БД, динамически визуализирует приложение в виде HTML страниц.
Запустить приложение можно, щелкнув по иконке Run на домашней странице приложения (вкладка Application Builder). После авторизации появится главная страница приложения вида:
Обратите внимание на ссылку на страницу Подразделения, которая появилась на Главной странице, т.к. задана такая иерархия.
Также обратите внимание на панель инструментов разработчика внизу страницы. Данные ссылки появляются, когда приложение запускается в среде разработки.
Щелкните по ссылке Подразделения на главной странице. Появится страница Подразделения вида:
Этому отчету соответствует запрос в виде скрипта:
select
"DEPARTMENT_ID",
"DEPARTMENT_NAME",
"MANAGER_ID",
"LOCATION_ID"
from "DEPARTMENTS"
where
(
instr(upper("DEPARTMENT_NAME"),upper(nvl(:P2_REPORT_SEARCH,"DEPARTMENT_NAME"))) > 0
)
Обратите внимание, что приложение содержит элементы и свойства, которые позволяют быстро выполнять определенные задачи:
Breadcrumbs – отображают иерархию и путь страницы в виде ссылок. Щелкая по ссылкам, можно перемещаться по иерархии:
Сортировка – чтобы отсортировать данные по столбцу, нужно щелкнуть по заголовку этого столбца.
Search – для поиска записей, содержащих определенные данные, необходимо ввести эти данные (строку поиска) в поле поиска и нажать кнопку Go. Поиск не чувствителен к регистру.
Display – поле со списком позволяет выбрать число записей, которое будет отображаться на странице. Для обновления необходимо нажать кнопку Go.
Spread Sheet – щелчок по этой ссылке вызывает диалог сохранения данных в CSV файле.
Next и Previous – эти ссылки позволяют перемещаться между подмножествами данных (если все записи целиком не помещаются на одной странице, они разбиваются в соответствии со значением параметра Display).
Список подмножеств записей – позволяет выбрать, какое из подмножеств отобразить на странице.
Можно запускать также и отдельные страницы приложения. Для этого в списке страниц выбрать опцию Run напротив нужного приложения.
2. Связывание разных таблиц в одном отчете
Изменим запрос для отчета Подразделения так, чтобы он включал данные из таблицы EMPLOYEES:
Откройте определение страницы Подразделения в списке страниц на вкладке, соответствующей идентификатору Вашего приложения.
В разделе Page Rendering обратите внимание на секцию Items. В ней перечислены элементы управления, содержащиеся на странице.
В этом же разделе найдите секцию Regions и щелкните по ссылке Подразделения. Откроется окно Identification. Найдите секцию Source и изучите запрос в поле Region Source.
Замените текст запроса в текстовом поле Region Source на следующий:
SELECT d.department_id "Department ID",
d.department_name "Department Name",
count('x') "Number of Employees",
substr(e.last_name,1,1)||'. '|| e.first_name "Manager Name",
c.country_name "Location"
FROM departments d,
employees e,
locations l,
countries c,
employees e2
WHERE d.manager_id = e.employee_id
AND d.location_id = l.location_id
AND d.department_id = e2.department_id
AND l.country_id = c.country_id
AND instr(upper(d.department_name),upper(nvl(:P2_REPORT_SEARCH,d.department_name))) > 0
GROUP BY d.department_id, d.department_name,
substr(e.last_name,1,1)||'. '||e.first_name, c.country_name
Изучите текст нового запроса. Обратите внимание на использование групповой функции count() и предложение GROUP BY.
Щелкните по кнопке Apply Changes.
Запустите страницу. Отобразится видоизмененный отчет о подразделениях:
Обратите внимание на 3 новых столбца: Number Of Employees, Manager Name (вместо идентификатора теперь отображается первая буква имени и фамилия) и Location.
Создание отчета и формы для таблицы EMPLOYEES
Для создания отчета о работниках и формы для редактирования:
Перейдите на домашнюю страницу приложения в Application Builder.
Щелкните по кнопке Create Page >.
На шаге Create Page:
Выберите Form и щелкните Next >.
Выберите Form on a Table with Report и щелкните Next >. Эта опция создает две страницы: отчет и форму, основанные на одной таблице или представлении.
На шаге Report Page:
Implementation – выберите Classic.
Breadcrumb – выберите Breadcrumb. Появится секция Create Breadcrumb Entry.
В Select Parent Entry выберите ссылку на страницу Главная.
В полях Entry Name, Page Name и Region Title измените значение на Работники, щелкните Next >.
На шаге Data Source:
В поле Table/View Owner оставьте значение по умолчанию.
В поле Table/View Name выберите EMPLOYEES и щелкните Next >.
На шаге Tabs в Tab Options оставьте опцию Do not use tabs и щелкните Next >.
На шаге Report Columns:
В списке Select Column(s), нажав и удерживая клавишу Ctrl выберите следующие столбцы:
EMPLOYEE_ID
FIRST_NAME
LAST_NAME
HIRE_DATE
SALARY
COMMISSION_PCT
Выбранные столбцы появятся на странице отчета. Щелкните Next >.
В Edit Link Image оставьте иконку, выбранную по умолчанию, и щелкните Next >.
На шаге Form Page:
В полях Page Name, Region Title введите Создать/Редактировать Работника. Щелкните Next >.
В поле Primary Key Type выберите Select Primary Key Column(s), а затем в поле Primary Key Column 1 выберите EMPLOYEE_ID и щелкните Next >.
В Define the source for the primary key columns выберите Existing Sequence, а в появившемся внизу поле Sequence выберите EMPLOYEES_SEQ (EMPLOYEES_SEQ – это объект БД «сиквенс» (последовательность), предназначенный для генерации уникальных числовых значений, которые используются в качестве значений суррогатных идентификаторов). Щелкните Next >.
В списке Select Column(s) выберите все столбцы и щелкните Next >. Эти столбцы появятся в форме Создать/Редактировать Работника.
В блоке Identify Process Options оставьте все как есть (значения Yes для операций Insert, Update и Delete) и щелкните Next >. Это позволит пользователям добавлять, изменять и удалять записи о работниках.
На шаге Confirm проверьте выбранные атрибуты страниц формы и отчета и щелкните по кнопке Create.
Запустите созданную страницу. Отобразится отчет Работники:
Обратите внимание на следующие моменты:
Выбранная иконка редактирования появляется в каждой записи. Иконка представляет собой ссылку, щелчок по которой приводит к переходу на страницу формы Создать/Редактировать Работника, в которой можно изменить запись о работнике.
В правом верхнем углу мастером была создана кнопка Create (не видна на рисунке), щелчок по которой также приводит к переходу на страницу формы Создать/Редактировать Работника, на которой можно создать запись о новом работнике в таблице EMPLOYEES.
Отчет Работники включает в себя выбранные столбцы. Oracle APEX на основе этого выбора создал соответствующий SQL-запрос, который возвращает эти данные.
Для того чтобы просмотреть форму для редактирования, которая была создана вместе с отчетом, щелкните по иконке редактирования в какой-либо записи отчета Работники. Появится форма Создать/Редактировать Работника:
Обратите внимание на следующие моменты:
Форма содержит кнопки Cancel, Delete и Apply Changes (на рисунке не показаны).
Обязательные столбцы (на которые в БД наложено ограничение целостности Not Null) выделены цветом (это видно, когда структура таблиц БД создается в APEX).
Рядом с полем Hire Date отображается иконка календаря  , т.к. тип данных соответствующего столбца – DATE. Щелчок по этой иконке приводит к появлению окна с календарем.
4. Выполнение расчетов в отчете
Далее выполним модификацию отчета о работниках:
создадим PL/SQL функцию, которая вычисляет зарплату работника;
добавим столбец «Зарплата/Год» для отображения результатов этих вычислений в отчете о работниках,
восстановим в столбце иконку редактирования и ссылку на страницу Создать/Редактировать Работника,
назначим всем столбцам русскоязычные заголовки и изменим формат вывода числовых столбцов.
4.1. Вычисление зарплаты работника
Перейдите на домашнюю страницу приложения и щелкните по иконке SQL Workshop, а затем SQL Commands. Появится окно, в котором Вы можете запускать SQL и PL/SQL код в БД.
Введите следующий скрипт:
CREATE OR REPLACE FUNCTION calc_remuneration(
salary IN number, commission_pct IN number) RETURN NUMBER IS
BEGIN
RETURN ((salary*12) + (salary * 12 * nvl(commission_pct,0)));
END;
/
Этот PL/SQL код создает функцию calc_remuneration, принимающую входные (IN) числовые (number) параметры salary (размер месячного оклада) и commission_pct (комиссионный процент) и возвращающую число. Функция вычисляет размер годового вознаграждения работника с учетом процентов.
Обратите внимание на функцию nvl, которая проверяет значение первого параметра на null и в случае, если первый параметр равен null, возвращает значение второго параметра. Это важно в данном случае, т.к. результатом любых арифметических операций со значением null является null. А в данном случае, используя nvl, мы интерпретируем неопределенное значение комиссионного процента (отсутствие комиссионного процента у работника) как значение = 0.
Щелкните по кнопке Run. В окне Results отобразится сообщение «Function created.»
4.2. Добавление столбца с годовой зарплатой
Откройте страницу Page Rendering для страницы Работники:
В секции Regions щелкните по ссылке Работники. Появится раздел Region Definition.
В секции Source проанализируйте имеющийся там автоматически сгенерированный код:
select "EMPLOYEE_ID",
"FIRST_NAME",
"LAST_NAME",
"HIRE_DATE",
"SALARY",
"COMMISSION_PCT"
from "#OWNER#"."EMPLOYEES"
Обратите внимание на следующие моменты:
В запрос включены столбцы, выбранные при создании отчета с помощью мастера.
#OWNER# – подстановочная строка (substitution string), представляющая имя схемы, с которой ассоциировано приложение и в которой содержатся необходимые таблицы.
Замените код запроса на следующий:
SELECT "EMPLOYEE_ID" "Emp_Id",
"FIRST_NAME",
"LAST_NAME",
"HIRE_DATE",
"SALARY",
"COMMISSION_PCT",
calc_remuneration(salary,commission_pct) "Зарплата/год"
FROM "#OWNER#"."EMPLOYEES"
Обратите внимание на следующие моменты:
В запрос добавился вызов созданной ранее функции calc_remuneration, которой передаются значения столбцов SALARY и COMMISSION_PCT.
Для столбца EMPLOYEE_ID и столбца с функцией calc_remuneration установлены синонимы, соответственно, «Emp_Id» и «Зарплата/год» .
Щелкните Apply Changes.
Чтобы просмотреть новую страницу отчета Работники, щелкните иконку Run в правом верхнем углу:
Обратите внимание на следующие моменты:
Появился новый столбец Зарплата/год.
Пропала иконка  со ссылкой на страницу Создать/Редактировать Работника. Это произошло потому, что изменилось название столбца, с которым была ассоциирована ссылка на страницу редактирования записи о работнике (мы установили синоним Emp_Id для столбца EMPLOYEE_ID).
Столбцы отчета имеют англоязычные названия (кроме Зарплата/Год, которому мы установили русскоязычный синоним в запросе).
Столбец со значением идентификатора работника отображается предпоследним в отчете.
4.3. Восстановление иконки редактирования
Теперь восстановим в столбце Emp_Id иконку и ссылку на страницу
Создать/Редактировать Работника:
На странице определения страницы Работники в секции Regions щелкните по ссылке Работники. Откроется новое окно, в котором выберите опцию Report Attributes.
В секции Column Attributes найдите атрибут Emp_Id и с помощью кнопки  переместите его в начало списка.
У атрибута Emp_Id щелкните по иконке слева. Откроется страница редактирования атрибута-столбца Emp_Id.
В секции Column Link:
В поле Link Text установите текст, представляющий собой html-тэг для отображения необходимой иконки (щелкните по ссылке [Icon 5]);
В поле Page из выпадающего списка выберите страницу Создать/Редактировать Работника. Соответствующий номер страницы автоматически установится в поле;
В списке параметров ссылки для параметра Item 1 установите следующие значения: в поле Name – P?_EMPLOYEE_ID (напомним, что ? – номер страницы в приложении), в поле Value - #Emp_id#. Сделать это лучше, щелкнув по иконкам-ссылкам Find Item  и Pick Column и выбрав необходимые значения из списков. Значение P?_EMPLOYEE_ID – это имя скрытого поля (item) на странице ?_Создать/Редактировать Работника, представляющего идентификатор работника. Значение #Emp_Id# – это подстановочная строка, вместо которой APEX подставит выбранное пользователем значение столбца Emp_Id (в котором содержится идентификатор работника) из отчета Работники.
Щелкните по кнопке Apply Changes в верхней части страницы. Вы вернетесь на страницу Report Attributes. Обратите внимание, что в списке столбцов отчета у столбца Emp_Id появилась пометка Link, которая говорит о том, что с этим столбцом ассоциирована ссылка.
4.4. Русификация заголовков и форматирование полей
Установите для каждого столбца в поле Heading русскоязычные названия:
В Column Alignment установите right для столбцов SALARY, COMMISSION_PCT и Зарплата/год.
Для того чтобы отредактировать формат столбца SALARY:
Щелкните по иконке слева от него.
На странице редактирования атрибута-столбца SALARY найдите секцию Column Attributes и в поле Number/Date Format выберите из списка 5,234.10. Соответствующая форматная маска будет подставлена в данное поле.
Щелкните по кнопке Apply Changes.
Повторите предыдущий шаг для столбца Зарплата/Год.
Примените изменения.
Запустите страницу отчета Работники:
Обратите внимание на следующие моменты:
Восстановлена иконка со ссылкой на страницу Создать/Редактировать Работника.
Все столбцы отчета имеют русскоязычные заголовки.
Столбцы Оклад/Месяц и Зарплата/Год отображаются в денежном формате.
Установите русскоязычные названия столбцов (в поле Heading) для страницы Подразделение.
Задание к работе:
Создайте приложение с именем, соответствующим своей фамилии в транслитерации.
Проделайте все описанные действия со своими данными. При этом все промежуточные результаты через кнопку PrintScreen сохранять в отдельном файле:
Результат решения задачи 1.
Видоизмененный отчет о подразделениях из задачи 2.
Отчет о работниках и форма из задачи 3.
Отчет о работниках с зарплатой за год – из задачи 4.
Покажите результат преподавателю.
|
