Oracle apex инструкция на русском

Продолжение туториала.
В этой части описаны процессы создания приложения Oracle APEX и создания страниц в приложении.

Предыдущая часть: Туториал по Oracle Application Express. Обзор IDE

Оглавление

Создание приложения
    Страницы, создаваемые по умолчанию
    Запуск приложения
    Создание страниц
Основные компоненты страниц
    Визуальные элементы
    Невизуальные элементы
Основные свойства элементов
    Общие свойства
    Свойства страниц

Создание приложения

Чтобы создать приложение, нужно зайти в App Builder и нажать кнопку «Create».

Далее запустится мастер создания приложения. На первом шаге нужно выбрать «New Application», на втором — достаточно заполнить поля «Name» («Название») и «Application ID» (номер приложения). Название нужно просто потому, что это обязательное для заполнения поле, а Application ID — потому что потом поменять его будет нельзя. Точнее можно (через экспорт/импорт), но это долго и нудобно, лучше сразу задать нужный номер, если автоматически сгенерированный апексом не устраивает. Номер должен быть уникальным. Этот номер используется как часть адреса приложения. Посмотрим на типичный URL апекса:

https://apex.oracle.com/pls/apex/f?p=123456:1:14675052744498:::::

Здесь 123456 — это ID приложения.
На остальные поля в мастере можно пока не обращать внимания, все эти настройки можно будет поменять позже.
После этого нужно нажать «Create Application», апекс создаст приложение и автоматически переместит вас на страницу приложения, где вы увидите

Страницы, создаваемые по умолчанию

По умолчанию апекс создаст 3 страницы в приложении. Страницы, так же как и приложения, имеют номер и название. Номер точно так же используется в URL для идентификации страницы, он идет сразу за номером приложения и отделяется от него двоеточием. То есть формат такой:

https://apex.oracle.com/pls/apex/f?p=APPLICATION_ID:PAGE_ID:<остальная часть url>

Созданные по умолчанию страницы — это:

• Global page (ID страницы: 0)
  Это специальная страница, которая не используется самостоятельно, но на которую можно добавить какой-нибудь элемент, если нужно, чтобы он отображался на всех страницах.

• Home page (ID страницы: 1)
  Это стартовая страница приложения. На нее вы будете попадать по умолчанию после того, как введете логин и пароль в приложении, или если вы укажете URL вашего приложения без указания страницы и всего остального, то есть вот так:

  https://apex.oracle.com/pls/apex/f?p=123456

• Login page (ID страницы: 9999, в версиях 4.х, 5.х был 101)
  Это, очевидно, страница логина. Она содержит поля для ввода логина и пароля, с некоторых пор (затрудняюсь назвать версию, но относительно недавно) — галочку «Remember username», и кнопку «Sign In».

Приложения и страницы имеют также полезное свойство Alias. Для приложения это свойство настраивается в свойствах приложения («Application Properties» — «Definition» — «Name» — «Application Alias»), а для страницы — в редакторе страниц в панели свойств справа. Alias можно использовать в URL страницы вместо номера. Страница логина по умолчанию создается с алиасом LOGIN_DESKTOP, а домашняя страница — с алиасом HOME. Если задать приложению алиас MY_APP, то на страницу логина можно будет зайти по адресу

https://apex.oracle.com/pls/apex/f?p=MY_APP:LOGIN_DESKTOP

Запуск приложения

Теперь, когда приложение создано, его уже можно «запустить» (только смотреть там пока не на что). Это не совсем тоже самое, что запуск обычного приложения (как в Windows или в Linux). Приложение апекса рендерится тем же движком, что и сама IDE, так что как только вы создали приложение, оно мгновенно готово к использованию, и любой человек, который введет его адрес в адресную строку, сможет с ним работать. Сам запуск приложения, фактически, — это просто такое название для открытия стартовой страницы (той, которая с номером 1). Запустить приложение можно многими способами:

• в App Builder в списке приложений есть столбец «Run» с кнопкой напротив каждого приложения;
• на странице приложения есть большая кнопка «Run Application»;
• можно «запустить» не только приложение, но и любую недиалоговую страницу (диалоговые можно только вызвать с обычных страниц): в списке страниц приложения тоже есть столбец с кнопкой «Run»;
• можно запустить текущую страницу из редактора страниц, нажав на кнопку в верхнем правом углу;
• и, наконец, можно запустить страницу, если в верхнем правом углу есть такие кнопки:

Эти две кнопки есть почти в любом разделе IDE. Левая содержит номер последней страницы, которую вы открывали в редакторе страниц. Нажав на нее, вы перейдете к редактированию этой страницы, а нажав на правую кнопку, вы запустите эту страницу.
Что случится после запуска? Если запускаемая страница имеет ограниченный доступ, сначала пользователь будет перенаправлен на страницу логина. Если пользователь уже залогинен, или страница с настройках обозначена как общедоступная, то откроется сама эта страница.
По умолчанию страница создается с ограниченным доступом. В свойствах страницы (Редактор страниц — правая панель — группа свойств «Security» — «Authentication») есть две возможные настройки:

• Page Requires Authentication: страница будет доступна только залогиненным пользователям в течении сессии;
• Page is Public: общедоступная страница, видна зарегистрированным и незарегистрированным пользователям.

Создание страниц

Создать страницу можно на странице приложения. Нажмите «Create», после чего запустится мастер создания страниц. Шаги мастера:

1. Выбор типа страницы из (на данный момент) 12 типов, некоторые из которых имеют еще и подтипы (если они есть, то появятся на следующем шаге). Первый тип из списка — «Blank page», то есть пустая страница без всего. Остальные типы — это часто встречающиеся варианты страниц для работы с БД: отчеты, формы ввода, графики и т. п. Здесь я опишу процесс создания пустой страницы, а по остальным типам будет отдельная статья.
2. Ввод номера и названия страницы. О номерах я говорил выше; номер задается на этом шаге и потом изменить его будет нельзя, так что смотрите внимательно. Иногда разработчики разбивают страницы на группы (по функциональному назначению, например), и за каждой группой резервируют диапазон номеров, так что если у вас в проекте такое используется, будьте внимательны. Тут же нужно выбрать тип страницы: обычная, модальный диалог, немодальный диалог.
3. Настройка элементов навигации. Можно пропустить (нажать «Next») и настроить потом (хотя если у вас уже выстроена какая-то система навигации, удобно сразу задать всё на этом шаге и больше не париться).
4. Подтверждение создания.

После этого страница создана и готова к использованию.

Основные компоненты страниц

Визуальные элементы

Визуальные элементы — это элементы, которые так или иначе отображаются на экране. Это:

