Копировать ссылку на страницу Перейти в предыдущий раздел Перейти в следующий раздел

Для каждого веб-модуля в секции 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 – параметры задаются в вычислении отчета;
fromdialog – параметры запрашиваются в окне диалога.

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

dialogname. Имя прикладного диалога из компоненты Диалоги.

fillhiddenparamsfunc. JavaScript-функция, заполняющая параметры отчета типа Hidden.

Param – настраиваемый параметр отчета.

name. Название параметра отчета. Список параметров для данного отчета см. в примечании к отчету в компоненте Разработка отчетов.

caption. Код строки локализации названия параметра.

type. Тип параметра. Возможные значения:

String – строка;
Float – дробное число;
Number – дробное число;
Date – дата и время;
Integer – целое число;
Int – целое число;
ReferenceRecord – запись справочника;
Pick – признак;
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>

В результате при вызове настроенного отчета через пункт контекстного меню Запустить откроется окно «Параметры отчета» с полями:

STRING – типа «Строка»;
FLOAT и NUMBER – типа «Дробное число»;
INTEGER – типа «Целое число»;
DATE и DATETIME – типа «Дата и время»;
REFERENCE_SELECT – поле с выбором записей из справочника;
PICK – типа «Признак»;
MULTI_REFERENCE_SELECT – поле с выбором нескольких записей из нескольких справочников.
© Компания DIRECTUM, 2018 Сообщество пользователей DIRECTUM
.navbar > a:hover { background: #FFD73B; }