Как скопировать файл в папку в 1С: рабочие способы и примеры

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

Основной инструмент — функция КопироватьФайл(), которая создаёт копию файла по указанному пути. Альтернативы — ПереместитьФайл(), когда исходник больше не нужен, и чтение-запись через ДвоичныеДанные или ТекстовыйДокумент, когда требуется контроль над содержимым. Ниже разобраны все варианты с примерами, проверкой результата и типичными ошибками.

Функция КопироватьФайл — основной способ

Встроенная функция КопироватьФайл(<ИмяИсточника>, <ИмяПриемника>) создаёт копию файла с полным сохранением содержимого. Оба параметра — строки с полными путями, включая имя и расширение файла. Если файл-приёмник уже существует, он будет перезаписан без предупреждения.

Процедура СкопироватьФайлВПапку(ПутьИсточника, ПапкаНазначения)

ФайлИсточник = Новый Файл(ПутьИсточника);
Если Не ФайлИсточник.Существует() Тогда
Сообщить("Исходный файл не найден: " + ПутьИсточника);
Возврат;
КонецЕсли;

ПутьПриемника = ПапкаНазначения + "\" + ФайлИсточник.Имя;

Попытка
КопироватьФайл(ПутьИсточника, ПутьПриемника);
Сообщить("Файл скопирован: " + ПутьПриемника);
Исключение
Сообщить("Ошибка копирования: " + ОписаниеОшибки());
КонецПопытки;

КонецПроцедуры

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

КопироватьФайл("C:\Выгрузки\отчет.xlsx", "D:\Архив\отчет.xlsx");

Подготовка: проверка файла и создание папки назначения

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

// Проверка и создание каталога назначения
Каталог = Новый Файл(ПапкаНазначения);
Если Не Каталог.Существует() Тогда
СоздатьКаталог(ПапкаНазначения);
КонецЕсли;

Функция СоздатьКаталог() создаёт всю цепочку вложенных папок, поэтому можно указывать путь вида D:\Архив\2026\Январь, даже если промежуточных каталогов ещё нет.

1. 1
   Проверьте существование исходного файла через Новый Файл() и метод Существует()
2. 2
   Проверьте или создайте папку назначения функцией СоздатьКаталог()
3. 3
   Сформируйте полный путь приёмника с именем файла
4. 4
   Вызовите КопироватьФайл() внутри блока Попытка...Исключение
5. 5
   Проверьте результат: файл появился в папке назначения и открывается

Копирование на сервере и на клиенте: в чём разница

Ключевой нюанс в клиент-серверном режиме: код, выполняемый на сервере, работает с файловой системой сервера, а не компьютера пользователя. Если вы вызываете КопироватьФайл() в серверной процедуре с путём C:\Документы\..., 1С будет искать этот файл на диске C сервера приложений.

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

// Клиентская часть: помещаем файл во временное хранилище
НачатьПомещениеФайла(
Новый ОписаниеОповещения("ПослеПомещенияФайла", ЭтотОбъект),
,
ПутьКФайлу,
Ложь,
УникальныйИдентификатор);

// Серверная часть: сохраняем из хранилища в папку
ДвоичныеДанные = ПолучитьИзВременногоХранилища(АдресХранилища);
ДвоичныеДанные.Записать(ПутьНазначения);

Альтернативные способы копирования

Функция КопироватьФайл() подходит не всегда. В зависимости от задачи удобнее другие механизмы.

ПереместитьФайл — когда исходник не нужен

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

Копирование содержимого целой папки

Для копирования всех файлов каталога применяется обход через НайтиФайлы() с последующим копированием каждого файла по отдельности:

МассивФайлов = НайтиФайлы(ПапкаИсточник, ".", Ложь);
Для Каждого Файл Из МассивФайлов Цикл
Если Файл.ЭтоФайл() Тогда
КопироватьФайл(Файл.ПолноеИмя,
ПапкаНазначения + "\" + Файл.Имя);
КонецЕсли;
КонецЦикла;

Чтение и запись содержимого

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

Проверка результата копирования

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

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

ФайлПриемник = Новый Файл(ПутьПриемника);
Если ФайлПриемник.Существует()
И ФайлПриемник.Размер() = ФайлИсточник.Размер() Тогда
// Копирование выполнено успешно
КонецЕсли;

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

Типичные ошибки и ограничения

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

Вторая группа ошибок связана с правами доступа: учётная запись, под которой работает сервер 1С (обычно USR1CV8 или аналог), должна иметь права на чтение источника и запись в папку назначения. При копировании на сетевые ресурсы используйте UNC-пути вида \\Сервер\ОбщаяПапка\ вместо подключённых сетевых дисков — буквы дисков часто недоступны серверному процессу.

Третья типичная ситуация — файл занят другим процессом (открыт в Excel, заблокирован антивирусом или другим сеансом 1С). В этом случае копирование завершится ошибкой доступа. Решение — повторная попытка с задержкой или копирование в момент, когда файл гарантированно свободен.

FAQ