• Верхнее меню. Содержит название приложения, логотип, имя пользователя, ссылку «Logout» (если пользователь залогинен). Туда же можно добавлять другие элементы;
• Меню навигации слева. Можно использовать для навигации по приложению, сделав, например, иерархическую структуру разделов приложения;
• Regions (обычно по-русски их так и называют — «регионы»): контейнеры элементов. Могут содержать в себе отчеты, графики, поля для ввода, кнопки и другие регионы;
• Items (устоявшегося перевода на русский нет, называют кто во что горазд, обычно используют слова item, поле и часто просто итем): это разнообразные поля для пользовательского ввода;
• Buttons (кнопки): ну, это обычные кнопки, короче, что тут еще сказать
• Отчеты: таблицы с данными на основе SQL запросов;
• Графики/диаграммы: графическое отображение информации из БД, также на основе SQL запросов.

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

Невизуальные элементы

Это элементы для обеспечения логики работы приложения. Там на самом деле огромное разнообразие элементов, хотя пользователю их и в буквальном смысле не видно. Основные типы:

• Process (процесс): как правило, PL/SQL код, выполняемый на сервере в ответ на какое-либо действие пользователя;
• Validation (валидация): разновидность процессов для проверки пользовательского ввода;
• Dynamic Action (нет устоявшегося перевода, обычно все так и пишут — Dynamic Action или просто DA, а когда лень раскладку переключать, могут написать динамик экшен или ДА): процесс, выполняемый браузером. В конечном счете DA — это обработчик какого-либо события javascript. Знать javascript необязательно, но если знать (а заодно и CSS селекторы) — можно творить чудеса;
• Branches (нет устоявшегося перевода): редиректы на другие страницы в зависимости от некоторых условий.

Основные свойства элементов

Общие свойства

Основные свойства, характерные для каждого (или почти каждого) типа элементов. Их можно смотреть и изменять в редакторе страниц, там они собраны в группы. Здесь я вкратце опишу их назначение (так что вы будете знать, что где искать), а более подробно расскажу в других статьях.

• Identification: задает название элемента и дополнительные совйства (в зависимости от типа);
• Appearance: свойства, отвечающие за внешний вид визуального элемента. Для каждого типа элементов существует набор шаблонов, вы можете выбрать один из них здесь (свойство Template). Также шаблоны имеют дополнительные настройки (Template Options — по нажатию на кнопку откроется окно с настройками);
• Layout: настройка положения визуального элемента на странице. Элементы располагаются в сетке из 12 колонок, здесь можно указать, как именно они должны располагаться;
• Source: у регионов и итемов — источник данных для отображения, у процессов — код процесса;
• Server-side Condition: условие, проверяемое на сервере (есть огромный выбор условий, от простых, типа такой-то элемент имеет такое-то значение, до произвольного PL/SQL кода). Элемент будет отображаться на странице, если это условие выполняется, а если нет — то не будет. Причем он будет не скрыт, а просто не отрендерится;
• Client-side Condition(у Dynamic Action): условие, проверяемое на клиенте (без обращения к серверу). DA будет выполнено, если условие выполняется;
• Read only: работает так же, как и Server-side Condition, только управляет не наличием/отсутствием элемента, а возможностью менять значение. Это свойство есть у итемов, регионов и страниц. У итема оно применяется к самому итему, а у регионов/страниц — ко всем итемам внутри соответствующего региона/страницы;
• Security: управление доступом к элементу. В принципе, все тоже самое можно сделать и с помощью Server-side Condition, но лучше разграничить: Server-side Condition — для логики приложения, Security — для отображения в зависимости от прав доступа.
• Configuration: для включения/выключения Build Option. Очень неочевидная вещь, но очень полезная: позволяет включать и выключать отдельные фичи приложения, что очень удобно, когда вы разрабатываете параллельно фичи для нескольких разных релизов;
• Comments: комментарии для других разработчиков;
• Help (у визуальных элементов): справка для конечных пользователей приложения.

Свойства страниц

Свойства, характерные только для страниц:

• Navigation: в этой группе два свойства. Cursor Focus указывает, передавать ли фокус полю для ввода на странице сразу после заргузки (варианты — либо не передавать, либо передавать первому полю на странице). Warn on Unsaved Changes не дает пользователю уйти со страницы, если там есть несохраненные данные;
• JavaScript: позволяет добавить JavaScript код на страницу. Можно указать путь к файлу или добавить свой код прямо на страницу;
• CSS: то же самое для CSS. Подключить файл или добавить на страницу, если нужная какая-то локальная настройка CSS только для этой страницы;
• Advanced: позволяет включить или отключить защиту от повторной отправки формы.

Информация о материале

Категория: Статьи

Опубликовано: 29 мая 2017

Просмотров: 20023

В этой статье описываются три типа отчетов апекса: Classic Report, Interactive Report (IR) и Interactive Grid (IG). Classic Report — самый простой из них, но в сочетании с другими компонентами позволяет делать достаточно неожиданные вещи. IR и IG обладают намного более широкими возможностями из коробки, но это в значительной степени вещи в себе. С одной стороны, их широкие возможности делают ненужным какой-то дополнительный тюнинг, с другой, эти же возможности довольно жестко ограничивают возможность сделать что-то дополнительно. Многое из того, что применимо к Classic Report, применимо и к ним тоже.

Оглавление

Classic Report
    Дополнительное форматирование данных
        Форматирование с помощью свойств столбцов
        Форматирование путем изменения шаблона
    Добавляем интерактива
        События вида «клик на строке отчета»
        Изменение данных с помощью Classic Report
Interactive Report (IR)
Interactive Grid (IG)
    Создание столбцов не через SQL
    Новые типы столбцов
    Master-Detail отчеты на основе IG
    Обработка ввода данных в IG

Classic Report

Создать отчет можно двумя способами. Первый — создать вместе со страницей, через мастер создания страниц: выбрать тип страницы «Report», далее — подтип «Classic Report», далее пройти шаги мастера для задания свойств страницы, и последний шаг — указать источник данных. Будет создана новая страница с одним отчетом, на которую, при желании, можно потом добавить что-нибудь еще. Этот способ имеет скорее историческую ценность, до появления современного Page Designer в версии 5.0 так было действительно проще.

Второй способ — на уже созданной странице в Page Designer в левом меню на закладке «Rendering» (она там первая) найти ветку «Regions«, кликнуть на ней правой кнопкой и выбрать «Create Region«. Далее нужно указать в группе свойств «Identification» на правой панели: «Title» — заголовок, под которым отчет будет отображаться на странице, и «Type» — «Classic Report«; в группе «Source«: «Location» — «Local Database» (относительно новое поле, в 5.х его не было), «Type» — «SQL Query«, «SQL Query» — собственно запрос. Этого достаточно.

create table students as
select id, name, surname, 
       trunc(sysdate - dbms_random.value(18 * 365 - 180, 18 * 365 + 180)) birthdate, 
       trunc(sysdate - 8) examdate, 
       trunc(50 + dbms_random.value * 50) rating
  from (select 1 id, 'Маша' name, 'Иванова' surname from dual union all
        select 2 id, 'Петя' name, 'Балалайкин' surname from dual union all
        select 3 id, 'Коля' name, 'Водкин' surname from dual union all
        select 4 id, 'Вася' name, 'Петров' surname from dual union all
        select 5 id, 'Катя' name, 'Медведева' surname from dual union all
        select 6 id, 'Ира' name, 'Сидорова' surname from dual union all
        select 7 id, 'Виктор Степанович' name, 'Победоносцев' surname from dual);

 select id, name, surname, birthdate, examdate, rating, rn, 
        case when rn <= 3 then 'highrating' else '' end color,
        apex_item.checkbox(1) chbx
   from (select id, name, surname, birthdate, examdate, rating, 
                row_number() over (order by rating desc) rn
           from students)
  order by id

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

