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

Другое · 7 мин

Перебор реквизитов документа в 1С: практическая инструкция

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

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

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

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

Когда нужно перебирать реквизиты документа

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

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

Режим документаЧерновик или проведен

Уточните, доступна ли запись и есть ли ограничения при проведении

Место кодаМодуль объекта или формы

Выбирайте серверный контекст для доступа к данным базы

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

Определите, какие данные нужно менять: поля документа или строки таблицы

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

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

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

Порядок действий
  1. 1
    Откройте модуль объекта документа
  2. 2
    Получите коллекцию атрибутов через синтакс-помощник
  3. 3
    Обойдите коллекцию циклом и проверьте тип значения
  4. 4
    Запишите документ только после валидации

Пример обхода реквизитов и проверки типов

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

Для Каждого Реквизит Из ДокументОбъект.Атрибуты() Цикл
Имя = Реквизит.Имя;
Значение = Реквизит.Значение;
// здесь проверка типа и нужная логика
КонецЦикла;

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

Отличия клиентского и серверного выполнения

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

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

Типичные ошибки
01
Путаница между элементами формы и атрибутами объекта: форма показывает данные, а не хранит их
02
Попытка сохранить изменения в проведенном документе без анализа ограничений
03
Изменение коллекции во время её обхода

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

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

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

Безопасность и сохранение изменений

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

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

Итог

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

Обходите атрибуты объекта документа, проверяйте типы и права, не правьте коллекцию в цикле и сохраняйте только после валидации.

Чем отличается перебор реквизитов от работы с табличной частью?

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

Можно ли менять значения реквизитов прямо во время обхода коллекции?

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

Где лучше размещать код перебора: на клиенте или на сервере?

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

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

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