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

Другое · 10 мин

Структура данных формы в 1С 8.3: разбор и применение

Разбор структуры данных формы в 1С 8.3: из чего состоит, как обращаться к реквизитам и табличным частям, в чём отличие от типа Структура и на что обратить внимание при программировании.

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

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

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

Что входит в состав данных формы

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

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

Где посмотреть составРедактор формы в конфигураторе, вкладка «Реквизиты» и «Табличные части»

Сравните список в конфигураторе с тем, что вы обращаетесь в коде.

Тип доступаОбъект.Реквизит или ДанныеФормы.Реквизит

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

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

Где и как используется в конфигурации

Данные формы используются в модулях форм при обработке событий: при открытии, при изменении реквизита, перед записью, при Actions и командах. Например, в обработчике «ПриИзменении» разработчик может прочитать значение одного реквизита и на его основе заполнить другой или скрыть лишнюю табличную часть.

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

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

Работа с реквизитами и табличными частями

Чтение простого реквизита формы выполняется обращением по имени: Значение = Объект.Реквизит. Запись аналогично: Объект.Реквизит = НовоеЗначение. Перед записью рекомендуется проверять тип значения, чтобы не присвоить данные несовместимого типа, что может привести к отказу платформы.

Табличные части обходятся циклом по строкам: Для Каждого Строка Из Объект.ТабличнаяЧасть Цикл. Внутри цикла доступны реквизиты текущей строки. Добавление строки выполняется методом Добавить(), удаление — Удалить(Индекс) или удалением текущей строки в цикле с осторожностью, так как индексы смещаются после удаления.

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

Порядок действий
  1. 1
    Откройте форму в конфигураторе и посмотрите список реквизитов и табличных частей
  2. 2
    В модуле формы обратитесь к нужному реквизиту через Объект или ДанныеФормы
  3. 3
    Проверьте тип и заполненность значения перед использованием
  4. 4
    При работе с табличной частью обходите строки циклом и учитывайте смещение индексов при удалении
  5. 5
    Проверьте результат в режиме предприятия на тестовых данных

Отличие от языкового типа Структура

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

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

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

Проверка и обработка значений

Перед использованием значения реквизита формы полезно проверить, не равно ли оно Неопределено, и соответствует ли ожидаемому типу. Функция ТипЗначения() позволяет узнать тип значения в процессе выполнения. Это особенно важно для ссылочных типов, где пустая ссылка и неопределённое значение ведут к разным последствиям.

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

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

Типичные ошибки
01
Обращение к реквизиту по имени, которого нет в конфигурации формы, вызывает ошибку выполнения.
02
Изменение табличной части во время обхода циклом без учёта смещения индексов приводит к пропуску строк или выходу за границы коллекции.
03
Убеждение, что изменения во временной структуре автоматически попадают в форму без обратной записи значений.

Ограничения и границы безопасной работы

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

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

Сравнение вариантов

Объект данных формы

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

Языковой тип Структура

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

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

Практические рекомендации

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

Контрольные точки

Как проверить результат

Открытие формы в режиме предприятия
Норма

Все поля заполняются и сохраняются без сообщений об ошибках

Тревожный признак

Платформа выдаёт ошибку при обращении к реквизиту или при записи

Изменение реквизита в обработчике события
Норма

Значение обновляется и отражается в связанных полях

Тревожный признак

Значение не меняется или форма закрывается с ошибкой

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

Если форма связана с документом или справочником, помните, что запись данных формы не всегда означает запись базового объекта. Уточните, требуется ли отдельный вызов метода Запись() объекта, и при каких условиях изменения становятся доступны другим пользователям.

Итог

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

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

Чем данные формы отличаются от типа Структура?

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

Как обратиться к реквизиту формы в коде?

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

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

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

Можно ли изменить табличную часть формы во время обхода её циклом?

Можно, но осторожно: удаление строк смещает индексы, поэтому безопаснее собирать индексы для удаления в отдельный список и удалять их в обратном порядке, либо использовать подходящие методы коллекции с учётом особенностей платформы.

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

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