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

Другое · 8 мин

Как обратиться к справочнику в 1С

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

Обращение к справочнику в 1С означает получение доступа к элементу справочника и его реквизитам из кода встроенного языка. Справочник хранит классификационную информацию: контрагенты, номенклатуру, склады, пользователей и другие справочные данные. Чтобы работать с такими данными, нужно чётко различать ссылку на элемент и сам объект, так как они ведут себя по-разному при чтении и записи.

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

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

Ссылка и объект справочника: в чем разница

Ссылка на элемент справочника не содержит значений реквизитов, она только указывает на запись в базе. Через ссылку можно проверить существование элемента, сравнить два элемента или передать элемент в качестве параметра процедуры. Прямое изменение реквизита через ссылку невозможно, попытка записи через ссылку не приведёт к сохранению данных.

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

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

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

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

Элемент справочника найден
Норма

Возвращена непустая ссылка

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

Ссылка равна неопределённому значению

Изменения сохранены
Норма

Данные отображаются в форме справочника после записи

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

Значения вернулись к исходным после переоткрытия

Как получить ссылку на элемент справочника

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

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

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

Порядок работы со справочником
  1. 1
    Определить имя справочника и нужный элемент
  2. 2
    Получить ссылку через поиск по коду или наименованию
  3. 3
    Получить объект из ссылки для изменения
  4. 4
    Записать объект и проверить результат в базе

Чтение и изменение реквизитов через объект

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

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

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

Поиск элементов по коду и наименованию

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

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

Сравнение вариантов

Поиск по коду

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

Поиск по наименованию

Удобен для пользователя, но может вернуть несколько элементов из-за неуникальности названия

Форма выбора

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

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

Обращение из отчётов и обработок

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

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

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

Элемент не найденСсылка равна неопределённому значению

Убедитесь в правильности кода и наименования

Изменения внесены в объектРеквизиты объекта изменены в памяти

Запись ещё не выполнена, данные не сохранены

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

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

Ограничения, риски и типичные ошибки

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

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

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

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

Сравнение способов доступа

Итог

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

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

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

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

Что делать, если поиск по коду не находит элемент?

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

Можно ли редактировать справочник из отчёта без формы?

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

Безопасно ли массовое изменение справочника через обработку?

Только после проверки условия отбора на копии базы или небольшом наборе элементов. Ошибка в отборе может затрануть лишние записи и нарушить связи с документами. Для критичных справочников лучше ограничить круг изменяемых элементов и создать резервную копию.