Работа с формами в 1С:Предприятие — одна из ключевых задач как для разработчиков, так и для опытных пользователей. Часто требуется не просто открыть форму, а передать в неё дополнительные данные: фильтры, предварительно выбранные элементы или настройки отображения. Без правильного подхода это может привести к ошибкам, некорректному отображению данных или даже падению системы. В этой статье разберём все актуальные способы открытия форм с параметрами — от стандартных методов платформы до программных решений для сложных сценариев.

Особенность работы с параметрами в 1С заключается в том, что платформа предоставляет несколько альтернативных путей: через встроенные механизмы конфигуратора, с использованием языка 1С:Предприятие, а также через внешние обработки. Выбор метода зависит от версии платформы (8.3.x или 8.2), типа формы (управляемая или обычная) и конкретной задачи. Например, для передачи сложных структур данных потребуется один подход, а для простой фильтрации списка — другой. Мы рассмотрим каждый вариант с практическими примерами и предупреждениями о типичных ошибках.

Важно понимать, что неправильная передача параметров может не только нарушить логику работы формы, но и создать уязвимости в безопасности — особенно если параметры формируются на основе пользовательского ввода. Поэтому в статье уделено внимание не только технической реализации, но и проверке данных перед передачей.

Стандартные методы открытия форм с параметрами

Платформа 1С:Предприятие предлагает несколько встроенных способов передачи параметров в формы без написания кода. Эти методы подходят для большинства типовых задач и не требуют глубоких знаний программирования.

Самый простой способ — использование команды ОткрытьФорму() с указанием параметров в виде структуры. Например, для открытия формы элемента справочника с предварительно выбранной записью:

ПараметрыФормы = Новый Структура();

ПараметрыФормы.Вставить("Ключ", Справочники.Номенклатура.НайтиПоНаименованию("Товар1"));


ОткрытьФорму("Справочник.Номенклатура.ФормаЭлемента", ПараметрыФормы);

Для управляемых форм в версии 8.3 синтаксис аналогичен, но параметры передаются через свойство Параметры объекта формы.

  • 📌 Через контекстное меню: В некоторых конфигурациях (например, 1С:ERP или 1С:УТ) можно передать параметры через правый клик на объекте и выбор пункта "Открыть с параметрами".
  • 🔄 Через командный интерфейс: Команды формы могут содержать параметры, которые автоматически передаются при её открытии (настраивается в конфигураторе).
  • 📊 Через отчёты и обработки: При открытии отчёта из формы можно передать текущие фильтры как параметры.
⚠️ Внимание: В обычных формах (не управляемых) параметры передаются только при первом открытии. Повторное открытие той же формы без закрытия предыдущего экземпляра может привести к игнорированию новых параметров.
📊 Какую версию 1С вы используете?
8.3 (управляемые формы)
8.2 (обычные формы)
Обе версии
Не знаю

Программное открытие форм с параметрами на языке 1С

Для гибкой работы с параметрами часто требуется написать код на встроенном языке. Это позволяет передавать сложные структуры данных, динамически формировать параметры и обрабатывать ошибки.

Основной метод — использование функции ОткрытьФорму() с указанием имени формы и структуры параметров. Например, для передачи нескольких параметров в форму документа:

Параметры = Новый Структура();

Параметры.Вставить("ДатаНачала", НачалоДня(ТекущаяДата()));


Параметры.Вставить("ДатаОкончания", КонецДня(ТекущаяДата()));


Параметры.Вставить("ТолькоАктивные", Истина);



ОткрытьФорму("Документ.РеализацияТоваровУслуг.ФормаСписка", Параметры, ЭтотОбъект);

Для управляемых форм в версии 8.3 можно использовать метод ОткрытьФормуМодально(), если требуется дождаться закрытия формы и получить результат:

Результат = ОткрытьФормуМодально("Документ.ЗаказПокупателя.ФормаЭлемента",

Новый Структура("Контрагент", Справочники.Контрагенты.НайтиПоНаименованию("ООО Розница")),


ЭтотОбъект);



Если Результат = Неопределено Тогда


Сообщить("Форма закрыта без сохранения!");


КонецЕсли;

Особое внимание уделите проверке передаваемых параметров. Например, если в форму передаётся ссылка на справочник, убедитесь, что объект существует:

Если НЕ ЗначениеЗаполнено(Параметры.Контрагент) Тогда

ВызватьИсключение "Не указан контрагент!";


КонецЕсли;

Имя параметра совпадает с реквизитом формы|

Значение параметра не является Неопределено|

