2 378 документов
← К списку

НастроитьВариантыОтчетов

страница

Задает расширенные настройки отчетов конфигурации, такие как:

  • описание отчета;
  • поля поиска: наименования полей, параметров и отборов (для отчетов не на базе СКД);
  • размещение в разделах командного интерфейса (начальная настройка размещения отчетов по подсистемам автоматически определяется из метаданных, ее дублирование не требуется);
  • признак Включен (для контекстных отчетов);
  • режима вывода в панелях отчетов (с группировкой по отчету или без);
  • и другие. В процедуре задаются только настройки отчетов (и вариантов отчетов) конфигурации. Для настройки отчетов из расширений конфигурации следует включать их в подсистему ПодключаемыеОтчетыИОбработки. Для задания настроек следует использовать следующие вспомогательные процедуры и функции: ВариантыОтчетов.ОписаниеОтчета, ВариантыОтчетов.ОписаниеВарианта, ВариантыОтчетов.УстановитьРежимВыводаВПанеляхОтчетов, ВариантыОтчетов.НастроитьОтчетВМодулеМенеджера. Изменяя настройки отчета, можно изменить настройки всех его вариантов. Однако, если явно получить настройки варианта отчета, то они станут самостоятельными, т.е. более не будут наследовать изменения настроек от отчета. Функциональные опции предопределенного варианта отчета объединяются с функциональными опциями этого отчета по правилам: (ФО1_Отчета ИЛИ ФО2_Отчета) И (ФО3_Варианта ИЛИ ФО4_Варианта). При этом для пользовательских вариантов отчета действуют только функциональные опции отчета
  • они отключаются только с отключением всего отчета.

Синтаксис

Процедура НастроитьВариантыОтчетов(Настройки) Экспорт

Параметры

  • Настройки — ТаблицаЗначений - коллекция предопределенных вариантов отчетов, где:
    • Отчет - СправочникСсылка.ИдентификаторыОбъектовРасширений
    • СправочникСсылка.ДополнительныеОтчетыИОбработки
    • СправочникСсылка.ИдентификаторыОбъектовМетаданных
    • Строка - полное имя или ссылка на идентификатор отчета.
    • Метаданные - ОбъектМетаданныхОтчет - метаданные отчета.
    • ИспользуетСКД - Булево - признак использования в отчете основной СКД.
    • КлючВарианта - Строка - идентификатор варианта отчета.
    • ОписаниеПолучено - Булево - признак того, что описание строки уже получено.
    • Включен - Булево - если Ложь, то вариант отчета не выводится в панели отчетов.
    • ВидимостьПоУмолчанию - Булево - если Ложь, то вариант отчета по умолчанию скрыт в панели отчетов.
    • ПоказыватьВПодменюВариантов - Булево - если Ложь, то вариант отчета не отображается в подменю выбора вариантов
      отчета в форме отчета. Используется, когда Включен - Ложь.
    • Наименование - Строка - наименование варианта отчета.
    • Описание - Строка - пояснение назначения отчета.
    • Размещение - Соответствие из КлючИЗначение - настройки размещения варианта отчета в разделах (подсистемах), где: ** Ключ - ОбъектМетаданных - подсистема, в которой размещается отчет или вариант отчета. ** Значение - Строка - настройки размещения в подсистеме (группе) - "", "Важный", "СмТакже".
    • НастройкиДляПоиска - Структура - дополнительные настройки для поиска этого варианта отчета, где: ** НаименованияПолей - Строка - имена полей варианта отчета. ** НаименованияПараметровИОтборов - Строка - имена настроек варианта отчета. ** КлючевыеСлова - Строка - дополнительная терминология (в т.ч. специализированная или устаревшая). ** ИменаМакетов - Строка - используется вместо НаименованияПолей.
    • СистемнаяИнформация - Структура - другая служебная информация.
    • Тип - Строка - перечень идентификаторов типов.
    • ЭтоВариант - Булево - признак того, что описание отчета относится к варианту отчета.
    • ФункциональныеОпции - Массив из Строка - коллекция идентификаторов функциональных опций, где:
    • ГруппироватьПоОтчету - Булево - признак необходимости группировки вариантов по отчету-основанию.
    • КлючЗамеров - Строка - идентификатор замера производительности отчета.
    • ОсновнойВариант - Строка - идентификатор основного варианта отчета.
    • ФорматНастроекСКД - Булево - признак хранения настроек в формате СКД.
    • ОпределитьНастройкиФормы - Булево - отчет имеет программный интерфейс для тесной интеграции с формой отчета, в том числе может переопределять некоторые настройки формы и подписываться на ее события. Если Истина и отчет подключен к общей форме ФормаОтчета, тогда в модуле объекта отчета следует определить процедуру по шаблону: // Задать настройки формы отчета. // // Параметры: // Форма - ФормаКлиентскогоПриложения, Неопределено // КлючВарианта - Строка, Неопределено // Настройки - см. ОтчетыКлиентСервер.НастройкиОтчетаПоУмолчанию // Процедура ОпределитьНастройкиФормы(Форма, КлючВарианта, Настройки) Экспорт // Код процедуры. КонецПроцедуры Пример реализации // Добавление варианта отчета в подсистему. НастройкиВарианта = ВариантыОтчетов.ОписаниеВарианта(Настройки, Метаданные.Отчеты.ИмяОтчета, "<ИмяВарианта>"); НастройкиВарианта.Размещение.Вставить(Метаданные.Подсистемы.ИмяРаздела.Подсистемы.ИмяПодсистемы); // Отключение варианта отчета. НастройкиВарианта = ВариантыОтчетов.ОписаниеВарианта(Настройки, Метаданные.Отчеты.ИмяОтчета, "<ИмяВарианта>"); НастройкиВарианта.Включен = Ложь; // Отключение всех вариантов отчета, кроме одного. НастройкиОтчета = ВариантыОтчетов.ОписаниеОтчета(Настройки, Метаданные.Отчеты.ИмяОтчета); НастройкиОтчета.Включен = Ложь; НастройкиВарианта = ВариантыОтчетов.ОписаниеВарианта(Настройки, НастройкиОтчета, "<ИмяВарианта>"); НастройкиВарианта.Включен = Истина; // Заполнение настроек для поиска - наименования полей, параметров и отборов: НастройкиВарианта = ВариантыОтчетов.ОписаниеВарианта(Настройки, Метаданные.Отчеты.ИмяОтчетаБезСхемы, ""); НастройкиВарианта.НастройкиДляПоиска.НаименованияПолей = НСтр("ru = 'Контрагент |Договор |Ответственный |Скидка |Дата'"); НастройкиВарианта.НастройкиДляПоиска.НаименованияПараметровИОтборов = НСтр("ru = 'Период |Ответственный |Контрагент |Договор'"); // Переключение режима вывода в панелях отчетов: // Группировка вариантов отчета по этому отчету: ВариантыОтчетов.УстановитьРежимВыводаВПанеляхОтчетов(Настройки, Метаданные.Отчеты.ИмяОтчета, Истина); // Без группировки по отчету: Отчет = ВариантыОтчетов.ОписаниеОтчета(Настройки, Метаданные.Отчеты.ИмяОтчета); ВариантыОтчетов.УстановитьРежимВыводаВПанеляхОтчетов(Настройки, Отчет, Ложь); Расположение Общий модуль ВариантыОтчетовПереопределяемый

Доступность

Сервер, Толстый клиент, Внешнее соединение