ПАРАМЕТРЫ ВЫБОРКИ

Параметры выборки - это входные параметры SQL запроса выборки. В качестве примера рассмотрим следующий SQL запрос выборки:

select
  bm.ID_MAIL,
  bmt.MAILTYPE,
  bm.MAIL_SUBJECT,
  bm.MAIL_BODY,
  bm.MAIL_ADDRESS_FROM,
  bm.MAIL_ADDRESS_TO
from
  BASE_MAILS bm
  join BASE_MAILTYPES bmt on bm.ID_MAILTYPE = bmt.ID_MAILTYPE
where
  bm.IS_MAIL_IN = :IS_MAIL_IN and
  bm.ID_MAILTYPE = :ID_MAILTYPE and
  bm.D_MAIL_CREATE between :D_BGN and :D_END

В данном запросе, в условии where присутствуют четыре параметра :IS_MAIL_IN, :ID_MAILTYPE, :D_BGN, :D_END. После сохранении выборки, для всех параметров SQL запроса, платформа создаст объект "Параметр выборки", который можно увидеть в дереве объектов рабочего стола (смотрите рисунок).

Объект "параметр выборки" необходим для того, чтобы указать каким образом передать в SQL запрос выборки значения параметров. Значения параметров могут передаваться следующим образом:
1. Непосредственно пользователем.
2. Из главной выборки в подчиненную, при построении связи мастер-деталь между выборками в сложной форме.
3. Из одной выборки в другую.

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

Для выборки, SQL которой описан выше, при нажатии на копку установки входных параметров , откроется диалоговое окно, где пользователь устанавливает входные параметры (смотрите рисунок ниже).

Данное окно создается платформой "Эскулап" автоматически на основании настроек параметров. Настройки параметров делаются разработчиком в форме, которая вызывается из дерева объектов рабочего стола из контекстного меню по правой кнопкой мыши или по комбинации горячих клавиш (смотрите рисунок).

В появившемся окне, в таблице, содержится список всех параметров, которые присутствуют в SQL запросе и, которые, соответственно, перечислены в дереве объектов рабочего стола. Для того, чтобы пользователь мог сам передать значение параметра в выборку, необходимо заполнить поля "Заголовок поля" и "Значение по умолчанию". В этом случае платформа в диалоговом окне выбора параметров создаст поля, где пользователь сможет установить значения соответствующих параметров.

Порядок полей в диалоговом окне определяется значением поля "Порядок отображение". Если в качестве входного параметра необходимо выбрать значение из справочника, то в поле "Выборка - источник параметра" нужно указать название выборки. При этом в параметр будет возвращается значение ключевого поля выборки. В качестве текстового (информационного) значения в поле диалогового окна будет возвращаться значение выборки из поля, название которого указано в поле "Поле результата". Если пользователю необходимо выбрать значение из справочника, который представляет сложную форму, то в поле "Форма - источник параметра" нужно выбрать название формы-справочника.

В поле "Формат" указывается формат, в соответствии с которым будет отображаться значение параметра в диалоговом окне. Как правило, оно используется для того, чтобы указать, что поле параметра должно выглядеть как чекбокс. Для этого в поле формат необходмо написать CHECKBOX.