Тип данных параметра соответствует ожидаемому|

Права пользователя позволяют работать с передаваемыми данными-->

Передача сложных параметров: структуры, массивы, объекты

Иногда требуется передать в форму не просто примитивные значения (строку или число), а сложные структуры данных: таблицы значений, массивы или даже объекты. Для этого используются специальные приёмы.

Например, передача таблицы значений с предварительно отфильтрованными данными:

ТаблицаТоваров = Новый ТаблицаЗначений;

ТаблицаТоваров.Колонки.Добавить("Номенклатура");


ТаблицаТоваров.Колонки.Добавить("Количество");



Запрос = Новый Запрос;


Запрос.Текст = "ВЫБРАТЬ ПЕРВЫЕ 10


Товары.Ссылка КАК Номенклатура,


Товары.КоличествоОстаток КАК Количество


ИЗ РегистрНакопления.ОстаткиТоваров.Остатки КАК Товары";


РезультатЗапроса = Запрос.Выполнить();


Выборка = РезультатЗапроса.Выбрать();



Пока Выборка.Следующий() Цикл


НоваяСтрока = ТаблицаТоваров.Добавить();


НоваяСтрока.Номенклатура = Выборка.Номенклатура;


НоваяСтрока.Количество = Выборка.Количество;


КонецЦикла;



Параметры = Новый Структура("Товары", ТаблицаТоваров);


ОткрытьФорму("Обработка.АнализОстатков.ФормаОбработки", Параметры);

Для передачи объектов (например, документа или справочника) важно учитывать, что в управляемых формах объекты передаются по ссылке, а в обычных — могут копироваться. Это влияет на производительность и актуальность данных.

Тип параметра Пример передачи Особенности
Структура Новый Структура("Поле1, Значение1, Поле2, Значение2") Удобна для передачи набора простых значений
Таблица значений Новый ТаблицаЗначений; Таблица.Колонки.Добавить("Имя") Подходит для передачи списков данных с колонками
Массив Новый Массив; Массив.Добавить(Значение1) Используется для передачи упорядоченного списка значений
Объект (справочник, документ) Справочники.Номенклатура.НайтиПоНаименованию("Товар") В управляемых формах передаётся ссылка, в обычных — может копироваться
⚠️ Внимание: При передаче больших таблиц значений (более 1000 строк) в форму может возникнуть задержка интерфейса. В таких случаях лучше передавать только идентификаторы данных и загружать детали по требованию.

Ошибки при работе с параметрами форм и их решения

Даже опытные разработчики сталкиваются с проблемами при передаче параметров в формы. Рассмотрим наиболее распространённые ошибки и способы их устранения.

1. Параметры не передаются в форму

Частая причина — несовпадение имён параметров с именами реквизитов формы. Например, если в коде указан параметр ДатаНачала, а в форме реквизит называется ПериодНачала, данные не будут переданы. Решение:

  • 🔍 Проверьте имена реквизитов формы в конфигураторе (закладка "Реквизиты").
  • 📝 Убедитесь, что регистр имён совпадает (в 1С имена чувствительны к регистру!).

2. Ошибка "Неопределённое значение параметра"

Возникает, когда в форму передаётся Неопределено или NULL. Например, при передаче несуществующей ссылки на справочник:

Параметры.Вставить("Контрагент", Справочники.Контрагенты.НайтиПоНаименованию("Несуществующий"));

// Если контрагент не найден, будет передано Неопределено

Решение: всегда проверяйте значения перед передачей:

Контрагент = Справочники.Контрагенты.НайтиПоНаименованию("ООО Тест");

Если Контрагент = Неопределено Тогда


Сообщить("Контрагент не найден!");


Возврат;


КонецЕсли;

3. Форма открывается, но данные не отображаются

Это может происходить из-за:

  • 🔄 Неправильного типа данных (например, передаётся строка вместо даты).
  • 🛡️ Ограничений прав доступа (пользователь не имеет прав на просмотр передаваемых данных).
  • 📱 Несовместимости версий (например, форма разработана для 8.3.10, а используется 8.3.8).
Что делать, если параметры передаются, но форма ведёт себя нестабильно?

Если форма открывается, но после передачи параметров возникают зависания или ошибки, проверьте:

1. Объём передаваемых данных — большие таблицы значений могут блокировать интерфейс.

2. Рекурсивные вызовы — если в обработчике формы снова открывается та же форма с параметрами, это может привести к зацикливанию.

3. Конфликты имён — если имя параметра совпадает с именем стандартного реквизита платформы (например, "ЭтоГруппа" или "ПометкаУдаления"), это может вызвать ошибки.

