10. Параметры и оповещения

10.1 Параметры в отчетах Crystal Reports

Параметры (parameters) в отчетах Crystal Reports 11.5, обеспечение интерактивности отчетов, статические и дианмические параметры, создание параметров, ограничение допустимых значений при вводе значений параметров, окно приглашения для ввода значений параметров

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

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

Создание отчета производится из окна Field Explorer. В этом окне необходимо щелкнуть правой кнопкой мыши по контейнеру Parameter Fields, а затем в контекстном меню выбрать команду New. Откроется окно для создания нового параметра, аналогичное представленному на рис. 10.1.

Рис. 10. 1 Окно создания статического параметра

В верхней части окна необходимо определить имя параметра, тип данных для этого параметра, а также тип параметра — статический или динамический. От типа параметра зависит набор остальных элементов в этом окне.

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

Динамические параметры — параметры, для которых набор значений, предлагаемых пользователю, генерируется динамически на основе информации из базы данных. Такой тип параметров появился только в Crystal Reports 11 (раньше предоставить пользователю набор допустимых значений можно было только средствами внешнего приложения, в которое были интегрированы отчеты Crystal Reports).

Если мы создаем обычный статический параметр, то в нашем распоряжении следующие возможности:

• определить набор значений, которые будут предлагаться пользователю. Значения и их описания можно ввести вручную при помощи таблицы Value/Description, а можно загрузить из базы данных, воспользовавшись списками Value Field и Description Field. Еще раз отметим, что список значений в этом случае сформируется в момент создания отчета (а не из базы данных в момент открытия отчета пользователем). Если вам нужен динамически изменяемый список значений, то необходимо использовать динамический тип параметра.

Непосредственно загрузить данные можно при помощи меню Actions (Действия) | Append all Database Values (Добавить все значения из базы данных). Затем загруженные значения можно отредактировать при помощи таблицы.

При желании можно также загрузить список из файла на диске. Для этого необходимо воспользоваться командой Import в том же меню Actions.

• произвести дополнительные настройки параметра при помощи списка Value Options.

Набор дополнительных настроек в списке Value Options зависит от типа данных для создаваемого параметра. Ниже представлены настройки для строковых параметров (тип String):

• Prompt Text — текст приглашения, которое будет выводится пользователю в окне ввода значений параметра;
• Prompt With Description Only — если установить значение True, то в этом случае пользователю будут показываться только описания параметра, без реальных значений;
• Default Value — значение, предлагаемое по умолчанию;
• Allow Custom Values — определяет, можно ли будет пользователю вводить свои собственные значения. Если установить значение False, то пользователь сможет только выбрать одно из списка предлагаемых ему значений;
• Allow Multiple Values — можно ли будет пользователю выбирать одновременно несколько значений параметра;
• Allow Discrete Value — можно ли будет пользователю выбирать отдельные дискретные значения для параметра (противопоставляется диапазонам значений);
• Allow Range Values — можно ли будет использовать диапазоны в виде значений (обычно используется только для числовых данных и дат);
• Min Length и Max Length — возможность определить минимальную и максимальную длину для значений параметров, вводимых пользователем;
• Edit Mask — возможность определить маску для вводимых пользователем параметров.

Возможности настройки маски для Crystal Reports предусмотрены достаточно сложные. Ниже представлен перечень используемых символов:

• A — любая цифра или буква (наличие обязательно);
• a — любая цифра или буква (наличие необязательно);
• 0 — любая цифра от 0 до 9 (наличие обязательно);
• 9 — любая цифра от 0 до 9 (наличие необязательно);
• # — любая цифра от 0 до 9, или пробел, или символы +/- (наличие необязательно);
• L — любая латинская буква от A до Z (наличие обязательно);
• ? — любая латинская буква от A до Z (наличие необязательно);
• & — допускается любой символ, в том числе пробел (наличие обязательно);
• C — допускается любой символ, в том числе пробел (наличие необязательно);
• . , : ; - / — символы разделителя. Должны использоваться в значении параметра на указанном месте;
• < — следующий символ должны находится в нижнем регистре;
• > — следующий символ должен находиться в верхнем регистре;
• \A — зарезервированный символ должен отображаться в виде литерала. Например, в записи вида \A буква A означает не "любую цифру или букву", а просто букву A.
• Password — специальное значение. Если его использовать, то при помощи формул условного форматирования можно будет определить, что какие-то части отчета будут видны только тогда, когда в виде значения параметра будет введено специальное значение (пароль).

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

Рис. 10.2 Создание динамического параметра

При создании такого параметра вам потребуется щелкнуть по строке Click here to add item и указать поле базы данных, значения которого будут динамически представляться пользователю для выбора. Остальные настройки аналогичны настройкам статического параметра.

После создания параметра с ним можно выполнять те же операции, что и с обычным полем базы данных — просто размещать в отчете, использовать в формулах и т.п. Однако чаще всего параметры используются для фильтрации данных. Чтобы позволить пользователю самостоятельно настраивать фильтрацию данных, необходимо открыть Select Expert и в качестве значения для фильтрации выбрать созданный вами параметр. Он будет помечен фигурными скобками и вопросительным знаком (см. рис. 10.3).

Рис. 10.3 Применение параметра

После того, как все настройки будут произведены, при обновлении отчета пользователю будет представлено окно ввода значений параметра (см. рис. 10.4).

Рис. 10.4 Окно ввода значений параметров

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

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

Получить учебные материалы по этому курсу