Oracle APEX: Процедуры в URL - Z

Последняя из "маленьких" встроенных процедур APEX, которые можно использовать в URL: Z.

Эта процедура используется для подсчёта кликов по ссылкам. Обёрткой вокруг неё является APEX_UTIL.COUNT_CLICK, поэтому можно смело ориентироваться на документацию, меняя в примерах APEX_UTIL.COUNT_CLICK на Z. У Z есть следующие параметры:

• p_url — URL, к которому необходимо перейти.
• p_cat — категория, к которой Z причисляет клик.
• p_id — вторичный числовой идентификатор клика. ID приложения, номер страницы — всё то, что поможет Вам в дальнейшем выделить именно эти клики из остальных.
• p_user — пользователь, который сделал клик.
• p_company, p_workspace — ID рабочего пространства. Если p_company пустое, то используется p_workspace. Если оба эти параметра пустые, то Z не сохраняет информацию о клике, а просто перенаправляет на p_url.

Пример URL с этой процедурой:

z?p_url=w3.org&p_cat=w3c&p_company=&WORKSPACE_ID.

Информацию, собранную Z, можно просмотреть в представлении APEX_WORKSPACE_CLICKS.


Сообщения по теме:
Oracle APEX: Процедуры в URL - F
Oracle APEX: Процедуры в URL - P

Читать далее

Oracle APEX: Процедуры в URL - P

Ещё одна используемая при создании URL процедура: P.

Она не завраплена, так что её код можно легко увидеть:

create or replace
procedure p (
    n       in varchar2 default null,
    p_mime_type in varchar2 default null,
    p_inline    in varchar2 default 'NO')

-- Copyright (c) Oracle Corporation 2001. All Rights Reserved.
--
--    DESCRIPTION
--      View a page given a page ID
--
--    SECURITY
--      Public shortcut
--
--    NOTES
--
--    EXAMPLES:
--

is
begin
     if n is null then
         htp.p(wwv_flow_lang.system_message('p.valid_page_err'));
         return;
     end if;
     --
     wwv_flow_file_mgr.get_file (
        p_id => n,
        p_mime_type => p_mime_type,
        p_inline => p_inline);
end p;

P используется, чтобы скачать загруженные файлы, которые можно найти в представлении APEX_APPLICATION_FILES (aka WWV_FLOW_FILES, построено на таблице FLOW_FILES.WWV_FLOW_FILE_OBJECTS$). У этой процедуры не так много параметров:

• n — ID файла, который необходимо скачать.
• p_mime_type — устаревший параметр для указания MIME-типа файла. Сейчас информация берётся из соответствующих столбцов записи в APEX_APPLICATION_FILES.
• p_inline — NO, чтобы предложить пользователю скачать файл; YES, чтобы браузер отобразил его.

Пример относительного URL для скачивания файла с ID=1234567891011:

p?n=123456789101112&p_inline=NO

Сообщения по теме:
Oracle APEX: Процедуры в URL - F
Oracle APEX: Процедуры в URL - Z

Читать далее

Oracle APEX: Процедуры в URL - F

В APEX переход по страницам приложения - это обращение к процедурам. И одной из самых используемых процедур является F. Чтобы увидеть её, можно просто почаще смотреть в строку адреса во время работы с APEX. Там обнаружится что-то вроде такого:

http://work:8080/apex/f?p=4000:1500:434361572702804:::::

С помощью этой процедуры можно создавать ссылки к различным страницам приложений APEX. Я не буду здесь повторять раздел документации Oracle® Application Express Application Builder User's Guide: 2 Application Builder Concepts - Understanding URL Syntax. По крайней мере, ту его часть, которая описывает структуру значений параметра P. Давайте лучше поговорим о том, что упоминается не так часто.

Итак, F - это своеобразная обёртка для WWV_FLOW.SHOW (aka APEX_APPLICATION.FLOW). В этой процедуре устанавливаются различные глобальные переменные, использующиеся для отображения страницы, параметр P разбирается на составляющие, которые передаются в APEX_APPLICATION.FLOW.

Кроме параметра P у процедуры F есть ещё параметры. Часть из них описана в документации, часть можно увидеть в URL при работе с приложениями. Вот неполный список:

• p_sep - разделитель, который используется, чтобы разбить значение параметра P в PL/SQL-коллекцию.
  
• p_trace - если равен "YES", apex_application.show будет создавать трассировочный файл. Подробнее в документации: Enabling SQL Tracing and Using TKPROF.
  
• c - workspace_id или название (workspace) рабочего пространства из apex_workspaces. По значению этого параметра выбирается и устанавливается группа безопасности (aka security group ID). Это понадобится, к примеру, при вызове страниц приложения с тем же псевдонимом в другом рабочем пространстве. Упоминается в документации: Calling a Page Using an Application and Page Alias.
  
• cs - контрольная сумма, которой проверяются значения параметров. Первый символ - тип кинтрольной суммы, остальная строка - собственно контрольная сумма.
  
• success_msg - текст для отображения сообщения об успешном выполнении.
  
• notification_msg - текст для отображения уведомления.
  
• tz, p_lang, p_territory - NLS-параметры: временная зона, язык и территория. Значением p_lang можно менять язык сессии, который используется при переводе приложения с настройкой Application Language Derived From = Session.

Сообщения по теме:
Oracle APEX: Процедуры в URL - P
Oracle APEX: Процедуры в URL - Z

Читать далее