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