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

Другое · 5 мин

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

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

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

Самый прямой путь — обращение к атрибуту объекта документа, например Документ.Сумма или Документ.Контрагент. Это работает, когда объект уже получен в памяти и реквизит доступен для чтения.

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

Для массового чтения или работы вне формы удобнее использовать запрос или метод Выбрать(), но тогда нужно учитывать записи, проведенность и права доступа.

Когда объект документа уже доступен

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

Внешняя обработка сначала получает ссылку на документ, а затем обращается к его реквизитам. Если ссылка пустая или документ не найден, попытка чтения завершится ошибкой, поэтому проверку ссылки делают перед доступом к данным.

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

Объект документа в памятиРеквизит доступен как свойство

Проверьте, что ссылка получена и объект не пустой

Документ открыт в формеЗначение часто в элементе формы

Сравните значение формы и базового объекта при расхождениях

Чтение через запросДанные берутся из базы

Учитывайте проведенность, отметку удаления и права доступа

Чтение из формы документа

В форме документа значение реквизита обычно связано с элементом управления. Можно обратиться к значению элемента формы, если форма открыта и элемент доступен. Это подходит для проверки вводимых пользователем данных перед сохранением.

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

Порядок действий
  1. 1
    Получить ссылку на документ
  2. 2
    Убедиться, что документ не пустой и доступен
  3. 3
    Обратиться к реквизиту объекта или элементу формы
  4. 4
    Проверить полученное значение перед использованием

Получение значения через запрос

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

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

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

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

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

Проверка результата и частые ошибки

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

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

Сравнение вариантов

Через объект документа

Подходит, когда объект уже получен; требует осторожности с несохраненными изменениями

Через форму

Удобно для текущего ввода; не всегда отражает записанные в базе данные

Через запрос

Подходит для отбора и массового чтения; не видит несохраненные изменения формы

Когда стоит ограничиться стандартными средствами

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

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

Итог

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

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

Можно ли читать реквизит незаписанного документа?

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

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

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

Отличается ли значение в форме от значения в базе?

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

Безопасно ли программно менять реквизиты документа?

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