Модификация прикладной системы

 

Разработка отчетов

 

Функция возвращения параметров для варианта отчета

Функция возвращения параметров содержит перечень возможных параметров для варианта настройки отчета.

Функция вызывается при создании нового варианта отчета для заполнения табличной части с параметрами в компоненте Варианты настройки отчетов (см. описание компоненты «Варианты настройки отчетов» в книге «Компоненты системы DIRECTUM»).

Функция возвращения параметров не имеет входящих параметров, и создается Разработчиком при создании отчета с вариантами настройки.

 

Требования к имени функции

Имя функции формируется по имени отчета следующим образом: из каждого слова берутся первые три буквы, сливаются в одно слово, и дописывается префикс «ОТЧ». Ключевые слова в имени отчета (заданы в константе ВДМСТПР) игнорируются. Например, если отчет называется «Сводная таблица по выполнению заданий (с настройкой)», то имя функции будет «ОТЧСвотабповыпзад».

Имя функции Разработчик может определить самостоятельно согласно вышеприведенному алгоритму, но во избежание ошибок рекомендуется воспользоваться одним из следующих способов:

·         для отчета нужно создать вариант настройки, при этом возникнет ошибка «Не найдена функция …», в тексте которой будет указано имя функции;

·         имя функции для отчета определяется с помощью функции ОТЧИмяФункции(), поэтому нужно просто вызвать эту функцию, передав в качестве параметра имя отчета и результат вывести на экран (вычисления можно задать и выполнить, например, с помощью внешних сценариев).

 

 // определение имени функции возвращения параметров для отчета

 // «Сводная таблица по выполнению заданий (с настройкой)»

  ReportName="Сводная таблица по выполнению заданий (с настройкой)"

  ShowMessage(ОТЧИмяФункции(ReportName))

 

Требования к возвращаемому значению функции

Формат возвращаемого значения функции (возможные параметры перечисляются через разделитель /*/, характеристики параметра – через разделитель #):

 

<Параметр1>#<Имя>#<Тип>#<№ Экрана>#<Тип ввода>#<Разделитель>#<Справка>/*/

...

<ПараметрN>#<Имя>#<Тип>#<№ Экрана>#<Тип ввода>#<Разделитель>#<Справка>

Описание характеристик параметров:

·         Параметр – обозначение параметра, отображаемое в таблице варианта настройки отчете в поле Параметр (см. описание компоненты «Варианты настройки отчетов» в книге «Компоненты системы DIRECTUM»);

·         Имя – имя параметра, отображаемое в окне мастера (см. описание компоненты «Варианты настройки отчетов» в книге «Компоненты системы DIRECTUM»);

·         Тип – любой тип, поддерживаемый функцией InputDialog(), плюс дополнительные типы «PivotTbl» и «PivotFld»;

·         № Экрана – чтобы не запрашивать каждый параметр в отдельном окне, параметры можно сгруппировать по экранам. На экран можно помещать несколько параметров, если у них Тип ввода равен «Ед». Нумерация экранов должна быть строго по порядку, начиная с 1. Те параметры, значения которых в мастере задавать не нужно, надо помещать на экран с номером -1;

·         Тип ввода – можно не указывать для параметров типа «PivotTbl» и «PivotFld». Возможные значения:

·         «Ед» – для параметра будет запрошено одно значение (по умолчанию для типа «PivotTbl»);

·         «Мн» – параметр представляет собой список значений;

·         «МнРазнСтр» – параметр представляет собой список значений, но каждое значение помещается в отдельную строку таблицы (по умолчанию для «PivotFld»).

·         Разделитель – разделитель в списке значений. Указывается только для типа ввода «Мн». Не может быть равен #;

·         Справка – описание параметра, не должно содержать символов # и /*/. Текст справок по всем параметрам, присутствующим на одном экране, будет доступен по кнопке Справка в мастере заполнения параметров (см. описание компоненты «Варианты настройки отчетов» в книге «Компоненты системы DIRECTUM»).

 

 // текст функции возвращения параметров ОТЧСвотабповыпзад() для отчета

 // «Сводная таблица по выполнению заданий (с настройкой)»

  ОТЧСвотабповыпзад="PivotFld#Поля#PivotFld#1#МнРазнСтр##/*/"&

                    "PivotTbl#Сводная таблица#PivotTbl#2#Ед##"

 

 

 

См. также:

·         Общие сведения о настройке вариантов отчетов;

·         Процесс создания отчета с вариантами настройки.