К статье
Практический материал

Разработка и Конфигурация · 9 мин

Как открыть форму документа в конфигураторе 1С

Как найти и открыть форму документа в конфигураторе 1С: путь через дерево объектов, виды форм, редактор форм, типичные ошибки и проверка результата.

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

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

Что понадобится перед началом работы

Для открытия формы документа потребуется запущенный конфигуратор 1С и пользователь с правами на конфигурирование. В типовых конфигурациях это обычно роль «Администратор системы» или полные права. Если база серверная, потребуется также знать параметры подключения к кластеру.

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

Открытие конфигурации в конфигураторе

Запустите ярлык 1С, выберите нужную информационную базу в списке и нажмите кнопку «Конфигуратор». После входа откройте дерево конфигурации: меню «Конфигурация» → «Открыть конфигурацию». Если конфигурация уже открыта, этот пункт будет неактивен, а дерево объектов видно слева в основном окне.

Дерево конфигурации — главный навигационный инструмент разработчика. Все объекты сгруппированы по видам: «Справочники», «Документы», «Регистры» и так далее. Найдите ветку «Документы» и разверните её щелчком по значку «+» или двойным щелчком.

Поиск нужного документа и его форм

В развёрнутой ветке «Документы» найдите нужный вид документа, например «РеализацияТоваровУслуг» или «ПриходныйОрдер». Разверните сам объект документа — внутри вы увидите подчинённые ветки: «Реквизиты», «Табличные части», «Движения», «Макеты», «Команды» и «Формы».

Если ветка «Формы» пустая, значит у документа нет явно созданных форм, и платформа генерирует их автоматически на основе структуры объекта. Это нормальная ситуация: форма существует логически, но не хранится в конфигурации как отдельный объект.

ФормаДокументаОсновная форма объекта

Открывается при создании и редактировании одного документа

ФормаСпискаСписок документов

Журнал документов с колонками, отборами и командной панелью

ФормаВыбораВыбор из списка

Открывается при подборе документа в поле ввода другого объекта

Открытие формы документа двойным щелчком

Разверните ветку «Формы» внутри нужного документа. Найдите элемент с именем «ФормаДокумента» (или другое имя, если форм несколько) и дважды щёлкните по нему левой кнопкой мыши. Откроется редактор формы — окно с визуальным представлением формы, деревом элементов и палитрой свойств.

Альтернативный способ — щёлкнуть по форме правой кнопкой мыши и выбрать «Открыть» в контекстном меню. Результат будет тем же. Если форм несколько, обратите внимание на колонку «Основная» или свойство «Форма по умолчанию»: именно основная форма открывается пользователю при работе с документом.

Определить, какая форма является основной, можно через палитру свойств документа: выделите объект документа, нажмите правую кнопку → «Свойства» и посмотрите свойства «Основная форма», «Основная форма списка» и «Основная форма для выбора». Там указаны имена форм, назначенных по умолчанию.

Порядок действий
  1. 1
    Запустите базу в режиме «Конфигуратор»
  2. 2
    Откройте конфигурацию: меню «Конфигурация» → «Открыть конфигурацию»
  3. 3
    Разверните ветку «Документы» и найдите нужный документ
  4. 4
    Разверните подчинённую ветку «Формы» внутри документа
  5. 5
    Дважды щёлкните по «ФормаДокумента» — откроется редактор формы
  6. 6
    Проверьте, что форма открылась: виден макет формы и дерево элементов

Создание формы, если её нет в конфигурации

Если ветка «Формы» пуста, а настроить форму нужно, создайте её вручную. Выделите ветку «Формы», нажмите правую кнопку мыши и выберите «Добавить» либо нажмите кнопку «Добавить» на панели инструментов окна конфигурации. Запустится конструктор формы.

В конструкторе выберите тип формы — для документа это «Форма документа», задайте имя (по умолчанию «ФормаДокумента») и при необходимости отметьте флажок «Назначить форму основной». Нажмите «Готово» — платформа автоматически сгенерирует форму со всеми реквизитами и табличными частями документа, и она сразу откроется в редакторе.

Структура редактора формы

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

Вкладка «Модуль» открывает программный модуль формы — код на встроенном языке с обработчиками событий: «ПриОткрытии», «ПриСозданииНаСервере», «ПередЗаписью» и другими. Переключаться между визуальной частью и кодом можно вкладками внизу окна редактора.

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

Способы доработки формы

Изменение формы в основной конфигурации

Подходит для собственных разработок. В типовых конфигурациях усложняет обновление и требует снятия с поддержки.

Расширение конфигурации

Рекомендуемый способ для типовых решений: форма дорабатывается в расширении, основная конфигурация не меняется, обновления проходят штатно.

Программное изменение в модуле

Добавление элементов кодом в обработчике «ПриСозданииНаСервере». Гибко, но сложнее сопровождать.

Проверка результата и типичные ошибки

После изменений сохраните конфигурацию (Ctrl+S) и обновите конфигурацию базы данных: меню «Конфигурация» → «Обновить конфигурацию базы данных» или клавиша F7. Затем запустите режим «Предприятие» через «Сервис» → «1С:Предприятие» и откройте документ, чтобы убедиться, что форма выглядит и работает как задумано.

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

Ещё одна типичная ситуация — ошибка компиляции модуля формы при открытии документа. Платформа сообщит об этом при попытке открыть документ в режиме «Предприятие». Проверить модуль заранее можно через «Конфигурация» → «Проверка конфигурации» с включённой проверкой модулей.

Типичные ошибки
01
Доработана неосновная форма — пользователи продолжают видеть старую основную форму
02
Изменения сохранены, но конфигурация базы данных не обновлена — в режиме «Предприятие» ничего не поменялось
03
Создана явная форма, после чего новые реквизиты документа перестали появляться на ней автоматически
04
Форма доработана в типовой конфигурации без расширения — при обновлении изменения затёрлись

FAQ

Как открыть форму списка документа, а не самого документа?

В ветке «Формы» нужного документа найдите элемент «ФормаСписка» и откройте его двойным щелчком. Если его нет, создайте через «Добавить», выбрав в конструкторе тип «Форма списка документов».

Почему в ветке «Формы» ничего нет?

Это нормально: платформа генерирует формы автоматически по структуре объекта. Чтобы настроить форму вручную, создайте её через правую кнопку на ветке «Формы» → «Добавить». Автоматическая генерация при этом прекратится.

Можно ли открыть форму из режима «Предприятие»?

Редактировать форму в режиме «Предприятие» нельзя — это пользовательский режим. Однако в некоторых конфигурациях доступна команда «Изменить форму», позволяющая пользователю настроить видимость и порядок элементов без конфигуратора. Эти настройки не меняют конфигурацию.

Как открыть модуль формы, если форма уже открыта?

В окне редактора формы перейдите на вкладку «Модуль» в нижней части окна. Откроется редактор кода с обработчиками событий формы. Если вкладки нет, используйте меню «Форма» → «Модуль».

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

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

Можно ли доработать форму типового документа без снятия с поддержки?

Да, через расширение конфигурации: «Конфигурация» → «Расширения конфигурации» → «Создать». В расширении добавьте заимствованную форму документа и доработайте её. Основная конфигурация останется на полной поддержке, обновления будут устанавливаться штатно.

Итог

Что важно запомнить

Форма документа открывается из дерева конфигурации: «Документы» → нужный документ → «Формы» → «ФормаДокумента». Если формы нет, её создают конструктором. После изменений обязательно обновляйте конфигурацию базы данных и проверяйте результат в режиме «Предприятие», а типовые объекты дорабатывайте через расширения.