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

Другое · 8 мин

1C: доступ к дополнительному реквизиту документа

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

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

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

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

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

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

Где хранятся значения дополнительных реквизитов документов

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

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

Как получить значение в форме документа

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

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

Отличие управляемого и обычного приложения

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

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

Как получить значение в коде без формы

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

Порядок действий
  1. 1
    Убедитесь, что дополнительный реквизит создан и подключен к виду документа
  2. 2
    Получите ссылку на документ и укажите точное имя реквизита
  3. 3
    Вызовите функцию получения значения или выполните запрос к регистру сведений
  4. 4
    Проверьте результат на неопределенное значение перед использованием

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

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

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

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

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

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

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

Значение дополнительного реквизита после чтения
Норма

Есть ожидаемое значение нужного типа

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

Неопределенное значение, пустота или ошибка доступа

Документ после записи
Норма

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

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

Значение не изменилось или документ не сохраняется из-за прав

Проверка результата и ограничения прав

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

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

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

Частые ошибки и безопасность

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

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

Итог

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

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

Часто задаваемые вопросы

Можно ли изменить дополнительный реквизит в уже проведенном документе?

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

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

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

Нужно ли использовать серверный вызов для чтения дополнительного реквизита?

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

Как отличить дополнительный реквизит от обычного реквизита документа?

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