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

Другое · 7 мин

Обращение к справочнику 1С с клиента: порядок и ограничения

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

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

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

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

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

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

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

Способы получения данных справочника

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

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

Пошаговый порядок действий

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

Создайте серверную процедуру, например &НаСервере, в модуле менеджера справочника или общем модуле. Внутри процедуры выполните поиск по справочнику и верните ссылку или заполненный объект клиенту.

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

Типичные ошибки
01
Обращение к Справочники.Имя как к объекту на клиенте без серверного вызова
02
Использование ссылки после закрытия сессии или без проверки на неопределенное значение
03
Чтение большого справочника в цикле на клиенте без выгрузки на сервер

Права, ограничения и риски

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

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

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

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

Результат серверного вызова
Норма

Возвращена ссылка или заполненный объект

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

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

Изменение реквизита
Норма

Данные сохраняются и видны после переоткрытия

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

Изменения исчезают или возникает блокировка

Типичные ошибки и проверка результата

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

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

Маршрут решения

Как выбрать действие

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

Альтернативы и когда обращаться к разработчику

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

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

Итог

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

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

Часто задаваемые вопросы

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

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

Что делать, если серверная процедура возвращает пустую ссылку?

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

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

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

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

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

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

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