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