Другое · 10 мин
Структура данных формы в 1С 8.3: разбор и применение
Разбор структуры данных формы в 1С 8.3: из чего состоит, как обращаться к реквизитам и табличным частям, в чём отличие от типа Структура и на что обратить внимание при программировании.
В платформе 1С:Предприятие 8.3 под структурой данных формы понимают набор реквизитов, параметров и табличных частей, которые принадлежат конкретной форме и доступны через её объект данных. Каждый реквизит формы имеет имя, тип и значение, которое может меняться в процессе работы пользователя с интерфейсом.
Доступ к этим данным осуществляется через свойство Данные формы, чаще через контекстную переменную Объект или параметр ДанныеФормы, в зависимости от типа формы и способа вызова. Понимание этой структуры нужно при программировании обработчиков событий, заполнении значений, проверке заполненности и передаче данных между формами.
Важно не путать «структуру данных формы» с языковым типом Структура. Последняя — это общая коллекция пар «ключ — значение», а данные формы привязаны к конкретной форме и имеют строго определённый состав реквизитов, описанный в конфигурации.
Что входит в состав данных формы
Состав данных формы определяется при создании формы в конфигураторе. В него входят реквизиты формы, параметры, если они объявлены, и табличные части, основанные на табличных частях объекта или отдельных таблицах значений. Каждый элемент имеет тип, который задаётся разработчиком и не может быть изменён произвольно во время выполнения без соответствующих средств платформы.
Реквизиты формы могут быть простыми — числа, строки, даты, булевы значения — и сложными — ссылки на справочники, документы, перечисления. Табличные части представляют собой набор строк, в каждой из которых есть свой набор реквизитов. Доступ к строке табличной части осуществляется по индексу, а к реквизиту строки — по имени.
Сравните список в конфигураторе с тем, что вы обращаетесь в коде.
Убедитесь, что используете правильный контекст для данного типа формы.
При открытии формы платформа создаёт объект данных формы, который отражает текущее состояние всех реквизитов. Изменения, вносимые пользователем в поля формы, попадают в этот объект, и программа может прочитать их в обработчиках событий. При закрытии формы изменения могут быть записаны в базу данных, если форма связана с объектом информационной базы.
Где и как используется в конфигурации
Данные формы используются в модулях форм при обработке событий: при открытии, при изменении реквизита, перед записью, при Actions и командах. Например, в обработчике «ПриИзменении» разработчик может прочитать значение одного реквизита и на его основе заполнить другой или скрыть лишнюю табличную часть.
Также данные формы нужны при передаче формы в качестве параметра другому объекту или при открытии одной формы из другой. В таких случаях важно понимать, какие реквизиты доступны вызывающей стороне, а какие — только внутри самой формы. Неправильное обращение к несуществующему реквизиту приводит к ошибке выполнения.
В управляемых формах доступ к данным чаще организуется через свойство Объект, если форма связана с базовым объектом, или через явные реквизиты формы. В обычных формах структура может отличаться, поэтому код, написанный для одного типа формы, не всегда переносится на другой без доработки.
Работа с реквизитами и табличными частями
Чтение простого реквизита формы выполняется обращением по имени: Значение = Объект.Реквизит. Запись аналогично: Объект.Реквизит = НовоеЗначение. Перед записью рекомендуется проверять тип значения, чтобы не присвоить данные несовместимого типа, что может привести к отказу платформы.
Табличные части обходятся циклом по строкам: Для Каждого Строка Из Объект.ТабличнаяЧасть Цикл. Внутри цикла доступны реквизиты текущей строки. Добавление строки выполняется методом Добавить(), удаление — Удалить(Индекс) или удалением текущей строки в цикле с осторожностью, так как индексы смещаются после удаления.
При работе с табличными частями важно следить за тем, чтобы не модифицировать коллекцию во время её обхода без учёта смещения индексов. Безопаснее собирать индексы строк для удаления в отдельный список, а затем удалять их в обратном порядке.
- 1Откройте форму в конфигураторе и посмотрите список реквизитов и табличных частей
- 2В модуле формы обратитесь к нужному реквизиту через Объект или ДанныеФормы
- 3Проверьте тип и заполненность значения перед использованием
- 4При работе с табличной частью обходите строки циклом и учитывайте смещение индексов при удалении
- 5Проверьте результат в режиме предприятия на тестовых данных
Отличие от языкового типа Структура
Языковой тип Структура в 1С 8.3 — это динамическая коллекция, в которую можно добавить произвольное значение под произвольным ключом. Она не привязана к форме и не знает о реквизитах, объявленных в конфигурации. Данные формы же имеют фиксированный набор имён, и обращение по несуществующему имени не создаёт новый элемент, а вызывает ошибку.
Иногда разработчики копируют данные формы во временную структуру для удобства передачи между процедурами. Это допустимо, но нужно понимать, что изменения в такой структуре не отображаются автоматически в форме. Обратная запись требует явного присваивания значений обратно в реквизиты формы.
Если нужно передать набор произвольных данных без привязки к форме, удобнее использовать структуру или таблицу значений. Если нужно работать с интерфейсом формы, используйте именно объект данных формы.
Проверка и обработка значений
Перед использованием значения реквизита формы полезно проверить, не равно ли оно Неопределено, и соответствует ли ожидаемому типу. Функция ТипЗначения() позволяет узнать тип значения в процессе выполнения. Это особенно важно для ссылочных типов, где пустая ссылка и неопределённое значение ведут к разным последствиям.
Для обязательных реквизитов рекомендуется проведение проверки заполненности перед записью объекта. Если реквизит пуст, можно вывести пользователю понятное сообщение и отменить запись. Это снижает вероятность сохранения неполной или некорректной информации в базе.
При обработке табличных частей проверяйте не только наличие строк, но и заполненность ключевых реквизитов в каждой строке. Пустые строки или строки с недопустимыми значениями могут вызвать ошибки при проведении документах или формировании отчётов.
Ограничения и границы безопасной работы
Не все реквизиты формы доступны для записи в любом моменте времени. Некоторые поля могут быть только для чтения в зависимости от режима формы, прав пользователя или этапа обработки документа. Попытка записать в такой реквизит может быть проигнорирована платформой или вызвать исключение.
При программировании на встроенном языке не стоит полагаться на порядок реквизитов в структуре данных формы: он не гарантирован и может меняться при доработке конфигурации. Обращайтесь к реквизитам по имени, а не по позиции.
Сравнение вариантов
Подходит для работы с интерфейсом формы, реквизитами и табличными частями, описанными в конфигурации. Ограничен фиксированным составом.
Подходит для временного хранения произвольных пар ключ-значение и передачи между процедурами. Не связан с формой и не отражает её изменения автоматически.
Если форма используется в нескольких ролях или контекстах, состав доступных данных может различаться. Перед внесением изменений в общий модуль формы проверьте, не затронут ли он другие варианты использования той же формы.
Практические рекомендации
При разработке опирайтесь на актуальную конфигурацию: если реквизит добавлен или удалён в конфигураторе, обновите и код, который с ним работает. Не храните имена реквизитов в виде жёстко заданных строк без необходимости, где можно использовать символьные имена или константы.
Как проверить результат
Все поля заполняются и сохраняются без сообщений об ошибках
Платформа выдаёт ошибку при обращении к реквизиту или при записи
Значение обновляется и отражается в связанных полях
Значение не меняется или форма закрывается с ошибкой
Для сложной логики заполнения выносите проверки в отдельные функции модуля формы или общего модуля. Это упрощает тестирование и позволяет переиспользовать код в разных формах. Всегда проверяйте результат на копии рабочей базы, а не сразу в производственной среде.
Если форма связана с документом или справочником, помните, что запись данных формы не всегда означает запись базового объекта. Уточните, требуется ли отдельный вызов метода Запись() объекта, и при каких условиях изменения становятся доступны другим пользователям.
Что важно запомнить
Данные формы в 1С 8.3 — это фиксированный набор реквизитов и табличных частей конкретной формы, отличающийся от языкового типа Структура. Обращайтесь к реквизитам по имени, проверяйте типы и заполненность, осторожно меняйте табличные части в циклах и тестируйте изменения на копии базы.
Чем данные формы отличаются от типа Структура?
Данные формы привязаны к конкретной форме и содержат реквизиты, объявленные в конфигурации. Тип Структура — это общая динамическая коллекция, где можно хранить произвольные пары ключ-значение без привязки к форме.
Как обратиться к реквизиту формы в коде?
Обычно через Объект.ИмяРеквизита или ДанныеФормы.ИмяРеквизита, в зависимости от типа формы и контекста. Перед использованием проверьте, что реквизит существует и имеет ожидаемый тип.
Что делать, если платформа выдаёт ошибку при обращении к реквизиту?
Проверьте точное имя реквизита в редакторе формы и убедитесь, что вы используете правильный объект данных. Ошибка чаще всего означает обращение к несуществующему или недоступному в данном контексте реквизиту.
Можно ли изменить табличную часть формы во время обхода её циклом?
Можно, но осторожно: удаление строк смещает индексы, поэтому безопаснее собирать индексы для удаления в отдельный список и удалять их в обратном порядке, либо использовать подходящие методы коллекции с учётом особенностей платформы.
Нужно ли отдельно записывать базовый объект после изменения формы?
Зависит от типа формы и способа связи с объектом информационной базы. Иногда достаточно изменений в данных формы, а иногда требуется явный вызов записи базового объекта, чтобы изменения стали доступны другим пользователям.