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