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

Другое · 6 мин

Обход реквизитов документа 1С: способы и ограничения

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

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

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

Что понимать под реквизитами документа

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

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

Где искать реквизиты и как их различать

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

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

Как пройти реквизиты документа в коде

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

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

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

Табличные части и вложенные объекты

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

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

Проверка прав, режима и безопасные изменения

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

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

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

Частые ошибки и ограничения

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

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

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

Список реквизитов после обхода
Норма

Соответствует метаданным документа

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

Отсутствуют поля или попали элементы формы

Результат записи
Норма

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

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

Изменения исчезли или появилась ошибка записи

Права и режим
Норма

Документ доступен для редактирования

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

Документ проведён, заблокирован или недоступен для записи

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

Итог и дальнейшие действия

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

Итог

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

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

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

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

Нужно ли отдельно обходить табличные части?

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

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

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

Безопасно ли вносить массовые изменения в действующую базу?

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

Зависит ли порядок обхода от версии платформы?

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