Здесь есть три основных раздела:

• раздел, названием которого является «Title» региона: там настраиваются свойства региона;
• «Columns«: список столбцов, для каждого доступны свои настройки;
• «Attributes«: свойства самого отчета, то есть конкретно таблички с данными (не знаю, кто как, а я поначалу долго путался, где свойства региона, а где — отчета; в частности, и регион, и отчет имеют каждый свой «Template«, и если вы «Template» поменяли, а вид отчета/региона не изменился, проверьте, не перепутали ли вы их друг с другом).

Базовые возможности Classic Report:

• Выравнивание (по левому краю, по центру, по правому краю) заголовков столбцов и данных в столбцах, задание маски формата для чисел и дат;
• Сортировка: если указать в свойствах столбца «Sortable» — «Yes«, то на странице заголовок этого столбца будет представлен ссылкой, по клику на которую будет происходить сортировка. Вы можете сортировать данные либо добавлением «Order by» в запрос, либо настройкой сортировки в свойствах столбцов, но нельзя делать и то, и другое вместе;
• «Pagination«: можно указать количество строк на страницу («Attributes» → «Number of Rows«) и настроить вид селектора страницы (несколько вариантов на выбор). Также обратите внимание на параметр «Maximum Rows to Process«: он задает, сколько строк запроса попадет в итоге в таблицу. Все сортировки, «Pagination» и прочее будет применяться к этому количеству строк. Если ваш запрос, как предполагается, может/должен возвращать больше, увеличьте это число;
• «When No Data Found«: когда запрос возвращает 0 строк, таблица не показывается вообще (даже заголовок, это особенность движка), а в этом разделе можно задать сообщение, которое будет выведено вместо таблицы с результатом;
• Выгрузка данных в CSV: настраивается в разделе «Download«.

У столбцов есть поле «Type», в котором можно выбрать один из нескольких вариантов отображения результата:

• «Plain Text»: это вариант по умолчанию — просто результат из запроса.
• «Plain Text (based on List of Values)»: если у вас в результатах запроса есть поле, ссылающееся на таблицу-справочник, можно подставить значение из справочника с помощью этого поля (но лучше, конечно, просто приджойнить его в самом запросе).
• «Link»: позволяет сделать ссылку. О ссылках будет отдельная статья.
• «Display Image» и «Download BLOB»: эти типы позволяют получить доступ к файлам, которые хранятся в таблице в столбце типа BLOB. Первый отображает файл в виде картинки (если это картинка, конечно), а второй — отображает ссылку для скачивания.
• «Percent Graph»: отображает число от 0 до 100 как картинку с прогресс-баром.
• «Hidden Column»: используется, когда значение из запроса — это что-то вспомогательное (например, для форматирования), но на экране отображаться не должно.

Дополнительное форматирование данных

Форматирование с помощью свойств столбцов

Рассмотрим пример, в котором у нас есть список учащихся, сдающих некий экзамен (SQL запрос был приведен выше). У нас есть табличка с результатами, и мы хотим выделить три лучших результата красным цветом и жирным шрифтом. На помощь нам приходят настройки столбца «Column formatting«. Когда апекс рендерит отчет, он создает HTML таблицу, и в ее ячейки (<td></td>) помещает значения из результатов запроса. Свойство «HTML Expression» позволяет задать вместо этого произвольный HTML код. Если оно пустое, апекс поместит внутрь тега td значение из запроса, а если непустое — то содержание свойства. В выражении «HTML Expression» можно использовать ссылки на значение какого-либо столбца запроса, для этого нужно заключить его название между двух символов #. В запросе в моем примере есть столбцы «RATING» (результат, который нужно показать), и «COLOR» (в нем вычисляется имя CSS-класса, который будет задавать стиль подсветки, в зависимости от значения столбца «RATING«). В свойстве «HTML Expression» столбца «RATING» нужно написать:

<span class="#COLOR#">#RATING#<span>

А сам CSS-класс highrating можно описать в свойствах страницы («CSS» → «Inline«):

.highrating {
  color: red;
  font-weight: bold;    
}

Всё готово. Если теперь открыть страницу, вы увидите выделенные красным три самых высоких результата.

И конечно, данную задачу можно решить множеством альтернативных способов. Например, не использовать CSS-классы, а вычислить в SQL запросе цвет и вставить его в атрибут style, или описать нужный CSS-класс в шаблоне страницы или отчета. Существует множество вариаций, выбирайте, кому что ближе.

Примечание: чтобы скрыть все дополнительные столбцы, используемые для форматирования или каких-то промежуточных вычислений, в свойствах столбца «Identification» → «Type» выберите «Hidden Column«.

Форматирование путем изменения шаблона

У форматирования с помощью свойств столбца есть один недостаток: никак нельзя повлиять на формат самой ячейки, то есть тега td. Из-за этого, например, не получится сделать полную заливку ячейки каким-либо цветом (потому что в стандартных апексовых CSS-файлах у ячейки таблицы ненулевой padding, и внутри будет белая рамка).

Возьмем тот же пример, что и выше, и добавим выделение желтым цветом для строк с тремя самыми лучшими результатами.

Для этого нужно сделать следующие шаги:

1. Отправляемся в «Shared Components» → «User Interface» → «Templates«, в появившемся списке шаблонов кликаем на заголовок столбца «Type«, и в появившемся списке значений выбираем «Report«. Теперь находим шаблон «Standard» (он используется по умолчанию) и в самом правом столбце списка («Copy«) кликаем на кнопку, чтобы создать копию шаблона. В появившемся окне даем шаблону название, например, «Standard with highlight».

2. Открываются свойства шаблона. На закладке «Column Template» в поле «Column Template 1» содержится что-то вроде такого:

   <td class="t-Report-cell" #ALIGNMENT# headers="#COLUMN_HEADER_NAME#">#COLUMN_VALUE#</td>

   Это шаблон ячейки в том виде, как он используется сейчас. На этой закладке можно задать до четырех альтернативных шаблонов ячейки, выбор между которыми будет осуществляться в зависимости от результата вычисления условия каждого из шаблонов. У нас в запросе есть поле RN — порядковый номер результата (то есть лучший результат имеет номер 1, следующий — 2, и так далее), здесь мы будем использовать его. Первый шаблон (по условию задачи) должен применяться только к строкам, в которых значение столбца RN больше трёх. В свойствах шаблона в поле «Column Template 1 Condition» выбираем «Use Based on PL/SQL Expression«, а в поле «Column Template 1 Expression» пишем:

   :RN > 3

   И остается только добавить альтернативный шаблон (в поле «Column Template 2«):

   <td class="t-Report-cell highlighted" #ALIGNMENT# headers="#COLUMN_HEADER_NAME#">#COLUMN_VALUE#</td>

   Здесь к стандартному классу ячейки (td) добавлен класс highlighted. Теперь осталось нажать на кнопку «Apply Changes».

