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

Другое · 8 мин

Как получить объект из формы в 1С

Практически объясняем, как из формы 1С получить объект, ссылку или реквизит в управляемой и обычной форме, с проверкой результата и предостережениями.

Что понимают под объектом в форме 1С

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

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

Получить объект можно не только для редактирования, но и для чтения, копирования или создания нового экземпляра на основе существующего. При этом объект в памяти может быть не сохранён в базе, особенно для только что созданного документа или справочника. Это важно учитывать перед сохранением или проведением.

Где взять объект в управляемой форме

В модуле управляемой формы свойство ЭтаФорма.Объект возвращает объект, с которым связана форма, если форма открыта для редактирования существующей записи. Достаточно написать в коде модуля формы:

Объект = ЭтаФорма.Объект;

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

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

Получение объекта по ссылке

Иногда в форме доступна только ссылка на объект, например через реквизит формы или параметр открытия. В этом случае объект получают отдельно. Типичная конструкция выглядит так:

Объект = СсылкаНаОбъект.ПолучитьОбъект();

Метод ПолучитьОбъект() возвращает рабочий объект, с которым можно читать и менять реквизиты. Если ссылка пустая или некорректная, результат может быть неопределённым. Поэтому после вызова метода обязательно проверяйте, получен ли объект, прежде чем обращаться к его свойствам.

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

Порядок действий
  1. 1
    Определите тип формы: управляемая или обычная
  2. 2
    Попробуйте получить объект через ЭтаФорма.Объект
  3. 3
    Если есть только ссылка, используйте ПолучитьОбъект()
  4. 4
    Проверьте результат на пустоту и режим редактирования
  5. 5
    Выполняйте запись только после валидации данных

Различия обычных и управляемых форм

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

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

Не смешивайте понятия «реквизит формы» и «реквизит объекта». Реквизит формы хранится в самой форме и может не совпадать с реквизитом базового объекта до записи. Чтобы изменить данные объекта, обращайтесь к объекту, а не только к реквизитам формы.

Управляемая формаПопробуйте ЭтаФорма.Объект

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

Есть только ссылкаИспользуйте ПолучитьОбъект()

Убедитесь, что ссылка не пустая перед вызовом

Форма списка или выбораОбъект может отсутствовать

Работайте с выделенной строкой или параметром отбора

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

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

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

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

Частые ошибки и безопасная работа

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

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

Типичные ошибки
01
Получение объекта из формы списка без уточнения выделенной строки
02
Изменение реквизитов формы вместо объекта базы без последующей записи
03
Использование объекта из формы в фоновом задании без проверки контекста

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

Как проверить, что объект получен верно

Проверьте, что переменная содержит объект нужного типа, например справочника или документа. Можно сравнить тип объекта с ожидаемым или проверить наличие ключевых реквизитов. Если объект получен по ссылке, убедитесь, что ссылка указывает на существующую запись, а не на удалённый элемент.

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

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

Итог

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

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

Часто задаваемые вопросы

Можно ли получить объект из формы списка?

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

Чем отличается ЭтаФорма.Объект от реквизита формы?

ЭтаФорма.Объект — это ссылка на редактируемый объект базы данных, а реквизит формы — временное хранилище в интерфейсе. Изменения в реквизите формы не попадают в базу автоматически, пока объект не будет изменён и записан.

Что делать, если объект не получен?

Проверьте тип формы, заполнено ли свойство ЭтаФорма.Объект, не пуста ли ссылка и есть ли у пользователя права на чтение. Если форма открыта для просмотра, объект может быть доступен только на чтение.

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

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

Нужно ли всегда записывать объект после изменения?

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