Для каждого веб-модуля в секции Reports можно настроить свой состав параметров отчетов. В данной секции должны быть указаны все отчеты, у которых есть параметры. Все указанные имена параметров должны корректно обрабатываться расчетом отчета. Подробнее см. разделы «Компонента «Разработка отчетов» и «Особенности разработки отчетов для веб-клиента.
Структура секции:
<Reports>
<!-- Удаление из секции всех отчетов по умолчанию -->
<clear />
<!-- Удаление из секции конкретного отчета по умолчанию -->
<remove name="{Имя удаляемого отчета}" />
<!-- Настраиваемый отчет -->
<Report
name="{Имя отчета}"
getparams="{Способ получения параметров отчета}"
dialogname="{Имя прикладного диалога}"
fillhiddenparamsfunc="{Имя JavaScript-функции, заполняющей параметры отчета типа Hidden}">
<!-- Удаление всех параметров отчета по умолчанию -->
<clear />
<!-- Удаление конкретного параметра отчета по умолчанию -->
<remove name="{Название удаляемого параметра по умолчанию}" />
<!-- Параметр отчета -->
<Param name="{Название параметра}"
caption="{Код строки локализации названия параметра}"
type="{Тип параметра}"
required="{Обязательный}"
defaultvalue="{Значение по умолчанию}"
refcode="{Имя справочника}"
refcodes="{Имя справочника 1};{Имя справочника 2}"
filter="{Условие фильтрации}"
filter_<Имя справочника>="{Условие фильтрации}"
ismultiselect="{Признак выбора нескольких значений из нескольких справочников}"
choices="{Значение1=Код строки локализации1;Значение2=Код строки локализации2;...}"/>
</Report>
</Reports>
remove – удаление конкретного отчета.
name. Имя удаляемого отчета из компоненты Разработка отчетов.
Report – настраиваемый отчет.
name. Имя отчета из компоненты Разработка отчетов.
getparams. Способ получения параметров отчета. Возможные значения:
• | true – параметры задаются в вычислении отчета; |
• | false – параметры задаются в веб-модуле; |
• | fromreport – параметры задаются в вычислении отчета; |
Значение по умолчанию false. Если параметры отчета не будут получены вычислением, то необходимо указать элемент Param для каждого параметра отчета.
dialogname. Имя прикладного диалога из компоненты Диалоги.
fillhiddenparamsfunc. JavaScript-функция, заполняющая параметры отчета типа Hidden.
Param – настраиваемый параметр отчета.
name. Название параметра отчета. Список параметров для данного отчета см. в примечании к отчету в компоненте Разработка отчетов.
caption. Код строки локализации названия параметра.
type. Тип параметра. Возможные значения:
• | ReferenceRecord – запись справочника; |
• | Boolean – логическое значение; |
• | Bool – логическое значение; |
• | Multiselect – выбор нескольких записей из нескольких справочников; |
• | Hidden – скрытый параметр, не отображается при запросе параметров отчета. Заполняется функцией, указанной в атрибуте fillhiddenparamsfunc. |
required. Признак обязательного для заполнения параметра отчета. Возможные значения true, false. Значение по умолчанию false.
defaultvalue. Значение параметра отчета по умолчанию.
refcode. Имя справочника из компоненты Типы справочников. Используется с типом параметра ReferenceRecord.
refcodes. Имена справочников из компоненты Типы справочников. Используется с типом параметра Multiselect.
filter. Условие фильтрации записей справочника. Подробнее см. раздел «Открытие справочника с фильтрацией».
filter_<Имя справочника>. Условие фильтрации записей справочника при выборе одной или нескольких записей из нескольких справочников. Используется с типом параметра Multiselect.
ismultiselect. Признак выбора нескольких значений из нескольких справочников. Возможные значения:
• | true – выбор нескольких значений из нескольких справочников; |
• | false – выбор одного значения из нескольких справочников. |
choices. Значение параметра типа «Признак». Задается по формату: Значение1=Код строки локализации1; Значение2=Код строки локализации2.
Пример
<Reports>
<Report name="REPORT_WITH_PARAMS">
<Param name="strweb"
caption="STRING"
type="string"
defaultvalue=""
required="false"/>
<Param name="flweb"
caption="FLOAT"
type="float"
defaultvalue=""
required="false"/>
<Param name="numweb"
caption="NUMBER"
type="number"
defaultvalue=""
required="false"/>
<Param name="intweb"
caption="INTEGER"
type="integer"
defaultvalue=""
required="false"/>
<Param name="dtweb"
caption="DATE"
type="date"
defaultvalue=""
required="false"/>
<Param name="dttmweb"
caption="DATETIME"
type="datetime"
defaultvalue=""
required="false"/>
<Param name="refweb1"
caption="REFERENCE_SELECT"
type="ReferenceRecord"
refcode="ОРГ"
defaultvalue=""
required="false"/>
<Param name="pickweb"
caption="PICK"
type="Pick"
choices="Y=YES;N=NO"
defaultvalue=""
required="false"/>
<Param name="multiref1"
caption="MULTI_REFERENCE_SELECT"
type="multiselect"
ismultiselect="true"
refcodes="ТМТ;ПОЛ"
filter_ТМТ="[ИД]=123"
filter_ПОЛ="[ИД]=456">
</Param>
</Report>
</Reports>
В результате при вызове настроенного отчета через пункт контекстного меню Запустить откроется окно «Параметры отчета» с полями:
• | FLOAT и NUMBER – типа «Дробное число»; |
• | INTEGER – типа «Целое число»; |
• | DATE и DATETIME – типа «Дата и время»; |
• | REFERENCE_SELECT – поле с выбором записей из справочника; |
• | MULTI_REFERENCE_SELECT – поле с выбором нескольких записей из нескольких справочников. |
|