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