Как передать файл с сервера на клиент в 1С

В клиент-серверном режиме работы 1С код выполняется в двух местах: на сервере, где находятся данные, и на клиенте, где работает пользователь. Файл, сформированный серверной процедурой (отчёт, выгрузка, архив), физически лежит на серверном компьютере, и пользователь не может его открыть напрямую. Чтобы передать файл с сервера на клиент, платформа 1С предоставляет несколько штатных механизмов, и выбор между ними зависит от размера файла, вида клиента (тонкий, толстый, веб) и требований к интерфейсу.

Ключевая идея всех способов одинакова: на сервере файл помещается во временное хранилище, а на клиенте извлекается по полученному адресу и сохраняется на диск пользователя. Различия касаются синхронных и асинхронных вызовов, работы с расширением для файлов в веб-клиенте и ограничений на объём передаваемых данных.

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

Как устроена передача файла между сервером и клиентом

В файловом режиме работы 1С серверной части нет, и вопрос передачи файла «с сервера на клиент» не возникает — весь код выполняется на одном компьютере. Проблема появляется именно в клиент-серверном варианте: серверный вызов не имеет доступа к диску пользователя, а клиентский код не видит файловую систему сервера.

Платформа решает это через временное хранилище — область памяти на сервере, доступную по специальному адресу вида e1cib/tempstorage/.... Серверная процедура кладёт туда данные (двоичные данные файла, табличный документ, картинку), возвращает клиенту адрес, и клиент забирает содержимое по этому адресу.

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

Способ 1. Временное хранилище и ПолучитьИзВременногоХранилища

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

&НаСервере
Функция ПодготовитьФайлНаСервере()
    ДвоичныеДанные = Новый ДвоичныеДанные("C:\Reports\выгрузка.xml");
    Адрес = ПоместитьВоВременноеХранилище(ДвоичныеДанные, УникальныйИдентификатор);
    Возврат Адрес;
КонецФункции

&НаКлиенте
Процедура СохранитьФайл(Команда)
    Адрес = ПодготовитьФайлНаСервере();
    ДвоичныеДанные = ПолучитьИзВременногоХранилища(Адрес);
    ДвоичныеДанные.Записать("C:\Users\User\Documents\выгрузка.xml");
КонецПроцедуры

Метод ПолучитьИзВременногоХранилища — синхронный, поэтому в тонком и веб-клиенте он может быть недоступен при включённом режиме отказа от модальности и синхронных вызовов. В типовых конфигурациях, рассчитанных на тактичный режим, используют асинхронный аналог — НачатьПолучениеФайлаССервера.

После извлечения данных адрес хранилища желательно освободить вызовом УдалитьИзВременногоХранилища(Адрес), чтобы не накапливать мусор в памяти сервера при массовых операциях.

Способ 2. Асинхронная передача через НачатьПолучениеФайлаССервера

Для тонкого и веб-клиента правильный подход — асинхронные методы с описанием оповещения. Метод НачатьПолучениеФайлаССервера сам запрашивает у пользователя место сохранения (или использует указанный путь) и вызывает обработчик по завершении.

&НаКлиенте
Процедура СохранитьФайл(Команда)
    Адрес = ПодготовитьФайлНаСервере();
    Оповещение = Новый ОписаниеОповещения("ПослеПолученияФайла", ЭтотОбъект);
    НачатьПолучениеФайлаССервера(Оповещение, Адрес, "выгрузка.xml");
КонецПроцедуры

&НаКлиенте
Процедура ПослеПолученияФайла(ПолученныйФайл, ДопПараметры) Экспорт
    Если ПолученныйФайл <> Неопределено Тогда
        ПоказатьОповещениеПользователя("Файл сохранён: " + ПолученныйФайл.ПолноеИмя);
    КонецЕсли;
КонецПроцедуры

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

Способ 3. Передача табличного документа и других объектов

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

&НаСервере
Функция СформироватьПечатнуюФорму()
    ТабДок = Новый ТабличныйДокумент;
    // ... заполнение табличного документа ...
    Возврат ПоместитьВоВременноеХранилище(ТабДок, УникальныйИдентификатор);
КонецФункции

&НаКлиенте
Процедура ПоказатьПечатнуюФорму(Команда)
    Адрес = СформироватьПечатнуюФорму();
    ТабДок = ПолучитьИзВременногоХранилища(Адрес);
    ТабДок.Показать("Печатная форма");
КонецПроцедуры

Тот же приём работает для картинок, макетов, структур с данными и других сериализуемых объектов. Если итоговая цель — именно файл Excel или PDF, табличный документ на клиенте сохраняется методом Записать с указанием типа файла.

Выбор способа под вашу ситуацию

Конкретный метод определяется видом клиента, размером файла и тем, должен ли пользователь видеть диалог сохранения.

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

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

Альтернативы прямой передаче файла

Прямая передача через хранилище — не единственный и не всегда лучший путь. Если сервер и клиенты находятся в одной сети, проще записать файл в общий сетевой каталог, доступный и серверу, и пользователям: серверная процедура сохраняет файл по UNC-пути, а клиенту передаётся только строка пути.

Другой вариант — сохранить файл в самой базе (в реквизите справочника или регистре сведений типа «ХранилищеЗначения»). Тогда клиент получает данные обычным запросом, без манипуляций с адресами, а файл остаётся доступен для повторного скачивания. Минус — рост размера базы.

Для обмена между отдельными системами (а не между сервером и клиентом одной базы) применяются HTTP-сервисы, веб-сервисы и файловый обмен — это уже задача интеграции, а не передачи внутри сеанса.

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