Создание форм в 1С: от простого к сложному — полное руководство с примерами

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

Мы рассмотрим не только стандартные способы создания форм через конструктор, но и ручное программирование с использованием 1C:Enterprise и встроенного языка. Особое внимание уделим типичным ошибкам, которые допускают разработчики, и способам их избежать. В конце вы найдете ответы на частые вопросы и практические советы по оптимизации форм для разных версий платформы.

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

1. Виды форм в 1С: когда и какую использовать

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

Управляемые формы — современный подход, рекомендуемый для новых конфигураций. Они автоматически адаптируются под разные устройства (ПК, планшеты), поддерживают динамическое изменение интерфейса и имеют встроенные механизмы валидации. Идеальны для веб-клиента и тонкого клиента. Однако их настройка требует больше времени и знаний.

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

• 📌 Управляемая форма — для новых конфигураций, веб-доступа, сложных сценариев
• 📌 Обычная форма — для поддержки старых решений или простых диалогов в толстом клиенте
• 📌 Форма списка — для отображения табличных данных (например, списка документов)
• 📌 Форма объекта — для работы с отдельным документом, справочником или регистром

Особняком стоят внешние формы, которые создаются отдельно от конфигурации и подключаются динамически. Их удобно использовать для временных решений или когда нужно разделить логику интерфейса и данных. Например, для интеграции с внешними системами через HTTP-сервисы.

2. Создание формы через конструктор: быстрый старт

Начнем с самого простого способа — использования встроенного конструктора форм. Этот метод подходит для базовых задач и позволяет сэкономить время на рутинных операциях. Рассмотрим процесс на примере создания формы для справочника "Контрагенты".

Откройте конфигуратор (Файл → Открыть конфигурацию) и выполните следующие шаги:

1. В дереве объектов найдите справочник "Контрагенты" и откройте его свойства двойным кликом.
2. Перейдите на вкладку Формы и нажмите Добавить.
3. Выберите тип формы — например, Форма объекта.
4. В открывшемся окне конструктора отметьте галочками поля, которые должны отображаться на форме (наименование, ИНН, адрес и т.д.).
5. Нажмите Готово — форма будет создана автоматически.

Конструктор сформирует базовую структуру с полями ввода, кнопками Записать и Закрыть, а также стандартными командами. Однако такая форма часто требует доработки: например, может понадобиться изменить порядок полей, добавить выпадающие списки или связать данные с другими справочниками.

Выбрать объект (справочник, документ, регистр) в дереве конфигурации

Определить тип формы (объекта, списка, выбора)

Отметить необходимые реквизиты и табличные части

Проверить права доступа для пользователей

Сохранить конфигурацию перед генерацией-->

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

3. Ручная настройка формы: работа с дизайнером

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

Откройте форму в режиме редактирования (ПКМ по форме → Открыть) и ознакомьтесь с основными инструментами:

• 🎨 Панель элементов — содержит все доступные controls (поля ввода, кнопки, таблицы, диаграммы и т.д.).
• 📏 Сетка выравнивания — помогает точно позиционировать элементы. Можно включить привязку к сетке в настройках.
• 🔧 Панель свойств — здесь настраиваются параметры выбранного элемента (размер, шрифт, привязка данных).
• 📂 Дерево элементов — иерархическое отображение всех компонентов формы для быстрой навигации.

Пример ручной доработки: предположим, нам нужно добавить на форму справочника "Контрагенты" поле для ввода КПП, которого нет в стандартной конфигурации. Для этого:

1. Перетащите элемент Поле ввода из панели на форму.
2. В панели свойств укажите:
   • Имя — КПП
   • Заголовок — КПП
   • Тип значения — Строка (длина 9 символов)
   • Данные — свяжите с реквизитом объекта (если он уже существует в справочнике)
3. Настройте маску ввода (Формат), чтобы пользователь мог вводить только цифры.

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

Как изменить порядок табуляции между полями?

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

4. Программирование логики формы: события и модули

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

Основные события, с которыми приходится работать:

Событие	Когда происходит	Типичное использование
ПриСозданииНаСервере	Форма создается на сервере	Инициализация данных, проверка прав
ПриОткрытии	Форма открывается на клиенте	Настройка интерфейса, загрузка справочников
ПередЗаписью	Перед сохранением данных	Валидация полей, расчет сумм
ОбработкаПолученияДанных	При динамическом чтении данных	Фильтрация списков, сортировка

Пример: добавим проверку корректности ИНН при записи контрагента. В модуле формы создадим обработчик события ПередЗаписью:

Процедура ПередЗаписью(Отказ, ПараметрыЗаписи)
Если НЕ ЗначениеЗаполнено(Объект.ИНН) Тогда
Предупреждение("ИНН не заполнен!", 60);
Отказ = Истина;
ИначеЕсли НЕ РегулярныеВыражения.ПроверкаСтроки(Объект.ИНН, "^\d{10,12}$") Тогда
Предупреждение("Некорректный формат ИНН! Допустимо 10 или 12 цифр.", 60);
Отказ = Истина;
КонецЕсли;
КонецПроцедуры

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

⚠️ Внимание: При работе с событиями НаСервере и НаКлиенте следите за контекстом выполнения. Попытка обратиться к клиентским объектам в серверном коде приведет к ошибке. Используйте директивы компиляции &НаКлиенте и &НаСервере для явного указания контекста.

