Внешние параметры предназначены для интеграции модулей АльфаЦЕНТР Генератор отчетов и АльфаЦЕНТР Плюс. Внешние параметры позволяют пользователю при вызове отчета из модуля АльфаЦЕНТР Плюс выбрать и передать необходимые значения параметров в сам отчет посредством установления связи внешнего параметра с данными на листах отчета или с параметрами команд отчета. Таким образом, конечный пользователь может выбрать через интерфейс необходимые значения параметров, например, начальную и конечную даты и передать отчет на выполнение серверу отчетов Генератора отчетов.
Внешние параметры сохраняются вместе с отчетом и задаются в форме "Свойства отчета", закладка "Внешние параметры". Форма показана на рисунке ниже.
Форма "Свойства отчета", закладка "Внешние параметры"
Таблица содержит список внешних параметров и средства для работы с этим списком. Для добавления нового параметра необходимо нажать кнопку "Добавить" и в форме "Свойства внешнего параметра" указать описание параметра и связь с отчетом или параметров. Форма показана ниже. Для изменения описания внешнего параметра необходимо нажать кнопку "Изменить". Для удаления внешнего параметра необходимо нажать кнопку "Удалить". После изменения описания внешних параметров необходимо сохранить отчет в БД АльфаЦЕНТР, чтобы изменения были доступны в модуле АльфаЦЕНТР Плюс.
Форма "Свойства внешнего параметра"
Каждый внешний параметр имеет следующие параметры описания:
•Наименование параметра - строка, понятная пользователю, кратко описывающая параметр;
•Пояснение для пользователя - строка, которая будет выводится рядом с наименованием параметра, предназначена для описания и пояснения смысла параметра конечному пользователю;
•Обязательный параметр - флажок, указывает на то, что при вводе значений внешних параметров данному параметру обязательно необходимо присвоить значение. Пустое значение не может быть указано;
•Редактор параметра - вид редактора параметра, который будет использоваться при вводе значения конечным пользователем;
•Тип комплексного редактора - тип редактора параметра, который будет использоваться для ввода значений конечным пользователем;
•Тип связи параметра - вид связи внешнего параметра с самим отчетом. Связь может быть следующих видов:
•Значение ячейки - значение внешнего параметра будет установлено в указанные ячейки самого отчета. Другие команды отчета должны использовать значения этих ячеек при установке своих параметров. Комплексные редакторы могут возвращать значения для нескольких параметров, поэтому при выборе комплексного редактора надо указать несколько ячеек для приема значений из этого редактора;
•Значение именованной области - значение внешнего параметра будет установлено в левую верхнюю ячейку выбранной именованной области. Другие команды отчета должны использовать значение этой ячейки или именованной области при установке своих параметров;
•Значение параметров команд - значение внешнего параметра будет установлено как значение указанных однотипных параметров выбранных команд. Выбор однотипных параметров команд производится в специальной форме "Выбор параметров команд".
•Текущее значение параметра - значение параметра в текущий момент. Данное значение может быть использовано, если внешний параметр объявлен как необязательный.
Пояснение по описанию внешних параметров.
Если в отчете есть несколько команд, которым надо давать одинаковое значение, например, № фидера, то чтобы не создавать множество одинаковых параметров, необходимо реализовать установку значений параметров этих команд как связь одного внешнего параметра с несколькими параметрами различных команд. Так же можно установить как ссылки на ячейки отчета, а внешние параметры настроить на внесение значение в эти ячейки. Но первый вариант боле предпочтительный. Если параметр зависит от других параметров (например, № фидера зависит от параметра № объекта и № типа объекта), то необходимо все параметры задавать как ссылки на ячейки. Т.е. например, в ячейке A5 указывать номер типа объекта, в ячейке B5 указывать № объекта, а в ячейке C5 - номер фидера и все три параметра команды ссылаются на эти три ячейки. Внешний же параметр будет один, но иметь три ячейки, куда будут сохраняться значения для всех параметров.
Если внешний параметр ссылается на параметр команды, то в этого параметра будет отключаться ссылка на ячейку, если она активна. Таким образом., например, номер группы берется из ячейки C5, НО внешний параметр ссылается не на ячейку C5, а на сам параметр "№ группы" команды. Это неправильно делать такую ссылку, потому что при выполнении отчета через внешние параметры будет сначала установлен параметр "№ группы" самой команды - это делается перед выполнением команды, а уже при выполнении команды из-за того, что связь параметра с ячейкой листа активна, то будет взято значение из этой ячейки. Поэтому связи отключаются. В общем случае, если для нескольких команд отчета надо задать одно значение параметра, то необходимо установить связь этого параметра с ячейкой отчета (или несколькими ячейками), а уже для этих ячеек настроить внешние параметры.
В общем случае, может быть конфликт, когда значение параметра команды берется из ячейки отчета и когда этот параметр команды задается через внешние параметры. Порядок обработки следующий - сначала обрабатываются внешние параметры, а потом обрабатывается связи параметров с ячейками отчетов.