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