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

Другое · 7 мин

Как обратиться к дополнительным свойствам в 1С

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

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

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

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

Где хранятся дополнительные свойства в 1С

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

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

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

Как определить, что свойство доступно для чтения и записи

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

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

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

Обращение к дополнительным свойствам в управляемом приложении

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

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

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

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

Различия между обычным и управляемым приложением

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

Некоторые дополнительные реквизиты доступны только в клиентском контексте, другие требуют серверного вызова. Неправильный выбор контекста может привести к ошибке «Метод не найден» или к доступу к устаревшим данным.

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

Проверка заполнения и обработка пустых значений

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

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

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

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

Значение дополнительного свойства в карточке объекта
Норма

Отображается введенное значение и сохраняется после переоткрытия

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

Поле пустое, отображается неверное значение или появляется ошибка при сохранении

Работа отчета или печатной формы после изменения
Норма

Используется актуальное значение свойства

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

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

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

Ограничения и риски при изменении

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

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

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

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

Итог

Итог

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

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

Нужно ли программировать, чтобы прочитать дополнительное свойство?

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

Что делать, если дополнительное свойство не отображается в форме?

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

Можно ли записать значение в любое дополнительное свойство?

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

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

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