3. Возвращаемся в Page Designer. Находим наш отчет, в свойстве «Attributes» → «Appearance» → «Template» выбираем из списка наш новый шаблон «Standard with highlight».
4. Как и в предыдущем примере, в свойствах страницы («CSS» → «Inline«) описываем наш новый класс highlighted:

.highlighted {
    background-color: lightyellow !important;
}

Сохраняем страницу, проверяем результат (он должен быть как на картинке в начале статьи).

Добавляем интерактива

События вида «клик на строке отчета»

Одна из часто встречающихся задач — определить номер строки, на которую кликнул пользователь. За события в браузере в апексе отвечают компоненты Dynamic Action (DA). К сожалению, несмотря на большое количество самых разных их видов, типового DA для обработки клика на строке отчета нет. Но его относительно просто сымитировать. В качестве примера сделаем Master-Detail отчет из двух Classic Report на основе отчета из предыдущего раздела.
Вторым отчетом здесь будет выступать таблица с номерами телефонов. По клику на первой таблице она будет обновляться и показывать номер телефона выбранного человека (причем без перезагрузки страницы!). Для этого отчета создадим еще один регион типа «Classic Report».

with phone as (
    select 1 id, '1684313' phone_num from dual union all
    select 2, '6843513' from dual union all
    select 3, '8916311' from dual union all
    select 4, '6843213' from dual union all
    select 5, '6513218' from dual union all
    select 6, '9561311' from dual union all
    select 7, '9843135' from dual)
select phone_num
  from phone
 where id = :P2_ROW_ID

Необходимые составляющие решения:

1. Способ идентификации выбранной пользователем строки. Для этой цели подойдет столбец ID. К сожалению, если этот столбец пометить как скрытый (очень часто лишние айдишники не показывают пользователю, чтобы не перегружать интерфейс), он не будет рендериться движком вообще, и эти данные никак не будут присутствовать на странице. Но их можно добавить к существующему столбцу тем же способом, что использовался для форматирования вывода. Возьмем какой-нибудь столбец (например, первый из видимых) и в поле «Column formatting» → «HTML Expression» напишем:

   <span class="click" data-id="#ID#"></span>#NAME#

   Можно этот код и прямо в SQL запрос вставить, но лучше не надо

   Есть другой вариант сделать то же самое — добавить этот HTML код прямо в запрос:

   select id, '<span class="click" data-id="' || id || '"></span>' || name as name from ...

   Результат в целом будет тот же, но перестанет работать сортировка по полю name, потому что движок СУБД будет считать всю эту строку данными и сортировать по ней. А если делать через «Column formatting«, то данные, по которым будет делаться сортировка, не будут содержать ничего лишнего.
   К тому же, в этом случае для вывода HTML кода в столбце вам придется отказаться от экранирования спецсимволов, а это еще и потенциальная дыра в безопасности.

2. Идентификатор отчета (на случай, если на странице таких отчетов больше одного). У региона есть свойство «Advanced» → «Static ID«, поместим туда значение my_rep. Значение этого свойства используется в HTML коде страницы. Элемент div, который содержит регион, получит атрибут id с этим значением. Если поле «Static ID» пустое, апекс будет использовать для атрибута id идентификатор региона из системных таблиц. На него лучше не полагаться, потому что при переносе приложения на другой сервер этот идентификатор может поменяться практически гарантированно изменится.
3. Итем для временного хранения значения ID выбранной строки. Создадим итем P2_ROW_ID с типом «Hidden» (это название, как вы могли видеть, используется в запросе, возвращающем список телефонов).

4. Далее нужно создать Dynamic Action. Открываем Page Designer, в левой панели на закладке «Dynamic Actions» находим ветку «Click», кликаем на ней правой кнопкой, выбираем в меню «Create Dynamic Action». Далее нужно заполнить следующие свойства DA:

   • «Identification» → «Name«: какое-нибудь осмысленное имя, иначе вы потеряетесь в этих бесконечных «New», «New2», «New3» и т. д.;
   • «When» → «Selection Type«: «jQuery Selector«;

   • в появившемся далее поле «jQuery Selector«: здесь можно указать селектор, который будет указывать на дополнительный невидимый span с идентификатором строки:

     #my_rep table.t-Report-report tr

Далее у этого DA создадим действия («True Actions«):

• Первое действие получает ID выбранной строки и сохраняет его в итем. Нужно установить следующие значения свойств: «Action» — «Set Value«, «Set Type» — «JavaScript Expression«, «JavaScript Expression» — следующий код:

      this.triggeringElement.querySelector('span.click').dataset.id

  В свойстве «Affected Elements» → «Selection Type» выбрать «Item(s)«, в свойстве «Item(s)» указать итем P2_ROW_ID.

• Второе действие отправляет на сервер значение итема. Свойства: «Action» — «Execute PL/SQL Code«, «PL/SQL Code» — просто null;, «Items to Submit» — P2_ROW_ID (собственно, всё это действие нужно ради отправки значения итема на сервер — более простого способасделать это нет; как вариант, вместо этих двух Actions можно сделать одно с голым джаваскриптом внутри, который и значение вычислит, и на сервер отправит — и это будет даже не сильно сложнее).
• Третье действие обновляет второй (Detail) отчет. Свойства: «Action» — «Refresh«, «Affected Elements» → «Selection Type» — выбрать «Region«, в «Region» выбрать второй регион с телефонами.

На этом всё. Если вы сделали все эти шаги и ничего не пропустили, у вас на странице будут два отчета, и при клике на любой строке первого отчета второй будет обновляться и показывать данные выбранного человека.

Изменение данных с помощью Classic Report

В апексе с древних версий существовал вид отчета, известный как Tabular Form (он и сейчас в принципе существует, хотя и помечен как Legacy), который позволял изменять данные в нескольких строках таблицы сразу. На смену ему пришел намного более мощный Interactive Grid. Здесь же я продемонстрирую, как из подручных средств можно собрать аналог теплого лампового Tabular Form. Возьмем ту же таблицу, что и в прошлом примере, и добавим возможность редактировать имя и фамилию человека.
Для редактирования данных, количество которых заранее неизвестно даже приблизительно, нам понадобятся пакеты APEX_ITEM и APEX_APPLICATION. Первый позволяет создавать любые итемы в рантайме (созданием, в данном случае, является генерация соответствующего HTML), а второй — получать доступ к данным, введенным в созданные в рантайме поля.
Рассмотрим на примере функции APEX_ITEM.TEXT (она возвращает HTML код простого текстового инпута). Вот как объявлена эта функция в документации:

