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