Как устроена передача Excel-файла в серверную обработку 1С: разбор клиентского моста
На Хабре опубликовано практическое продолжение разбора внешних обработок 1С. Автор показывает, как связать кнопку управляемой формы с серверным кодом, передать выбранный пользователем файл и избежать ошибочного обращения сервера к локальному диску.
Главное
Сценарий начинается в управляемой форме внешней обработки: пользователь уже выбрал документ на компьютере, а разработчику нужно выполнить действие по нажатию кнопки. Для этого создают команду формы и связывают её с процедурой. Важна не столько сама кнопка, сколько правильное разделение работы между интерфейсом и серверным модулем.
Автор предлагает создать клиентский обработчик и связанную с ним серверную процедуру без контекста. В таком варианте сервер получает явно переданные параметры, а не состояние всей формы. Это позволяет не пересылать ненужные реквизиты и делает границу между интерфейсом и обработкой данных заметнее для разработчика.
Подробности
Самая распространённая ошибка в этом примере — попытка передать на сервер строку с путём к локальному файлу. Серверная часть программы работает на другой машине или в другом окружении и не обязана видеть пользовательский диск. Следовательно, одного текстового адреса файла недостаточно: сначала нужно передать его содержимое.
Для передачи автор использует штатный механизм временного хранилища платформы. Клиент инициирует загрузку, после завершения получает адрес размещённых данных и передаёт его серверной процедуре. Этот адрес служит идентификатором уже загруженного содержимого, а не ссылкой на исходную папку пользователя.
Что это меняет
На сервере пример получает двоичные данные по адресу временного хранилища, создаёт временный файл и читает таблицу средствами платформы. Для работы с ячейками показан объект «ТабличныйДокумент». Такая последовательность отделяет сетевую передачу файла от его разбора и дальнейших операций с информационной базой.
Готовый фрагмент демонстрирует инфраструктуру загрузки, но ещё не реализует полноценный импорт строк в документы базы. Для реального сценария понадобятся проверки содержимого, обработка ошибок, очистка временных файлов и отдельная бизнес-логика сохранения. Материал полезен именно как объяснение границы между клиентом, временным хранилищем и сервером, а не как готовый универсальный загрузчик.
Первоисточник
Материал подготовлен STRUCTURE по открытой публикации Habr. Текст и иллюстрации первоисточника не воспроизводятся целиком.