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

Другое · 5 мин

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

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

В документе 1С реквизит справочника обычно хранится как ссылка на элемент справочника, например Контрагент, Организация, Склад или Номенклатура. Сама по себе ссылка не является текстом, поэтому для чтения названия, артикула, ИНН или другого реквизита нужно обратиться к элементу справочника через ссылку, объект или запрос.

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

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

Откуда берётся ссылка на справочник в документе

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

Перед чтением реквизита уточните, где именно хранится нужное значение: в реквизите документа, в строке табличной части или в регистре сведений. Это определяет, какой объект использовать в коде: Объект.Контрагент, СтрокаТабличнойЧасти.Номенклатура или результат запроса.

Чтение реквизита через ссылку и объект справочника

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

1c
Контрагент = Объект.Контрагент; Если Контрагент <> Неопределено Тогда Наименование = Контрагент.Наименование; КонецЕсли;

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

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

Получение значения через запрос

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

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

Проверка пустой ссылки и прав доступа

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

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

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

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

Реквизит документа заполнен
Норма

Ссылка не пустая и свойство справочника читается

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

Ссылка пустая или свойство возвращает неопределено

Права пользователя
Норма

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

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

Доступ к справочнику ограничен ролью

Различия управляемой и обычной формы, сервер и клиент

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

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

Типичные ошибки
01
Чтение свойства у пустой ссылки без проверки на Неопределено
02
Использование строки с кодом вместо ссылки на элемент справочника
03
Изменение справочника из модуля документа без резервной копии

Типичные ошибки и безопасные границы

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

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

Итог

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

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

Частые вопросы

Можно ли читать реквизит справочника напрямую из ссылки документа?

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

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

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

Что делать, если реквизит документа содержит только код справочника?

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

Безопасно ли править типовой конфигурации 1С самостоятельно?

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