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

Другое · 8 мин

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

Как правильно задать ссылку на элемент справочника в 1С: программно, через форму и в отчётах, с проверкой типа и примерами безопасной работы.

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

Важно различать саму ссылку и объект справочника. Ссылка — это только указатель на запись, с помощью которого можно прочитать реквизиты, но не изменить их напрямую. Для редактирования нужно получить объект через ссылку, изменить его и записать. Попытка изменить данные «через ссылку» обычно приводит к ошибке или к записи в неправильное место.

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

Что представляет собой ссылка на элемент справочника

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

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

Как указать ссылку программно

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

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

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

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

Пустая ссылка и её обработка

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

Порядок действий
  1. 1
    Найти элемент справочника по коду, наименованию или существующей ссылке
  2. 2
    Проверить, что ссылка не пустая
  3. 3
    При необходимости получить объект через ссылку
  4. 4
    Изменить реквизиты объекта и записать его
  5. 5
    Использовать ссылку для отбора, реквизита или отчёта

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

Ссылка в форме и интерфейсе пользователя

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

Ссылка получена из спискаЭлемент выбран пользователем

Убедитесь, что выбор зафиксирован и ссылка не пустая

Ссылка передана в процедуруПараметр типа СправочникСсылка

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

Нужно изменить реквизитТребуется объект справочника

Получите объект через ссылку, измените и запишите

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

Ссылка в запросе и отчёте

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

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

Проверка и сравнение ссылок

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

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

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

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

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

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

Безопасная самостоятельная работа

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

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

Итог

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

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

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

Можно ли использовать название элемента вместо ссылки?

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

Что делать, если ссылка ведёт на удалённый элемент?

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

Нужно ли записывать объект после получения по ссылке?

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

Можно ли сравнивать ссылки из разных справочников?

Сравнение имеет смысл только для ссылок на элементы одного и того же справочника. Ссылки из разных справочников даже при одинаковом коде или названии относятся к разным объектам и не считаются равными.

Как проверить, что ссылка не пустая?

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