Разработка и Конфигурация · 9 мин
Как открыть форму документа в конфигураторе 1С
Как найти и открыть форму документа в конфигураторе 1С: путь через дерево объектов, виды форм, редактор форм, типичные ошибки и проверка результата.
Форма документа в 1С — это визуальное представление объекта, с которым работает пользователь: поля ввода, табличные части, кнопки и командные панели. Чтобы изменить расположение реквизитов, добавить кнопку или написать обработчик события, форму нужно открыть в конфигураторе. Сделать это можно несколькими способами, и выбор зависит от того, какая именно форма нужна: основная форма документа, форма списка или форма выбора.
Работа ведётся в конфигураторе — отдельном режиме запуска 1С, предназначенном для разработки и изменения структуры конфигурации. Пользовательский режим «Предприятие» для этой задачи не подходит. Перед любыми изменениями формы убедитесь, что у вас есть права на конфигурирование и актуальная резервная копия информационной базы.
Что понадобится перед началом работы
Для открытия формы документа потребуется запущенный конфигуратор 1С и пользователь с правами на конфигурирование. В типовых конфигурациях это обычно роль «Администратор системы» или полные права. Если база серверная, потребуется также знать параметры подключения к кластеру.
Важно понимать, что изменение формы типового объекта может потребовать снятия объекта с полной поддержки поставщика. Это усложнит последующие обновления конфигурации, поэтому в типовых решениях предпочтительнее использовать расширения конфигурации — механизм, позволяющий дорабатывать формы без изменения основной конфигурации.
Открытие конфигурации в конфигураторе
Запустите ярлык 1С, выберите нужную информационную базу в списке и нажмите кнопку «Конфигуратор». После входа откройте дерево конфигурации: меню «Конфигурация» → «Открыть конфигурацию». Если конфигурация уже открыта, этот пункт будет неактивен, а дерево объектов видно слева в основном окне.
Дерево конфигурации — главный навигационный инструмент разработчика. Все объекты сгруппированы по видам: «Справочники», «Документы», «Регистры» и так далее. Найдите ветку «Документы» и разверните её щелчком по значку «+» или двойным щелчком.
Поиск нужного документа и его форм
В развёрнутой ветке «Документы» найдите нужный вид документа, например «РеализацияТоваровУслуг» или «ПриходныйОрдер». Разверните сам объект документа — внутри вы увидите подчинённые ветки: «Реквизиты», «Табличные части», «Движения», «Макеты», «Команды» и «Формы».
Если ветка «Формы» пустая, значит у документа нет явно созданных форм, и платформа генерирует их автоматически на основе структуры объекта. Это нормальная ситуация: форма существует логически, но не хранится в конфигурации как отдельный объект.
Открывается при создании и редактировании одного документа
Журнал документов с колонками, отборами и командной панелью
Открывается при подборе документа в поле ввода другого объекта
Открытие формы документа двойным щелчком
Разверните ветку «Формы» внутри нужного документа. Найдите элемент с именем «ФормаДокумента» (или другое имя, если форм несколько) и дважды щёлкните по нему левой кнопкой мыши. Откроется редактор формы — окно с визуальным представлением формы, деревом элементов и палитрой свойств.
Альтернативный способ — щёлкнуть по форме правой кнопкой мыши и выбрать «Открыть» в контекстном меню. Результат будет тем же. Если форм несколько, обратите внимание на колонку «Основная» или свойство «Форма по умолчанию»: именно основная форма открывается пользователю при работе с документом.
Определить, какая форма является основной, можно через палитру свойств документа: выделите объект документа, нажмите правую кнопку → «Свойства» и посмотрите свойства «Основная форма», «Основная форма списка» и «Основная форма для выбора». Там указаны имена форм, назначенных по умолчанию.
- 1Запустите базу в режиме «Конфигуратор»
- 2Откройте конфигурацию: меню «Конфигурация» → «Открыть конфигурацию»
- 3Разверните ветку «Документы» и найдите нужный документ
- 4Разверните подчинённую ветку «Формы» внутри документа
- 5Дважды щёлкните по «ФормаДокумента» — откроется редактор формы
- 6Проверьте, что форма открылась: виден макет формы и дерево элементов
Создание формы, если её нет в конфигурации
Если ветка «Формы» пуста, а настроить форму нужно, создайте её вручную. Выделите ветку «Формы», нажмите правую кнопку мыши и выберите «Добавить» либо нажмите кнопку «Добавить» на панели инструментов окна конфигурации. Запустится конструктор формы.
В конструкторе выберите тип формы — для документа это «Форма документа», задайте имя (по умолчанию «ФормаДокумента») и при необходимости отметьте флажок «Назначить форму основной». Нажмите «Готово» — платформа автоматически сгенерирует форму со всеми реквизитами и табличными частями документа, и она сразу откроется в редакторе.
Структура редактора формы
Редактор формы состоит из нескольких областей. В верхней части находится дерево элементов формы — иерархия групп, полей, таблиц и кнопок. Справа или снизу расположена палитра свойств выбранного элемента. Вкладка «Реквизиты» показывает данные формы: какие реквизиты объекта и дополнительные реквизиты формы в ней используются.
Вкладка «Модуль» открывает программный модуль формы — код на встроенном языке с обработчиками событий: «ПриОткрытии», «ПриСозданииНаСервере», «ПередЗаписью» и другими. Переключаться между визуальной частью и кодом можно вкладками внизу окна редактора.
Для управляемых форм (основной режим современных конфигураций) визуальное представление формируется платформой автоматически на основе дерева элементов — вы не рисуете форму «попиксельно», а задаёте структуру и свойства. Обычные формы встречаются в старых конфигурациях и редактируются как статический макет.
Способы доработки формы
Подходит для собственных разработок. В типовых конфигурациях усложняет обновление и требует снятия с поддержки.
Рекомендуемый способ для типовых решений: форма дорабатывается в расширении, основная конфигурация не меняется, обновления проходят штатно.
Добавление элементов кодом в обработчике «ПриСозданииНаСервере». Гибко, но сложнее сопровождать.
Проверка результата и типичные ошибки
После изменений сохраните конфигурацию (Ctrl+S) и обновите конфигурацию базы данных: меню «Конфигурация» → «Обновить конфигурацию базы данных» или клавиша F7. Затем запустите режим «Предприятие» через «Сервис» → «1С:Предприятие» и откройте документ, чтобы убедиться, что форма выглядит и работает как задумано.
Частая ошибка — изменения внесены, но пользователь видит старую форму. Причины: не обновлена конфигурация базы данных, доработана неосновная форма, а открывается основная, либо форма переопределена в расширении, которое перекрывает ваши изменения. Проверяйте свойство «Основная форма» у документа и список подключённых расширений.
Ещё одна типичная ситуация — ошибка компиляции модуля формы при открытии документа. Платформа сообщит об этом при попытке открыть документ в режиме «Предприятие». Проверить модуль заранее можно через «Конфигурация» → «Проверка конфигурации» с включённой проверкой модулей.
FAQ
Как открыть форму списка документа, а не самого документа?
В ветке «Формы» нужного документа найдите элемент «ФормаСписка» и откройте его двойным щелчком. Если его нет, создайте через «Добавить», выбрав в конструкторе тип «Форма списка документов».
Почему в ветке «Формы» ничего нет?
Это нормально: платформа генерирует формы автоматически по структуре объекта. Чтобы настроить форму вручную, создайте её через правую кнопку на ветке «Формы» → «Добавить». Автоматическая генерация при этом прекратится.
Можно ли открыть форму из режима «Предприятие»?
Редактировать форму в режиме «Предприятие» нельзя — это пользовательский режим. Однако в некоторых конфигурациях доступна команда «Изменить форму», позволяющая пользователю настроить видимость и порядок элементов без конфигуратора. Эти настройки не меняют конфигурацию.
Как открыть модуль формы, если форма уже открыта?
В окне редактора формы перейдите на вкладку «Модуль» в нижней части окна. Откроется редактор кода с обработчиками событий формы. Если вкладки нет, используйте меню «Форма» → «Модуль».
Что делать, если документ не открывается после изменения формы?
Вернитесь в конфигуратор и выполните «Конфигурация» → «Проверка конфигурации» с проверкой модулей — платформа укажет строку с ошибкой. Исправьте код, обновите конфигурацию базы данных и проверьте снова. При критической поломке восстановите объект из резервной копии.
Можно ли доработать форму типового документа без снятия с поддержки?
Да, через расширение конфигурации: «Конфигурация» → «Расширения конфигурации» → «Создать». В расширении добавьте заимствованную форму документа и доработайте её. Основная конфигурация останется на полной поддержке, обновления будут устанавливаться штатно.
Что важно запомнить
Форма документа открывается из дерева конфигурации: «Документы» → нужный документ → «Формы» → «ФормаДокумента». Если формы нет, её создают конструктором. После изменений обязательно обновляйте конфигурацию базы данных и проверяйте результат в режиме «Предприятие», а типовые объекты дорабатывайте через расширения.