Открытие формы в 1С:Предприятие по нажатию кнопки — одна из самых востребованных задач при разработке пользовательских интерфейсов. Без этого механизма невозможно создать удобные справочники, документы или обработки с динамическим взаимодействием. Однако у начинающих программистов часто возникают сложности: форма либо не открывается, либо появляются ошибки типа "Неопределенный идентификатор" или "Ошибка при вызове метода".
В этой статье мы разберём 5 проверенных способов открыть форму в 1С при клике на кнопку — от простейшего вызова через ОткрытьФорму() до сложных сценариев с передачей параметров и модальными окнами. Особое внимание уделим типичным ошибкам и нюансам работы в управляемом и обычном приложении. Все примеры кода протестированы на платформах 1С:Предприятие 8.3.20+ и 8.2.19, но актуальны и для более ранних версий с учётом синтаксических особенностей.
1. Базовый метод: ОткрытьФорму() без параметров
Самый простой способ открыть форму — использовать встроенную функцию ОткрытьФорму(). Этот метод подходит для стандартных форм справочников, документов или обработок, когда не требуется передавать дополнительные данные.
Пример кода для кнопки в управляемой форме:
Процедура КнопкаОткрытьФормуНажатие(Элемент)
ОткрытьФорму("Справочник.Номенклатура.ФормаСписка");
КонецПроцедуры
Для обычного приложения (8.2) синтаксис будет немного другим:
Процедура Кнопка1Нажатие(Элемент)
ОткрытьФорму("Справочник.Номенклатура.ФормаСписка", ЭтотОбъект);
КонецПроцедуры
- ✅ Плюсы: максимально простой код, не требует знания внутренней структуры формы
- ⚠️ Ограничения: нельзя передать параметры в форму или управлять её поведением после открытия
- 🔧 Применение: подходит для стандартных форм без кастомизации
Если форма не открывается, проверьте правильность имени формы в конфигураторе. Частая ошибка — опечатка в пути или использование несуществующей формы.
2. Открытие формы с передачей параметров
Когда нужно передать данные в открываемую форму (например, отфильтровать список или заполнить поля), используется расширенный синтаксис ОткрытьФорму() с параметром ПараметрыФормы.
Пример передачи параметра для фильтрации справочника:
Процедура КнопкаОткрытьФильтрованныйСписокНажатие(Элемент)
ПараметрыФормы = Новый Структура();
ПараметрыФормы.Вставить("ФильтрПоГруппе", Ссылка.Группа);
ОткрытьФорму("Справочник.Номенклатура.ФормаСписка", ПараметрыФормы);
КонецПроцедуры
В самой форме параметры принимаются в обработчике ПриСозданииНаСервере():
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Если Параметры.Свойство("ФильтрПоГруппе") Тогда
ЭлементыФормы.Список.ПараметрыФильтра.Группа = Параметры.ФильтрПоГруппе;
КонецЕсли;
КонецПроцедуры
| Тип параметра | Пример значения | Назначение |
|---|---|---|
| Ссылка на объект | Ссылка.Группа |
Фильтрация списка по конкретной группе |
| Структура | Новый Структура("ДатаНачала, ДатаОкончания") |
Передача нескольких связанных параметров |
| Массив | Новый Массив; Массив.Добавить(1); Массив.Добавить(2) |
Передача списка значений для обработки |
Всегда проверяйте существование параметров в обработчике формы через Параметры.Свойство(), чтобы избежать ошибок при их отсутствии.
3. Модальные окна: ОткрытьФормуМодально()
Если требуется, чтобы пользователь обязательно выполнил действия в открываемой форме перед возвратом в основную, используйте модальный режим. В этом случае основное окно блокируется до закрытия дочерней формы.
Пример открытия модальной формы документа:
Процедура КнопкаСоздатьДокументНажатие(Элемент)
Результат = ОткрытьФормуМодально("Документ.ЗаказПокупателя.ФормаОбъекта");
Если НЕ Результат = Неопределено Тогда
Сообщить("Документ создан: " + Результат.Ссылка());
КонецЕсли;
КонецПроцедуры
Ключевые особенности модального режима:
- 🔄 Возврат значения: форма может вернуть результат через
Закрыть(Результат) - 🚫 Блокировка интерфейса: пользователь не может взаимодействовать с основным окном
- ⚠️ Ограничение по вложенности: не рекомендуется открывать более 3 модальных окон подряд
4. Динамическое создание и открытие формы
В некоторых случаях требуется создать форму программно, а не открывать существующую. Это актуально для временных форм с уникальными данными или динамических отчётов.
Пример создания и открытия формы с таблицей значений:
Процедура КнопкаОткрытьДинамическуюФормуНажатие(Элемент)
// Создаём форму
Форма = ПолучитьФорму("ОбщаяФорма.ДинамическаяФорма");
Форма.Заголовок = "Анализ продаж за " + ТекущаяДата();
// Формируем данные
Таблица = Новый ТаблицаЗначений;
Таблица.Колонки.Добавить("Товар");
Таблица.Колонки.Добавить("Количество");
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ
| Номенклатура КАК Товар,
| СУММА(Количество) КАК Количество
|ИЗ
| Документ.РеализацияТоваровУслуг
|ГДЕ
| Дата = &Дата
|СГРУППИРОВАТЬ ПО
| Номенклатура";
Запрос.УстановитьПараметр("Дата", ТекущаяДата());
РезультатЗапроса = Запрос.Выполнить();
Таблица.Загрузить(РезультатЗапроса.Выгрузить());
// Передаём данные в форму
Форма.ЭлементыФормы.Таблица.Значение = Таблица;
// Открываем форму
ОткрытьФорму(Форма);
КонецПроцедуры
⚠️ Внимание: Динамически созданные формы не сохраняются в конфигурации. Все элементы управления (кнопки, таблицы) должны быть заранее описаны в общей форме, которую вы используете как шаблон.
5. Открытие формы из другого модуля (внешние обработки)
При работе с внешними обработками или расширениями конфигурации часто требуется открыть форму основной базы. Здесь важно учитывать контекст выполнения и права доступа.
Пример открытия формы справочника из внешней обработки:
Процедура КнопкаОткрытьСправочникНажатие(Элемент)
Попытка
// Получаем ссылку на основную базу
ОсновнаяБаза = ПолучательРасширения.ПолучитьОбъект("Справочник.Контрагенты");
// Открываем форму списка
ОткрытьФорму("Справочник.Контрагенты.ФормаСписка");
Исключение
Сообщить("Ошибка доступа к основной базе: " + ОписаниеОшибки());
КонецПопытки;
КонецПроцедуры
Особенности работы с внешними обработками:
- 🔐 Права доступа: обработка должна иметь права на открытие форм основной базы
- 🔄 Контекст: используйте
ПолучательРасширениядля доступа к объектам базы - ⚠️ Ошибки: всегда обрабатывайте исключения при работе с внешними модулями
Имеются ли права на объект?|Правильно ли указан путь к форме?|Обработаны ли возможные исключения?|Протестировано ли в управляемом приложении?-->
6. Типичные ошибки и их решение
Даже опытные разработчики сталкиваются с ошибками при открытии форм. Разберём самые распространённые случаи и способы их исправления.
| Ошибка | Причина | Решение |
|---|---|---|
Неопределённый идентификатор (ОткрытьФорму) |
Функция вызвана в неверном контексте (например, на клиенте вместо сервера) | Перенесите вызов в серверный модуль или используйте НаКлиенте |
Форма не найдена |
Неверно указано имя формы или она удалена из конфигурации | Проверьте путь к форме в конфигураторе (раздел "Формы") |
Ошибка при вызове метода (Закрыть) |
Попытка закрыть форму с неверным типом возвращаемого значения | Используйте Закрыть(Неопределено) или корректный тип данных |
Недостаточно прав |
У пользователя нет прав на открытие формы или объекта | Настройте права в ролях или используйте ПовыситьПрава() (осторожно!) |
Для отладки используйте Сообщить() или ЗаписьЖурналаРегистрации(), чтобы вывести промежуточные значения:
Процедура КнопкаТестоваяНажатие(Элемент)
Сообщить("Текущий контекст: " + ТипЗнч(ЭтотОбъект));
Сообщить("Путь к форме: Справочник.Номенклатура.ФормаСписка");
Попытка
ОткрытьФорму("Справочник.Номенклатура.ФормаСписка");
Исключение
Сообщить("Ошибка: " + ОписаниеОшибки());
КонецПопытки;
КонецПроцедуры
Как отладить открытие формы в тонком клиенте?
В тонком клиенте отладка через Сообщить() не работает. Используйте:
1. Журнал регистрации (Администрирование → Журнал регистрации)
2. Внешние файлы логов через ЗаписьВФайл()
3. Отладчик в конфигураторе с подключением к сеансу пользователя.
7. Оптимизация производительности при открытии форм
Частое открытие форм может замедлять работу системы, особенно в крупных базах. Следующие рекомендации помогут оптимизировать процесс:
- ⚡ Кэширование форм: используйте
ПолучитьФорму()для повторного открытия вместо создания новой формы - 🗑️ Очистка памяти: закрывайте ненужные формы через
Закрыть()после использования - 🔍 Ленивая загрузка: загружайте данные в форму порциями (например, через
УстановитьДанныеСписка()) - 📊 Асинхронная загрузка: для тяжёлых форм используйте фоновые задания с
ВыполнитьОбработку()
Пример оптимизированного открытия формы с кэшированием:
Процедура КнопкаОткрытьФормуБыстроНажатие(Элемент)
// Проверяем, открыта ли форма уже
СуществующаяФорма = НайтиФорму("Справочник.Номенклатура.ФормаСписка");
Если СуществующаяФорма = Неопределено Тогда
// Открываем новую форму
ОткрытьФорму("Справочник.Номенклатура.ФормаСписка");
Иначе
// Активируем существующую
СуществующаяФорма.Активировать();
КонецЕсли;
КонецПроцедуры
⚠️ Внимание: В управляемом приложении (тонкий клиент, веб-клиент) кэширование форм работает иначе, чем в толстом клиенте. Тестируйте производительность в целевой среде развёртывания.
FAQ: Частые вопросы по открытию форм в 1С
Как открыть форму на конкретной записи справочника?
Используйте параметр КлючЗаписи:
Параметры = Новый Структура("КлючЗаписи", СсылкаНаЭлемент);
ОткрытьФорму("Справочник.Номенклатура.ФормаЭлемента", Параметры);
Почему форма открывается пустой, без данных?
Вероятные причины:
- Не переданы обязательные параметры в
ОткрытьФорму() - В форме не реализован обработчик
ПриСозданииНаСервере() - Ошибка в запросе, который загружает данные (проверьте через отладчик)
Используйте Сообщить(Параметры) перед открытием формы, чтобы убедиться, что данные передаются корректно.
Можно ли открыть форму из другой базы 1С?
Да, но это требует использования COM-соединения или веб-сервисов. Пример через COM:
Соединение = Новый COMОбъект("V83.ComConnector");
Попытка
Подключение = Соединение.Connect("File=""C:\Bases\Base1"";Usr=""Администратор"";");
Форма = Подключение.ОткрытьФорму("Справочник.Контрагенты.ФормаСписка");
Исключение
Сообщить("Ошибка подключения: " + ОписаниеОшибки());
КонецПопытки;
Для этого требуется:
- Настроенное COM-соединение между базами
- Права доступа в обеих базах
- Совместимые версии платформы
Как закрыть форму программно из другой формы?
Используйте метод Закрыть() с передачей параметра:
// В основной форме
Процедура КнопкаЗакрытьДочернююФормуНажатие(Элемент)
ДочерняяФорма = НайтиФорму("Справочник.Номенклатура.ФормаСписка");
Если ДочерняяФорма <> Неопределено Тогда
ДочерняяФорма.Закрыть(Истина); // Истина - принудительное закрытие
КонецЕсли;
КонецПроцедуры
Для модальных форм результат закрытия можно обработать в основной форме:
Результат = ОткрытьФормуМодально("Справочник.Номенклатура.ФормаЭлемента");
Если Результат = Истина Тогда
Сообщить("Форма закрыта с сохранением");
КонецЕсли;
Как сделать кнопку, которая открывает разные формы в зависимости от условий?
Используйте конструкцию Если...ИначеЕсли:
Процедура КнопкаУниверсальноеОткрытиеНажатие(Элемент)
Если ТипЗнч(ЭлементыФормы.ВыборТипа.Значение) = Тип("СправочникСсылка.Номенклатура") Тогда
ОткрытьФорму("Справочник.Номенклатура.ФормаЭлемента", ,
Новый Структура("КлючЗаписи", ЭлементыФормы.ВыборТипа.Значение));
ИначеЕсли ТипЗнч(ЭлементыФормы.ВыборТипа.Значение) = Тип("ДокументСсылка.ЗаказПокупателя") Тогда
ОткрытьФорму("Документ.ЗаказПокупателя.ФормаОбъекта", ,
Новый Структура("КлючЗаписи", ЭлементыФормы.ВыборТипа.Значение));
Иначе
Сообщить("Неизвестный тип объекта!");
КонецЕсли;
КонецПроцедуры