В таких случаях используйте отладчик (F5 в конфигураторе) для пошагового анализа кода.

Передача параметров между формами: родительская и дочерняя формы

Часто требуется передавать данные между связанными формами — например, из формы списка в форму элемента или между обработками. Для этого используются механизмы обмена данными между формами.

Для управляемых форм в версии 8.3 можно использовать свойство РодительскаяФорма и методы обратного вызова. Например, чтобы передать данные из формы списка в форму элемента:

// В форме списка (родительской)

Процедура ОткрытьЭлемент(Элемент)


Параметры = Новый Структура();


Параметры.Вставить("Элемент", Элемент);


Параметры.Вставить("Режим", "Просмотр");



НоваяФорма = ОткрытьФорму("Документ.ЗаказПокупателя.ФормаЭлемента", Параметры, ЭтотОбъект);


КонецПроцедуры



// В форме элемента (дочерней)


Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)


Если Параметры.Свойство("Элемент") Тогда


Объект = Параметры.Элемент;


КонецЕсли;


КонецПроцедуры

Для обратной связи (например, чтобы дочерняя форма вернула данные родительской) используйте метод Закрыть() с указанием результата:

// В дочерней форме

Процедура СохранитьИЗакрыть(Результат)


Закрыть(Результат);


КонецПроцедуры



// В родительской форме


Процедура ПослеЗакрытияФормы(Результат, ПараметрыЗакрытия)


Если Результат <> Неопределено Тогда


Сообщить("Получен результат: " + Результат);


КонецЕсли;


КонецПроцедуры

В обычных формах (8.2) для обмена данными между формами часто используют глобальные переменные или временные хранилища, но этот подход менее надёжен и может приводить к конфликтам при многопользовательской работе.

💡

Если вам нужно передать между формами большой объём данных, рассмотрите возможность использования временного хранилища (ПоместитьВоВременноеХранилище() и ПолучитьИзВременногоХранилища()). Это снизит нагрузку на память и ускорит работу интерфейса.

Особенности передачи параметров в типовых конфигурациях (1С:ERP, 1С:УТ, 1С:БП)

Типовые конфигурации (1С:ERP Управление предприятием, 1С:Управление торговлей, 1С:Бухгалтерия предприятия) имеют свои нюансы при работе с параметрами форм. Рассмотрим ключевые моменты для популярных решений.

В 1С:ERP и 1С:УТ многие формы уже содержат заложенные механизмы для передачи параметров. Например, при открытии формы документа "Реализация товаров и услуг" можно передать:

  • 📅 Период — дату или диапазон дат для фильтрации.
  • 🏢 Контрагента — предварительно выбранного партнёра.
  • 📦 Номенклатуру — фильтр по товарам.

Пример для 1С:Бухгалтерия предприятия 3.0:

Параметры = Новый Структура();

Параметры.Вставить("ДатаНачала", '2026-01-01');


Параметры.Вставить("ДатаОкончания", '2026-01-31');


Параметры.Вставить("ТолькоПроводки", Истина);



ОткрытьФорму("Документ.ПоступлениеТоваровУслуг.ФормаСписка", Параметры);

В типовых конфигурациях часто используются стандартные обработчики событий форм, такие как ПриОткрытии или ПередОткрытием, где можно модифицировать параметры или добавлять дополнительную логику. Например, в 1С:Зарплата и управление персоналом при открытии формы расчётного листка автоматически применяются настройки фильтрации по текущему сотруднику.

⚠️ Внимание: В типовых конфигурациях не рекомендуется изменять стандартные формы без необходимости. Вместо этого используйте механизм расширений или создавайте внешние обработки с передачей параметров.

Практические примеры: от простых к сложным сценариям

Рассмотрим несколько реальных примеров передачи параметров в формы, от базовых до продвинутых.

Пример 1: Открытие формы справочника с фильтром

Задача: открыть форму справочника "Номенклатура" с предварительно применённым фильтром по группе "Товары".

Параметры = Новый Структура();

Параметры.Вставить("Группа", Справочники.Номенклатура.НайтиПоНаименованию("Товары"));


Параметры.Вставить("ТолькоАктивные", Истина);



ОткрытьФорму("Справочник.Номенклатура.ФормаСписка", Параметры);

Пример 2: Передача данных между обработками

Задача: передать таблицу с данными из одной обработки в другую для дальнейшей обработки.

// В первой обработке

ТаблицаДанных = ПолучитьДанныеИзБазы(); // Предполагаем, что функция возвращает ТаблицуЗначений


