% REQUEST

Параметры запросов -- это содержимое глобального хэша %_REQUEST. В начале обработки %_REQUEST инициализируется параметрами GET- или POST-запроса, однако в дальнейшем процедуры могут изменять его содержимое для передачи данных между собой и с ядром Eludia. Исходные значения параметров доступны как содержимое хэша %_REQUEST_VERBATIM.

Ниже приведены специальные параметры запросов (соответственно, компоненты %_REQUEST), используемые ядром Eludia.pm.

Основные

Приведённые здесь параметры определяют выбор callback-процедур для обработки текущего запроса.

sid

Номер сессии. По нему определяется текущий пользователь.

type

Тип экрана.

id

Номер объекта (записи).

action

Действие.

__response_sent

Если истина, то presentation-часть обработки запроса пропускается. Используется в том случае, если ответ сформирован напрямую: установкой заголовков и печатью текста.

__im_delay

Если задан (как положительное целое число), то обозначает период опроса наличия мгновенных сообщений. Измеряется в миллисекундах (как 2-й аргумент setTimeout).

Просмотр/редактирование

__read_only

Если истина, то все поля ввода форм отрисовываются как static.

__edit

Антоним $_REQUEST {__read_only}. Точнее, как правило, content-процедура автоматически устанавливает $_REQUEST {__read_only} для не-fake записей, если только не $_REQUEST {__edit}. Данный параметр обычно фигурирует в запросах, порождаемых по кнопке 'Редактировать', которая автоматически при писывается к форме в режиме read_only при $conf -> {core_auto_edit}.

Управляющие данными

История навигации

__last_last_query_string

Прошлое значение $_REQUEST {__last_query_string}.

__last_query_string

Номер текущего запроса в рамках текущей сессии.

__last_scrollable_table_row

Номер строки таблицы, c которой был произведён переход на текущую страницу.

__next_query_string

Номер следующего (то есть прошлого при возврате по Esc) запроса в рамках текущей сессии.

Поиск и сортировка в таблицах

fake

Список допустимых значений поля fake через запятую. Используется в sql_select_all и sql_select_all_cnt.

start

Начало просматриваемого фрагмента листаемой длинной выборки. Должно явно подставляться в выражение LIMIT SQL-запросов для sql_select_all и sql_select_all_cnt.

order

Имя поля, по которому будет отсортирована таблица или, вообще говоря, абстрактное имя порядка сортировки. Автоматически не действует, но используется API-функцией order.

desc

Признак обратного порядка при сортировке таблиц. Автоматически не действует, но используется API-функцией order.

__toolbar_inputs

список имён всех полей на панели поиска. Используется для определения значений по умолчанию.

Обработка форм ввода

__checkboxes_...

имя связной таблицы многие-ко-многим для связи, соответствующей полю типа checkboxes или tree. Используется в do_update_DEFAULT для автоматического вызова sql_store_ids.

__form_checkboxes

список имён полей типа checkbox. Используется в do_update_DEFAULT для определения наличия таких полей на форме (поскольку неотмеченной галочке не соответствует никакой ключ в %_REQUEST).

Master / detail

__only_field

Имя перегружаемого detail-поля.

__only_form

Имя формы, содержащей перегружаемое detail-поле.

__only_tabindex

Порядковый номер перегружаемого detail-поля в смысле табуляции.

Управляющие отображением

__page_title

Заголовок окна браузера (точнее, той его части, которая поддаётся управлению). Если пуст, то по

умолчанию используется значение $conf -> {page_title}.

__redirect_alert

Текст сообщения, выдаваемого после выполнения действия. Передаётся в качестве опции label при автоматическом вызове функции redirect. Действует только при пустом значении __response_sent (которое устанавливается, в частности, при явном вызове redirect).

__include_css

Список путей (относительно docroot/i) дополнительных css-файлов, используемых на данной странице.

__include_js

Список путей (относительно docroot/i) дополнительных js-файлов, используемых на данной странице.

__focused_input

Имя поля, на котором фокусируестя ввод при загрузке страницы.

__help_url

Адрес, открываемый при нажатии на надпись 'F1 - Помощь' и соответствующую горячую клавишу.

__scrollable_table_row

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

select

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

__no_navigation

Если истина, то главное меню и авторизационная шапка не отрисовываются.

__script

js-код, подставляемый в конец элемента SCRIPT (отрабатывается после загрузки страницы, но до построения DOM-дерева)

__on_load

js-код, подставляемый в конец обработчика body.onload (отрабатывается после построения DOM-дерева).

__the_table

Имя таблицы, из описания которой берутся значения по умолчанию для опций отображения полей в draw_form. Автоматически устанавливается в sql_select_hash.

lang

Имя языка интерфейса, используемое для выбора словаря $i18n.

Выбор $_SKIN'а

xls

Если истина, то ответ выдаётся в виде HTML-файла, воспринимаемого на клиенте как электронная таблица (в качестве $_SKIN используется XL).

lpt

Устаревший параметр, теперь устанавливаемый при xls=1 по соображениям обратной совместимости.

__dump

Если истина, то ответ выдаётся в виде Data::Dumper (в качестве $_SKIN используется Dumper). Используется для отладки.

__x

Если истина, то ответ выдаётся в виде XML (в качестве $_SKIN используется XMLDumper). Используется для интеграции с внешними приложениями.

Classic

__blur_all

Отменяет эвристику определения __focused_input: ни одно поле не получит фокус ввода по умолчанию.

__clock_separator

Разделитель часов и минут на часиках авторизационной шапки. Иногда применяется для незаметной индикации чего-либо, например, '!' вместо ':' может означать, что гражданин, чья карточка отображается на экране – психопат.

__core_show_icons

Локальное переопределение $conf -> {core_show_icons} для новых разделов унаследованных приложений.

__meta_refresh

Период автообновления страницы, с.

__no_focus

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

__pack

Если истина, то при загрузке страницы окно браузера обжимается до минимального размера, при котором содержимое экрана остаётся видимым (устар.)

TurboMilk

__on_${event}

Обработчик события "on${event}" элемента <body>.

XL

_style

Внутренность тега STYLE при печати офисных документов.

_xml

Внутренность тега XML при печати офисных документов.

Внутренние

salt

Случайный параметр, зашумляющий URL для предотвращения кэширования на клиенте.

error

Сообщение об ошибке, которое будет выдано клиенту.

__peer_server

Имя peer-сервера, с которого пришёл текуший запрос. Если пусто, запрос от локального пользователя.

__suicide

Если истина, то текущий процесс будет завершён сразу после обработки данного запроса.