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