Параметры = Новый Структура("Данные", ТаблицаДанных);


ОткрытьФорму("Обработка.АнализДанных.ФормаОбработки", Параметры);



// Во второй обработке


Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)


Если Параметры.Свойство("Данные") Тогда


ДанныеДляАнализа = Параметры.Данные;


ЗаполнитьОтчёт(ДанныеДляАнализа);


КонецЕсли;


КонецПроцедуры

Пример 3: Динамическое формирование параметров на основе пользовательского ввода

Задача: открыть форму отчёта с параметрами, которые пользователь ввёл в диалоговом окне.

Диалог = Новый ДиалогВводаДанных();

Диалог.Вопрос("Укажите параметры отчёта", "Период с:");


Диалог.ПолеВвода1.ТипЗначения = Новый ОписаниеТипов("Дата");


Диалог.ПолеВвода1.Значение = НачалоДня(ТекущаяДата());



Диалог.Вопрос("по:");


Диалог.ПолеВвода2.ТипЗначения = Новый ОписаниеТипов("Дата");


Диалог.ПолеВвода2.Значение = КонецДня(ТекущаяДата());



Если Диалог.Открыть() Тогда


Параметры = Новый Структура();


Параметры.Вставить("ДатаНачала", Диалог.ПолеВвода1.Значение);


Параметры.Вставить("ДатаОкончания", Диалог.ПолеВвода2.Значение);


ОткрытьФорму("Отчёт.Продажи.ФормаОтчёта", Параметры);


КонецЕсли;

Важно: При динамическом формировании параметров всегда валидируйте пользовательский ввод, особенно если данные используются в запросах к базе. Это предотвратит SQL-инъекции и ошибки выполнения.

FAQ: Частые вопросы по работе с параметрами форм в 1С

Как передать параметр в форму, если её имя неизвестно заранее?

Если имя формы динамически формируется (например, в зависимости от типа документа), используйте функцию ПолучитьИмяФормы() или обратитесь к метаданным:

ИмяФормы = Метаданные.Документы[ТипДокумента].Формы.ФормаЭлемента.Имя;

ОткрытьФорму(ИмяФормы, Параметры);

В управляемых формах можно использовать метод ПолучитьФорму() с указанием типа объекта.

Можно ли передавать в форму объекты, не являющиеся справочниками или документами?

Да, можно передавать любые объекты, поддерживаемые платформой: таблицы значений, структуры, массивы, а также пользовательские объекты (если они сериализуемы). Например:

Параметры = Новый Структура();

Параметры.Вставить("Настройки", Новый Структура("ЦветФона, Красный, РазмерШрифта, 12"));


ОткрытьФорму("Обработка.НастройкиИнтерфейса.ФормаОбработки", Параметры);

Однако учитывайте, что сложные объекты (например, с циклическими ссылками) могут не корректно передаваться.

Почему при передаче параметров в форму они сбрасываются после обновления?

Это типичная проблема обычных форм (8.2), где параметры передаются только при первом открытии. Решения:

  • Используйте управляемые формы (8.3), где параметры сохраняются.
  • Храните параметры в модуле формы и восстанавливайте их при обновлении.
  • Передавайте параметры через глобальные переменные или временное хранилище.
Как передать параметры в форму отчёта?

Для форм отчётов параметры передаются аналогично другим формам, но часто используются стандартные реквизиты отчёта. Пример:

Параметры = Новый Структура();

Параметры.Вставить("Период", Новый Структура("ДатаНачала, '2026-01-01', ДатаОкончания, '2026-01-31'));


Параметры.Вставить("Организация", Справочники.Организации.НайтиПоНаименованию("ООО Альфа"));



ОткрытьФорму("Отчёт.ОборотноСальдоваяВедомость.ФормаОтчёта", Параметры);

В типовых отчётах (например, в 1С:БП) имена параметров обычно соответствуют именам реквизитов отчёта, указанных в его схеме.

Как передать параметры в форму из внешней обработки?

При открытии формы из внешней обработки используйте тот же метод ОткрытьФорму(), но убедитесь, что обработка имеет права на доступ к форме. Пример:

Параметры = Новый Структура("Контрагент", Справочники.Контрагенты.ТекущийЭлемент());

Попытка


ОткрытьФорму("Документ.ЗаказПокупателя.ФормаСписка", Параметры);


Исключение


Сообщить("Ошибка открытия формы: " + ОписаниеОшибки());


КонецПопытки;

Если форма не открывается, проверьте права пользователя и наличие формы в конфигурации.