При разработке сложных отчетов на базе Системы компоновки данных (СКД) программисты часто сталкиваются с необходимостью программной установки параметров. Казалось бы, стандартная процедура в событии ПриОткрытии управляемой формы должна работать безупречно. Однако на практике возникает коварная ошибка: основной отчет формируется корректно, но при попытке расшифровать значение (сделать drill-down) система уходит в «вечный цикл» ожидания с надписью «Отчет формируется...».
В этой статье мы подробно разберем, почему возникает эта проблема, проанализируем механизмы платформы 1С:Предприятие 8.3 и найдем оптимальные способы решения, которые позволят вашим отчетам работать быстро и стабильно.
Давайте проанализируем ситуацию. Когда пользователь нажимает на ячейку в отчете для расшифровки, платформа выполняет следующие действия:
ПриСозданииНаСервере и ПриОткрытии.Проблема кроется в 4-м пункте. Если в коде процедуры ПриОткрытии прописана жесткая установка параметров без проверки контекста, происходит конфликт настроек. Платформа уже подготовила настройки для расшифровки, а ваш код принудительно перезаписывает КомпоновщикНастроек или его параметры. В результате фоновое задание, отвечающее за генерацию отчета, получает противоречивые данные или сбрасывается, что визуально выглядит как зависание процесса формирования.
Типичная ошибка выглядит следующим образом. Разработчик хочет, чтобы при открытии отчета автоматически подставлялись значения из формы-владельца или констант:
&НаКлиенте
Процедура ПриОткрытии(Отказ)
// Установка параметров напрямую без проверок
УстанавливаемПараметрОтчета(Объект.Счет, "Счет");
УстанавливаемПараметрОтчета(Объект.Организация, "Организация");
КонецПроцедуры
&НаКлиенте
Процедура УстанавливаемПараметрОтчета(ЗначениеПараметра, ИмяПараметра)
ПараметрДанных = Отчет.КомпоновщикНастроек.Настройки.ПараметрыДанных.Элементы.Найти(ИмяПараметра);
Если ПараметрДанных <> Неопределено Тогда
ПараметрДанных.Использование = Истина;
ПараметрДанных.Значение = ЗначениеПараметра;
КонецЕсли;
КонецПроцедуры
При таком подходе процедура ПриОткрытии срабатывает и при обычном запуске, и при запуске расшифровки. Во втором случае она перетирает то, что платформа заботливо подготовила для детального отчета.
Один из самых простых и быстрых способов — проверить заголовок или вариант отчета. Выясним, как это реализовать программно. Если отчет открыт в режиме расшифровки, платформа часто меняет заголовок формы на «Расшифровка» или использует предопределенное имя варианта.
&НаКлиенте
Процедура ПриОткрытии(Отказ)
// Проверяем, не является ли текущий контекст расшифровкой
Если Не ЭтаФорма.ПредставлениеТекущегоВарианта = "Расшифровка" Тогда
УстанавливаемПараметрОтчета(Счет, "Счет");
УстанавливаемПараметрОтчета(Организация, "Организация");
КонецЕсли;
КонецПроцедуры
Этот метод помог многим разработчикам, так как он эффективно отсекает выполнение лишнего кода при детализации данных. Однако стоит помнить, что полагаться на строковое представление (текст «Расшифровка») не всегда безопасно, так как оно может зависеть от локализации или настроек конкретной конфигурации.
Давайте разберем более надежный профессиональный подход. При программном открытии формы для расшифровки платформа передает в структуру Параметры формы специальные ключи. Мы можем проанализировать их наличие в событии ПриСозданииНаСервере.
Ключевыми признаками расшифровки являются свойства ДанныеРасшифровки, ЗначенияЗаполнения или СформироватьПриОткрытии. Если мы видим, что форма открывается для немедленного формирования по данным другого отчета, мы пропускаем блок инициализации параметров.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
// Если в параметрах есть ДанныеРасшифровки, значит это подчиненный отчет
ЭтоРасшифровка = Параметры.Свойство("ДанныеРасшифровки")
ИЛИ Параметры.Свойство("ЗначенияЗаполнения");
Если Не ЭтоРасшифровка Тогда
// Только здесь устанавливаем параметры по умолчанию
Настройки = Отчет.КомпоновщикНастроек.Настройки;
ЗначениеСчета = Настройки.ПараметрыДанных.Элементы.Найти("Счет");
// ... логика установки
КонецЕсли;
КонецПроцедуры
Проанализируем ситуацию глубже: установка параметров в ПриОткрытии на клиенте — это зачастую «наследие» старых подходов. В современной платформе 8.3 для управления настройками отчета лучше использовать серверные события расширения формы отчета, такие как ПриЗагрузкеВариантаНаСервере или ПриЗагрузкеПользовательскихНастроекНаСервере.
Почему это лучше? Эти обработчики вызываются платформой именно тогда, когда настройки компоновки объединяются (пользовательские + настройки схемы). Устанавливая значения здесь, вы гарантируете, что они будут правильно встроены в процесс компоновки макета и не вызовут «залипания» фонового задания.
Важный совет: При работе с расширениями (когда отчет добавлен в расширение) иногда наблюдаются странности с кэшированием. Если вышеописанные методы не помогают, попробуйте очистить серверный кэш или пересоздать форму отчета внутри расширения. Платформа 8.3.20 иногда требует «принудительного» обновления метаданных после изменения логики программной установки параметров.
Чтобы ваши отчеты СКД всегда работали корректно, придерживайтесь следующих правил:
ПриОткрытии без предварительной проверки заполненности.Параметры.Свойство("ДанныеРасшифровки"), чтобы понять, что отчет открывается как детальный.КомпоновщикНастроек на сторону сервера в специализированные процедуры.Использование = Истина для программно заполняемых параметров, иначе СКД может их проигнорировать.Разбирая подобные ситуации, мы видим, что «странное поведение» 1С часто имеет под собой четкую логику работы механизмов платформы. Понимание того, как инициализируется форма расшифровки, позволяет создавать надежные и удобные инструменты для пользователей.