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