APEX_ITEM.TEXT(
    p_idx         IN    NUMBER,
    p_value       IN    VARCHAR2 DEFAULT NULL,
    p_size        IN    NUMBER DEFAULT NULL,
    p_maxlength   IN    NUMBER DEFAULT NULL,
    p_attributes  IN    VARCHAR2 DEFAULT NULL,
    p_item_id     IN    VARCHAR2 DEFAULT NULL,
    p_item_label  IN    VARCHAR2 DEFAULT NULL)
    RETURN VARCHAR2;

Параметры начиная со второго описывают, что будет содержать HTML код: значение в поле для ввода, дополнительные атрибуты, ограничения на длину и т. п. Самый важный в нашем случае параметр — первый (он же единственный обязательный, остальные имеют дефолтные значения). Этот параметр может принимать значения от 1 до 50, и потом введенное здесь число будет использоваться для доступа к данным, введенным пользователем. Каждому числу соответствует PL/SQL коллекция APEX_APPLICATION.G_FXX, где XX — это 01, 02,… 50.
Для нашей задачи нужны три поля таблицы: id, name, surname. Первое должно быть скрытым, второе и третье — полями для ввода.

1. Создаем отчет на базе SQL запроса:

   select apex_item.hidden(1, id) || apex_item.text(2, name) name, 
            apex_item.text(3, surname) surname, birthdate, examdate
   from students

2. В свойствах столбцов NAME и SURNAME убираем экранирование символов: в «Security» → «Escape special characters» ставим «No«.
3. Создаем кнопку «Save«, настройки можно оставить по умолчанию.

4. Создаем процесс «After Submit» со свойствами: «Identification» → «Type» — «PL/SQL«; «Server-side Conditions» → «When Button Pressed» — кнопка «Save«. И код для сохранения данных в БД:

   begin
     for i in apex_application.g_f01.first .. apex_application.g_f01.last loop
       update students
          set name = apex_application.g_f02(i),
              surname = apex_application.g_f03(i)
        where id = apex_application.g_f01(i);
     end loop;
   end;

Как видите, выглядит совсем просто. Осталось только упомянуть один неприятный подводный камень в работе с APEX_ITEM. Если вы таким образом хотите добавить в отчет чекбоксы:

select ... apex_item.checkbox2(4, id) from students

То у вас в коллекции APEX_APPLICATION.G_F04 окажется столько элементов, сколько чекбоксов отмечено, в то время как во всех остальных коллекциях число элементов будет равно числу строк, отображенных на экране, а в содержимое коллекции попадет значение, которое вы передаете вторым параметром в функцию apex_item.checkbox2. Таким образом, если вы используете коллекцию с данными из чекбоксов в коде, аналогичном приведенному выше, вы можете столкнуться с исключением NO DATA FOUND.

Interactive Report (IR)

Interactive Report — это готовый к применению многоцелевой комбайн, в котором из коробки есть огромное количество функций для работы с данными. Все, что нужно, это включить их в настройках (точнее, не отключать, потому что по умолчанию там почти всё включено). На странице IR выглядит почти как обычный отчет, только над ним есть еще дополнительная панель с полем ввода для поиска и кнопкой «Actions«. Кнопка «Actions» показывает дополнительное меню, из которого доступны все остальные функции. Я только вкратце перечислю возможности:

• Панель поиска: позволяет искать заданный текст во всех столбцах отчета;
• «Actions» → «Columns«: настройка отображения столбцов (порядок следования, скрыть/показать);
• «Actions» → «Filter«: инструменты фильтрации данных, позволяют выбрать поле, операцию фильтрации (больше, меньше, равно, содержит текст, и т. д.);
• «Actions» → «Data«: манипуляции с данными (сортировка, вычисления, агрегирование и Flashback);
• «Actions» → «Format«: настройка отображения данных; позволяет подсвечивать нужные данные (настраиваются цвета подсветки и условия на данные), делать Control Break (не знаю, как это называется по-русски, выглядит это так), выбирать число строк отчета на странице;
• «Actions» → «Chart«, «Group by«, «Pivot«: названия говорят сами за себя — построение диаграмм, графиков, сводных отчетов на основе данных IR;
• «Actions» → «Report«: позволяет конечному пользователю сохранить отчет с определенным именем. В этом случае сохранятся все сделанные настройки из всех пунктов меню, описанных выше, и у каждого пользователя они будут свои;
• «Actions» → «Download«: экспорт данных, поддерживаются 5 форматов: CSV, PDF, XLS, HTML, RTF.

Что из перечисленного выше будет доступно пользователю, настраивается в свойствах отчета: «Attributes» → группы свойств «Search Bar«, «Actions Menu«, «Download«.
К Interactive Report применимо практически все то же самое, что и к Classic Report. Точно так же можно делать собственное форматирование столбцов, использовать HTML элементы в столбцах (отключая при этом экранирование спецсимволов). Также есть дополнительный тип столбца — «Remove HTML«, который убирает HTML теги из результата запроса (я лично ни разу не сталкивался с тем, чтобы это было нужно).
Но есть пара нюансов, на которые стоит сразу обратить внимание.
Во-первых, у IR в атрибутах отчета нет свойства «Template«. То есть если вы разрабатываете своё собственное оформление, CSS-стили и прочее, то вы в пролете — IR будет выглядеть только так, как это заложено в него изначально. Выбирать придется из того, что есть. (Точнее, способ все-таки есть, но такой окольный, что проще считать, что его нет.)
Во-вторых, очень коряво устроена настройка порядка следования столбцов. Поле «Sequence» у столбцов есть, но оно не работает. Чтобы изменить порядок столбцов, вам придется сделать следующее: создать отчет, запустить страницу с ним, открыть меню «Actions» → «Columns» и настроить порядок через него. Далее нужно сохранить: там же в «Actions» → «Report» выбрать «Save Report«, а в появившемся окне выбрать тип «Primary» — тогда текущий вид отчета сохранится для всех пользователей как основной (а чтобы тип «Primary» был доступен, вы должны быть залогинены в IDE как разработчик и запустить страницу из IDE).

Interactive Grid (IG)

Interactive Grid — это логическое продолжение Interactive Report. Впервые он появился в версии 5.1. IG выглядит почти как IR, но в дополнение он имеет режим редактирования, а также несколько дополнительных возможностей. Еще IG имеет богатое javascript API, но публичным оно стало только совсем недавно (версии с 18.2, кажется). По этой причине я не успел с ним достаточно хорошо ознакомиться.

Создание столбцов не через SQL

Если в Classic Report или в Interactive Report столбцы создавались только на основе SQL запроса (столбцов в отчете может быть ровно столько, сколько их есть в SQL запросе), то в IG кроме этих столбцов можно создать дополнительные. Для этого нужно кликнуть правой кнопкой на списке столбцов в левой панели и выбрать пункт «Create Column«. После этого появится столбец, которому можно в свойстве «Source» → «Type» указать «None» (и тогда он будет полностью независим от SQL запроса, на базе которого создан отчет), или указать «Database Column» / «SQL Expression» и заполнить его данными на основе результатов запроса. Это удобно, потому что раньше иногда приходилось делать в запросе дубликат столбца с дополнительными вычислениями. И неудобно при отладке, если злоупотреблять (придется выяснять сначала, какой столбец откуда берется), поэтому лучше не злоупотреблять.