5. Типичные ошибки и как их избежать

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

• 🚨 Форма не открывается — проверьте права доступа в ролях (Администрирование → Пользователи). Часто проблема кроется в отсутствии прав на объект или форму.
• 🚨 Данные не сохраняются — убедитесь, что в модуле формы нет ошибок в обработчике ПередЗаписью (например, всегда стоит Отказ = Истина).
• 🚨 Элементы наезжают друг на друга — используйте контейнеры (группы) для логического разделения элементов и настройте параметр АвтоРазмер.
• 🚨 Медленная загрузка формы — оптимизируйте запросы к базе, используйте отложенную загрузку данных для табличных частей.

Особое внимание уделите привязке данных. Если поле формы не связано с реквизитом объекта, изменения не будут сохраняться. Проверьте свойство Данные у каждого элемента — оно должно указывать на соответствующий атрибут (например, Объект.Наименование).

Еще одна частая проблема — некорректная работа в веб-клиенте. Управляемые формы должны тестироваться в разных режимах (толстый клиент, тонкий клиент, веб-браузер). Например, некоторые элементы (например, ActiveX) не поддерживаются в веб-версии.

💡

Всегда тестируйте формы в том режиме, в котором они будут использоваться. Особенно это касается веб-клиента, где ограничения на клиентский код строже, чем в толстом клиенте.

Если форма содержит сложную логику, разбейте её на несколько модулей:

- Основной модуль формы — для общих процедур.

- Модули команд — для обработки действий пользователя (например, нажатия кнопок).

- Модули элементов — для логики отдельных controls (например, динамическое заполнение выпадающего списка).

6. Продвинутые техники: динамические формы и интеграция

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

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

Процедура ПриОткрытии(Отказ)
Если Пользователь.Роль = "Менеджер" Тогда
ЭлементыФормы.ГруппаРасширенныеНастройки.Видимость = Ложь;
КонецЕсли;
КонецПроцедуры

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

Процедура ОтправитьВCRM(Команда)
Запрос = Новый HTTPЗапрос("https://api.crm.example.com/leads");
Запрос.Заголовки.Вставить("Authorization", "Bearer " + ПолучитьТокен());
Запрос.УстановитьТекст(СериализоватьВJSON(Объект));

Ответ = Новый HTTPСоединение().Получить(Запрос);
Если Ответ.КодСостояния <> 200 Тогда
Сообщить("Ошибка отправки: " + Ответ.ПолучитьТекст());
Иначе
Сообщить("Данные успешно отправлены!");
КонецЕсли;
КонецПроцедуры

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

Процедура СписокТоваровПриАктивизацииСтроки(Элемент)
Если НЕ СписокТоваров.Загружен Тогда
СписокТоваров.ЗагрузитьСтраницу(0, 50); // Загружаем первые 50 строк
КонецЕсли;
КонецПроцедуры

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

7. Оптимизация производительности форм

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

• ⚡ Ленивая загрузка — загружайте данные для табличных частей только при их активации (событие ПриАктивизации).
• ⚡ Кэширование — храните часто используемые справочники в клиентском кэше (ПоместитьВКэш()).
• ⚡ Ограничение выборок — используйте отборы и лимиты в запросах к базе.
• ⚡ Асинхронные операции — для длительных процессов (например, формирование отчетов) используйте ВыполнитьОбработкуНаСервереБезКонтекста().

Пример оптимизированного запроса для заполнения выпадающего списка:

Процедура СписокКонтрагентовПриОткрытии(Элемент)
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ ПЕРВЫЕ 100
|   Контрагенты.Ссылка КАК Ссылка,
|   Контрагенты.Наименование КАК Наименование
|ИЗ
|   Справочник.Контрагенты КАК Контрагенты
|ГДЕ
|   Контрагенты.ПометкаУдаления = ЛОЖЬ
|УПОРЯДОЧИТЬ ПО
|   Наименование";

Результат = Запрос.Выполнить();
Элемент.СписокВыбора.Очистить();
Пока Результат.Следующий() Цикл
Элемент.СписокВыбора.Добавить(Результат.Ссылка, Результат.Наименование);
КонецЦикла;
КонецПроцедуры

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

⚠️ Внимание: При использовании Объект.Записать() в цикле (например, для пакетного изменения данных) всегда оборачивайте операцию в транзакцию:

НачатьТранзакцию();
Попытка
Для Каждого Строка Из СписокИзменений Цикл
Строка.Объект.Записать();
КонецЦикла;
ЗафиксироватьТранзакцию();
Исключение
ОтменитьТранзакцию();
Сообщить("Ошибка при записи: " + ОписаниеОшибки());
КонецПопытки;

Это предотвратит потерю данных при сбоях.

FAQ: Ответы на частые вопросы

ПараметрыФормы = Новый Структура("Ключ, Значение");
Форма = ПолучитьФорму("Справочник.Контрагенты.ФормаОбъекта", ПараметрыФормы);
Результат = Форма.ОткрытьМодально();

Параметры = Новый Структура;
Параметры.Вставить("Контрагент", СсылкаНаКонтрагента);
Параметры.Вставить("Режим", "Просмотр");

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

Если МобильноеПриложениеКлиент Тогда
ЭлементыФормы.ТаблицаДокументов.Видимость = Ложь;
КонецЕсли;