Новые типы столбцов

Новых типов столбцов (по сравнению с IR) добавили очень много. Новые типы:

• «Actions Menu«. Столбец такого типа будет выглядеть как кнопка с иконкой-«бутербродом» (три горизонтальные полоски — кажется, это называется «бутерброд»?). Эта кнопка активирует меню с действиями над строками — добавить, удалить, сделать копию строки и т. д.
• «Checkbox«. Столбец будет показывать чекбоксы, но функционально это будут не такие чекбоксы, как в случае со столбцом типа «Row Selector» (см. ниже). Про то, что из себя представляют чекбоксы в апексе, я расскажу отдельно (там можно много чего рассказать), пока только скажу, что чекбоксы — это не то, чем они кажутся.
• «Color picker«. Натурально, выбор цвета, почти как в фотошопе. Я даже скриншот вам покажу:

• «Row Selector«. Столбец этого типа содержит чекбокс, которым можно выделять строки, а потом, при необходимости, к этим строкам можно обращаться в javascript или PL/SQL коде.
• остальные («Date picker«, «Number field«, «Password«, и куча других) — это дополнительные настройки для ввода данных в режиме редактирования. То есть вместо создания таких полей вручную через пакет APEX_ITEM (как это было в примере для Classic Report) теперь можно указать нужный тип столбца.

При этом почему-то из типов столбцов убрали «Download BLOB«. То есть ссылку на файл не получится сделать так же просто, как это можно было в Interactive Report и даже в Classic Report. И вот тут я не понял — кому этот тип мешал? (Этот пункт тоже можно добавить в раздел «почему я не люблю IG».)

Master-Detail отчеты на основе IG

С IG стало намного проще делать Master-Detail отчеты. Не нужно ничего из того, что описано для Classic Report выше. Код писать больше не нужно, достаточно создать два IG отчета. Далее в Master отчете выбираем столбец, являющийся первичным ключом, и указываем у него это свойство (свойства столбца → «Source» → «Primary Key» указываем «Yes«). В Detail отчете в свойствах отчета находим «Master-Detail» → «Master Region» и в выпадающем списке выбираем нужный регион. Потом находим столбец, который является внешним ключом, в свойствах столбца находим «Master-Detail» → «Master Column» и выбираем из списка нужный столбец. Теперь всё должно заработать. При клике на строке Master отчета данные в Detail отчете будут обновляться.

Обработка ввода данных в IG

И последнее, что хотелось бы сказать об IG — как сделать дополнительную обработку данных, введенных в режиме редактирования. Из коробки IG умеет только вставлять новые строки или изменять/удалять существующие. Теперь, допустим, нужно сделать отчет (на базе таблицы STUDENTS из примера выше) с возможностью редактирования данных и ввода новых строк, а также сделать дополнительную проверку данных: когда пользователь вводит имя и фамилию, нужно убедиться, что первая буква — прописная, а остальные — строчные. Для этого нужно создать IG отчет на базе запроса к таблице STUDENTS:

select id, name, surname, birthdate, examdate
    from students

Сделать его редактируемым («Attributes» → «Edit» → «Enabled«), потом зайти на закладку «Processing«, найти там созданный апексом процесс для сохранения данных IG (по умолчанию он будет называться примерно так: «IG — Save Interactive Grid Data»), и в свойстве «Settings» → «Target Type» указать «PL/SQL Code«, а в появившемся поле «PL/SQL Code to Insert/Update/Delete» написать следующий код:

begin
  :NAME := initcap(:NAME);
  :SURNAME := initcap(:SURNAME);
  case :APEX$ROW_STATUS
    when 'I' then
      insert into students (name, surname, birthdate, examdate)
      values (:NAME, :SURNAME, :BIRTHDATE, :EXAMDATE);
    when 'U' then
      update students
         set name  = :NAME,  
             surname = :SURNAME,
             birthdate = :BIRTHDATE,
             examdate = :EXAMDATE
       where id = :ID;
    when 'D' then
         -- 'D' означает удаление, в случае удаления строк 
         -- тоже какой-то код выполнить можно
     end case;
end;

Этот код будет выполнен для каждой строки отчета. Специальная переменная APEX$ROW_STATUS при этом содержит значения I, U или D (insert, update, delete) в зависимости от того, что происходит с текущей строкой (добавляется новая, изменяется/удаляется старая). Чтобы обратиться к данным столбцов, необходимо следующее (апекс делает это автоматически, вмешиваться практически не нужно): когда вы создаете отчет и указываете имя столбца в SQL-запросе, это имя будет указано потом в качестве источника данных в свойствах столбца отчета, и его же потом нужно использовать в коде выше для получения доступа к обновленным данным. В данном случае, используются столбцы NAME, SURNAME, BIRTHDATE и EXAMDATE.
Также при необходимости можно использовать переменную APEX$ROW_NUM, которая содержит порядковый номер строки, обрабатываемой в данный момент, и APEX$ROW_SELECTOR, которая содержит значение X для строк, выделенных с помощью чекбоксов в столбце типа «Row Selector«.

Автор: StrangerInTheKy

Источник

Недавно я с удивлением обнаружил, что, оказывается, толковых туториалов по Oracle Application Express (он же APEX, он же апекс, но не путать с языком apex, который используется в Salesforce) в природе не существует.

Это не самая распространенная технология, конечно, но, тем не менее, довольно востребованная. Есть десятки блогов об апексе (англоязычные, в основном), пара тысяч вопросов на Stackoveflow, специальный раздел по апексу на официальных форумах оракла, сам апекс существует уже 15 лет и все время развивается. Я был уверен, что и хороших туториалов полно. Но нет!

Мне тут же пришла в голову гениальная мысль восполнить этот пробел.

Оглавление

Почему существующие туториалы — плохие
Вводная информация
Обзор IDE
    App builder
        Страница приложения
        Shared Components
        Page Designer
    SQL Workshop
        Object Browser
        SQL Commands

Почему существующие туториалы — плохие

Я немного поясню, почему я считаю существующие туториалы плохими. Апекс — это не язык программирования, это такой очень высокоуровневый инструмент разработки, ближайшим идейным аналогом которого я бы назвал MS Access. Соответственно, большая часть разработки на апексе состоит из работы с веб-интерфесом этой среды: нажимания на кнопки, перехода по ссылкам, заполнение полей с названиями компоментов, выбора значений из списков и так далее. Что делает типовой туториал? Он показывает скриншоты этих самых экранов с подписями «нажмите туда-то». При этом сама IDE достаточно удобная и понятная, почти все элементы снабжены справочными пояснениями, есть встроенная помощь. В итоге, если нужно объяснить пользователю, как создать приложение, в туториале будет большой скриншот, объясняющий, как нажать на кнопку «Create a new app». Вот, посмотрите сами на официальный оракловый туториал:

Они бы еще объяснили со скриншотами, что «клик» — это однократное нажатие на левую кнопку манипулятора типа «мышь».
Конечно, полезная информация в таких туториалах тоже есть, но ее там крохи. Процентов на 80 туториалы состоят из таких вот скриншотов, причем по своему опыту я могу сказать, что человек, не читавший никаких туториалов вообще, самостоятельно найдет, как создать приложение, добавить страницу, поместить на нее отчет и так далее. А потом ему нужно будет организовать более-менее нетривиальное взаимодействие нескольких элементов апекса, и оказывается, что этот вопрос туториалом почти не покрывается. Приведу аналогию: вы только-только учитесь программировать, изучили переменные, массивы, циклы, условия, и получили задание, в рамках выполнения которого вам нужно отсортировать массив. Как-то отсорировать массив — достаточно просто, но как только задание усложнится до «отсортировать большой массив быстро«, окажется, что имеющихся у вас знаний недостаточно. Погуглив, покопав Stackoverflow и форумы, вы найдете алгоритм быстрой сортировки. Конечно, кто-то и сам переизобретет этот алгоритм рано или поздно, но более эффективным путем было бы сразу прочитать книжку с разбором типовых алгоритмов. И вот как раз такого набора «типовых алгоритмов» для апекса обычно нигде нет, а на помощь приходят те же самые метод научного тыка, поисковики, форумы и Stackoverflow (и, я надеюсь, этот туториал).

Вводная информация

Предполагается, что читатель знаком с Oracle Database версии хотя бы с 11-й, SQL, PL/SQL и особенно с тем, что такое EXECUTE IMMEDIATE и как оно работает.

IDE апекса значительно изменилась при переходе с версии 4.2 на 5.0 (релиз был как раз 4 года назад, в марте 2015-го). С тех пор IDE меняется мало, но иногда добавляются новые возможности. Я буду делать скриншоты на apex.oracle.com, где сейчас установлена версия 19.1, но если у вас где-то используется более ранняя версия (5.х, 18.х), вы без труда найдете нужный элемент, если только он не появился в более поздней версии, чем ваша.

Я начну с обзора наиболее часто используемых разделов IDE. Я тоже покажу несколько скриншотов. Куда же без них, раз всё здесь сделано из визуальных компонентов. Но их будет не так много, как в плохих туториалах, и в основном они будут в начальных главах, а дальше я буду просто указывать название раздела IDE, в котором находятся необходимые вещи. Сразу обращу ваше внимание, что это просто первое знакомство с IDE. Более подробная информация о том, когда на какую кнопку нажимать и где что смотреть, будет дана дальше, когда я перейду к конкретным темам.

Поехали.

Обзор IDE

Стартовый экран, который вы увидите сразу после входа в IDE:

Главные элементы здесь — это 4 большие кликабельные картинки:

1. App Builder — это, собственно, то место, где можно создавать приложения и где вы будете проводить до 99% времени.
2. SQL Workshop — заменитель обычной IDE для работы с СУБД Oracle. Там вы можете посмотреть объекты БД (таблицы, индексы, пакеты, и т. п.) и выполнять SQL-запросы. Если у вас есть возможность делать все это через «обычные» IDE (вроде Oracle SQL Developer или PL/SQL Developer) — делайте через них. Тем не менее, этот раздел тоже может быть полезен и о нем я тоже расскажу.
3. Team Development — инструменты для командной разработки. Честно говоря, я ни разу не видел, чтобы хоть кто-то ими пользовался на практике (включая меня). Любопытства ради я туда тоже заглядывал и совсем бесполезным этот раздел я бы не назвал, хотя и очень хочется.
4. App Gallery — раздел с демо-приложениями. К тому моменту, когда он появился, я уже неплохо знал апекс и почти не заглядывал туда, но начинающим, думаю, это будет полезно. Там много разных простеньких приложений, на их примере можно изучать, как использовать те или иные возможности.

В меню в самом верху страницы продублированы эти же 4 пункта.

Кроме этого, есть еще несколько малополезных вещей: ниже есть некоторое количество статистической информации (типа наиболее часто редактируемых приложений или наиболее активных разработчиков). И есть колонка справа, где также немного статистики и дополнительных ссылок.

Рассмотрим App Builder и SQL Workshop подробнее.

App builder

Эта страница выглядит примерно вот так:

Основные элементы этой страницы: четыре большие кнопки как на предыдущей странице, список уже имеющихся приложений, правая колонка со списком последних измененных приложений и дополнительными действиями. Четыре кнопки — это:

1. «Create» — создать новое приложение. Эта же функция продублирована чуть ниже (синяя кнопка «Create» над отчетом со списком приложений). Кнопка запускает мастер создания приложений.
2. «Import» — импортировать приложение. Апекс позволяет переносить приложения с одного сервера на другой в виде текстовых файлов (которые, по сути, являются длииииными PL/SQL скриптами с вызовами функций создания всех элементов приложения).
3. «Dashboard» — малополезное сборище статистики разработки приложений. Кто, когда, где, сколько изменений сделал. Думаю, даже вашему начальнику будет неинтересно туда смотреть.
4. «Workspace Utilities» — набор дополнительных инструментов для управления приложением. Честно говоря, туда я тоже почти не заглядываю.

Так же хочу обратить ваше внимание на вот такую маленькую кнопочку в панели отчета:

Она переключает вид отчета с такого, как на скриншоте выше (с «картинками» приложений) на отчет в виде таблицы:

Похожие отчеты встречаются и в других разделах IDE. Я предпочитаю табличный вид, поэтому далее все скриншоты будут с ним.

Страница приложения

После того, как вы создадите приложение или откроете существующее, вы увидите следующую страницу (очень похожую на предыдущую по структуре):

На эту страницу вы будете заходить очень часто, и полезных функций здесь тоже очень много. Большие кнопки с картинками:

1. «Run Application». Эта кнопка запускает ваше приложение. Оно откроется в отдельном окне. По умолчанию — именно в окне, а не во вкладке браузера, но это поведение настраивается (об этом позже).
2. «Supporting Objects». Этот раздел служит для решения вопросов, связанных с установкой, обновлением и удалением приложений. Обычно им почти не пользуются.
3. «Shared Components» — я бы сказал, это первый или второй по важности раздел IDE (еще один — редактор страниц). Если вы будете много разрабатывать на апексе, то очень скоро заметите, что выучили структуру этого раздела как «Отче наш».
4. «Utilities» — еще один набор (мало)полезных вспомогательных функций.
5. «Export / Import». Позволяет экспортировать или импортировать приложения или отдельные части приложения.

И две дополнительные кнопки, которые обведены оранжевой рамкой на скриншоте:

1. Кнопка «Edit application properties». Нажав на нее, вы попадете на страницу настроек свойств приложения. Возможно, вы не будете заходить в этот раздел часто, но он очень важен, потому что там хранятся настройки приложения, от которых много чего зависит. Далее, если я буду упоминать где-то «свойства приложения» — ищите их в этом разделе.
2. В кои-то веки полезная функция в правой панели: «Delete this Application». В то время как многие функции в апексе продублированы в разных местах, эта функция есть только здесь, и с непривычки первый раз ее найти сложно.

Shared Components

Shared Components — это наше всё. Этот раздел является промежуточным пунктом на пути к конкретным компонентам приложений. Покажу здесь общий вид, просто чтобы вы представляли, где что находится:

Совсем неважной ерунды здесь почти нет. Каждый раздел вам так или иначе может понадобиться. Названия разделов говорят сами за себя, добавить почти нечего:

1. Application Logic — средства управления логикой приложения.
2. Security — вопросы безопасности и управления доступом к приложению целиком и к отдельным компонентам в зависимости от ролей пользователей.
3. Other Components — это «все остальные компоненты». По-хорошему, этому разделу следовало бы быть последним, но он почему-то здесь. А подпункт «List of Values» я бы вообще в Application Logic перенес.
4. Navigation — компоненты приложения для обеспечения навигации.
5. User Interface — настройка внешнего вида приложения, стилей и т. п.
6. Files — раздел для файлов (например, css или js). Незаменим, если у вас нет доступа к ОС, и все равно удобен, даже если доступ есть.
7. Data Sources — работа с источниками данных (для загрузки и выгрузки).
8. Reports — отчеты, очевидно.
9. Globalization — раздел для перевода приложений на другие языки.

Page Designer

Page Designer — редактор страниц. Это, наверное, главное место в IDE. Здесь вы будете создавать то, с чем напрямую взаимодействует пользователь. Здесь просто куча функций, почти как в кабине самолета. На скриншоте разноцветными рамками выделены основные составляющие редактора:

Панель кнопок вверху (в красной рамке):

• Поле для ввода номера страницы, стрелки вверх и вниз и кнопка «Go»: навигация по страницам приложения. Каждая страница имеет номер, тут вы можете либо ввести номер нужной страницы, либо стрелками перейти к следующей/предыдущей, либо нажать на самую левую кнопку и в появившемся модальном окне выбрать страницу из списка.
• Кнопка с замком: позволяет заблокировать страницу от изменений другими разработчиками.
• Кнопки Undo/Redo
• Две кнопки с доступом к вспомогательным функциям.
• Кнопка-ссылка на Shared Components. Полезная, потому что туда-сюда ходить приходится постоянно. (Я сам, правда, предпочитаю просто держать Shared Components в отдельной вкладке — так еще быстрее).
• Кнопка «Save» — сохраняет изменения на странице.
• Кнопка «Run» — «запускает» страницу, то есть вы ее видите так, как ее потом увидит пользователь.

Слева (в оранжевой рамке) — панель с компонентами приложения. В этой панели есть 4 закладки:

• «Rendering» — показывает, из каких составных частей состоит страница, какие процессы выполняются при рендеринге;
• «Dynamic Actions» — действия, выполняемые на клиенте (например, обработчики событий javascript);
• «Processing» — серверные процессы, связанные со страницей;
• «Page Shared Components» — для прямого перехода к используемым на странице общим компонентам (те самые Shared Components).

По центру (в зеленой рамке) — панель, содержащая много разнородной информации. В верхней части панели есть 5 закладок, на которых можно найти:

• «Layout» — показывает примерное расположение компонентов на странице;
• «Component view» — по большому счету, это пережиток прошлого (похожим образом выглядел редактор страниц в 4-й версии апекса, в версии 5.0 или 5.1 этот старый «вид» получил статус deprecated, хотя и использовался параллельно с новым, а теперь тут осталась лишь его бледная тень);
• «Messages» — тут будут сообщения об ошибках (например, сообщение о том, что не заполнено какое-нибудь обязательное поле);
• «Page Search» — поиск на странице. Ищет искомую строку во всех местах, где вы можете что-то вводить (в коде, в текстах сообщений, в названиях компонентов и т. д.);
• «Help» — помощь. Довольно толковая, хотя и не всегда. Можно выбрать какое-нибудь свойство компонента и посмотреть его описание.

Также центральная панель имеет снизу еще одну дополнительную панель, которую можно использовать для быстрого добавления компонентов на страницу.

Справа (в синей рамке) — панель свойств. Тут все просто — она показывает свойства выбранного в данный момент компонента.

SQL Workshop

Как я уже говорил, SQL Workshop — это заменитель обычной IDE (если у вас по каким-то причинам нет возможности ее использовать).

Он состоит из 5 разделов:

1. Object Browser — браузер объектов БД (таблиц, пакетов, функций и процедур, индексов, сиквенсов и прочего);
2. SQL Commands — раздел, где можно выполнить любой SQL запрос или PL/SQL код;
3. SQL Scripts — здесь можно загрузить текстовый файл со скриптом и выполнить его;
4. Utilities — разные дополнительные возможности, связанные с БД: например, есть графический построитель запросов (но не только);
5. RESTful Services — создание REST сервисов. Апекс тоже имеет REST (причем давно, еще в версии 4.2 они уже были)!

Object Browser

Здесь есть все, что нужно для работы с объектами БД: создание, изменение, удаление, просмотр свойств объектов, ввод данных в таблицы — для всего этого в этом разделе есть графический интерфейс. Вверху слева в выпадающем списке можно выбрать тип объектов (на скриншоте показаны таблицы), вверху справа можно выбрать схему, объекты которой вы можете посмотреть. В списке доступных схем вы не увидите все схемы сразу — это нормально. Как сделать схемы видимыми в апексе, я расскажу, когда дойду до администрирования.
Также я не вижу большого смысла описывать этот раздел подробнее: если вы знаете, что значит фраза «добавить столбец в таблицу», вы без труда догадаетесь, когда вам нужно будет нажимать на кнопку «Add Column» и что вас может ждать дальше.

SQL Commands

В этом разделе можно выполнять SQL запросы и PL/SQL код.

По возможностям этот раздел почти не уступает полноценным средам разработки. Не хватает разве что автодополнения кода и подсветки синтаксиса (а в Object Browser подсветка синтаксиса есть, кстати). Имеющиеся возможности:

• выполнение SQL, в том числе с параметрами (для ввода значений параметров появится отдельное окно);
• выполнение PL/SQL с возможностью вывода текста через dbms_output (вывод появится в окне ниже);
• выполнение только выделенной части кода (выделить текст мышкой, затем «Run»);
• просмотр плана запроса;
• сохранение запросов.

***

Это, как вы понимаете, далеко не всё, что есть в IDE APEX, но на данном этапе не имеет смысла углубляться дальше. Отдельные элементы интерфейса апекса будут разобраны более подробно в темах, которые имеют к ним непосредственное отношение.

P. S. Я пока не могу сказать, что четко продумал структуру этого туториала, возможно, в будущем я добавлю еще скриншоты и описания в эту статью или опишу дополнительные возможности в других статьях. Осталось придумать, как оповещать заинтересованных о значительных правках старых статей.