Копирование файлов в 1С: 5 проверенных способов с примерами кода

Работа с файлами в 1С:Предприятие — одна из самых востребованных задач при автоматизации бизнес-процессов.hether вы разрабатываете отчеты, интегрируете систему с внешними сервисами или просто архивируете документы, умение программно копировать файлы в нужные папки сэкономит часы рутинной работы. Но как это сделать правильно, чтобы избежать ошибок доступа, потери данных или конфликтов с антивирусами?

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

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

1. Базовый метод: Копирование через встроенную функцию КопироватьФайл()

Самый простой и универсальный способ — использование стандартной функции КопироватьФайл(). Она доступна во всех конфигурациях 1С и работает как в толстом, так и в тонком клиенте (с некоторыми ограничениями). Функция принимает два обязательных параметра: источник (путь к исходному файлу) и приемник (путь к целевой папке с именем файла).

Пример минимального кода для копирования файла из папки C:\Temp\ в C:\Backup\:

КопироватьФайл("C:\Temp\document.pdf", "C:\Backup\document_copy.pdf");

Важные нюансы этого метода:

• 📁 Функция автоматически создает целевой файл, если его не существует, но не создает папки — их нужно проверять заранее.
• 🔄 При копировании в ту же папку с другим именем оригинал не удаляется (в отличие от функции ПереместитьФайл()).
• ⚡ В тонком клиенте работа с локальными дисками ограничена — требуются права доступа, настроенные в политиках безопасности.

Проверьте существование исходного файла|Убедитесь в наличии прав на запись в целевую папку|Создайте целевую папку заранее (если её нет)|Обработайте исключение "Файл не найден"-->

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

Если НЕ ЗначениеЗаполнено(НайтиФайлы("C:\Temp\document.pdf")) Тогда
Сообщить("Файл не найден!", СтатусСообщения.Важное);
Иначе
КопироватьФайл("C:\Temp\document.pdf", "C:\Backup\document_copy.pdf");
КонецЕсли;

2. Работа с каталогами: Копирование группы файлов

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

Пример копирования всех .xlsx-файлов из одной папки в другую:

МаскаФайлов = "C:\Incoming\*.xlsx";
НайденныеФайлы = НайтиФайлы(МаскаФайлов);

Для Каждого Файл Из НайденныеФайлы Цикл
ИмяФайла = Сред(Файл.ПолноеИмя, СтрДлина(МаскаФайлов) - 5);
КопироватьФайл(Файл.ПолноеИмя, "C:\Processed\" + ИмяФайла);
КонецЦикла;

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

ФС = Новый ФайловаяСистема;
ФС.Копировать("C:\SourceFolder\", "C:\DestFolder\", Истина); // Истина = копировать вложенные папки

Сравнение методов копирования групп файлов:

Встроенную функцию КопироватьФайл()|Объект ФайловаяСистема|COM-объекты (FSO)|Внешние компоненты|Собственные обработки-->

3. Продвинутые техники: COM-объекты и внешние компоненты

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

1. COM-объект Scripting.FileSystemObject — позволяет управлять файлами и папками на уровне Windows. Пример:

   FSO = Новый COMОбъект("Scripting.FileSystemObject");
   FSO.CopyFile("C:\Temp\file.txt", "C:\Backup\file.txt", Ложь); // Ложь = не перезаписывать существующие

   ⚠️ Внимание: В тонком клиенте и веб-клиенте COM-объекты недоступны по умолчанию. Для их использования требуется настройка сервера 1С.

2. Внешние компоненты (например, AddIn или Native API) — дают максимальную гибкость, но требуют установки на клиентские машины. Популярные решения:
   • 🛠️ 1C:Enterprise Development Tools (официальный SDK от 1С)
   • 📦 AdvanceFile (коммерческая компонента для работы с файлами)
   • 🔧 OneScript.FileSystem (бесплатная библиотека для скриптов)

Пример использования внешней компоненты AdvanceFile для копирования с прогрессом:

AF = Новый AddIn.AdvanceFile;
AF.CopyFileEx("C:\LargeFile.iso", "D:\Backup\LargeFile.iso",
Истина, // Показывать прогресс
Истина, // Перезаписывать
Ложь);  // Не останавливать при ошибке

Когда стоит использовать внешние компоненты?

Внешние компоненты оправданы в следующих случаях:

1. Нужна работа с файлами размером >2 ГБ (ограничение стандартных функций 1С).

2. Требуется интеграция с облачными хранилищами (Google Drive, Yandex Disk) напрямую из 1С.

3. Необходим контроль целостности данных (CRC, MD5-хеши).

4. Нужна асинхронная обработка файлов (чтобы не блокировать интерфейс 1С).

5. Работа с специализированными форматами (например, прямой доступ к ZIP-архивам без распаковки).

4. Копирование в сетевые папки и облачные хранилища

При работе с сетевыми ресурсами (\\server\share\) или облачными сервисами (Yandex.Disk, Google Drive) возникают дополнительные сложности: аутентификация, таймауты и ограничения скорости. Вот ключевые рекомендации:

Для сетевых папок:

• 🔐 Используйте UNC-пути в формате \\server\share\folder\file.txt.
• 👤 Убедитесь, что учетная запись, под которой работает 1С, имеет права на запись в сетевую папку.
• 🕒 Увеличьте таймаут операции (по умолчанию 30 секунд) через параметр УстановитьТаймаутФайловыхОпераций().

Для облачных хранилищ:

• 🌐 Используйте REST API провайдера (например, Yandex.Disk API или Google Drive API).
• 🔑 Храните токены доступа в ХранилищеЗначений с шифрованием.
• 📡 Для больших файлов реализуйте копирование частями (chunked upload).

Пример загрузки файла в Yandex.Disk через API:

HTTPСоединение = Новый HTTPСоединение("cloud-api.yandex.net", 443, Истина);
HTTPЗапрос = Новый HTTPЗапрос("https://cloud-api.yandex.net/v1/disk/resources/upload?path=/Backup/file.txt&overwrite=true");
HTTPЗапрос.УстановитьЗаголовок("Authorization", "OAuth " + ТокенDoступа);
HTTPЗапрос.УстановитьТаймаут(60000); // 60 секунд

Ответ = HTTPСоединение.ОтправитьДляПолученияДанных(HTTPЗапрос);
Если Ответ.КодСостояния = 200 Тогда
ДанныеФайла = Новый ДвоичныеДанные("C:\Temp\file.txt");
HTTPЗапрос = Новый HTTPЗапрос(Ответ.ПолучитьТекст().href, ДанныеФайла);
HTTPСоединение.ОтправитьДляПолученияДанных(HTTPЗапрос);
КонецЕсли;

💡

При работе с облачными API всегда реализуйте обработку ошибок авторизации (код 401) и повторную отправку запроса с обновлением токена.

5. Обработка ошибок и исключений

Копирование файлов — операция, чреватая сбоями: от отсутствия прав до полного диска. Чтобы ваш код не "падал" на первой же ошибке, обязательно используйте конструкцию Попытка...Исключение. Основные типы исключений, которые нужно обрабатывать:

Тип ошибки	Причина	Как обработать
ФайлНеНайден	Исходный файл отсутствует	Проверить путь, уведомить пользователя
ОшибкаДоступа	Нет прав на запись	Попробовать сохранить в другую папку
ДискПереполнен	Не хватает места	Очистить диск или выбрать другой
СетеваяОшибка	Проблемы с подключением	Повторить операцию через 30 секунд
ФайлЗанят	Файл открыт в другой программе	Закрыть файл или дождаться освобождения

Пример кода с обработкой ошибок:

Попытка
КопироватьФайл("C:\Temp\report.xlsx", "C:\Reports\report_" + ТекущаяДата() + ".xlsx");
Исключение
Если ТипЗнч(ОписаниеОшибки()) = Тип("ОшибкаДоступа") Тогда
Сообщить("Ошибка доступа! Попробуйте сохранить файл в папку 'Документы'", СтатусСообщения.ОченьВажное);
ИначеЕсли ТипЗнч(ОписаниеОшибки()) = Тип("ФайлНеНайден") Тогда
Сообщить("Файл не найден! Проверьте путь: C:\Temp\report.xlsx", СтатусСообщения.Важное);
Иначе
ЗаписатьЖурналРегистрации("ОшибкаКопирования", УровеньЖурналаРегистрации.Ошибка,,,
"Неизвестная ошибка: " + ОписаниеОшибки());
КонецЕсли;
КонецПопытки;

⚠️ Внимание: В тонком клиенте текст исключений может быть усечен. Для детальной диагностики используйте журнал регистрации или вывод в файл через ЗаписатьТекст().

6. Оптимизация и безопасность

При интенсивной работе с файлами (например, копировании тысяч документов) важно следить за производительностью и безопасностью. Вот ключевые рекомендации:

Для ускорения операций:

• ⚡ Используйте АсинхронныеВызовСервера для копирования в фоне.
• 📊 Группируйте файлы по папкам (например, по датам) для уменьшения количества операций.
• 🔄 Для больших файлов (>100 МБ) копируйте частями по 10-50 МБ.

Для безопасности:

• 🔒 Проверяйте расширения файлов перед копированием (защита от вирусов).
• 🛡️ Используйте ХранилищеЗначений для чувствительных путей (не хардкодьте их в коде!).
• 📜 Ведите лог всех операций с файлами (кто, когда и какой файл скопировал).

РазрешенныеРасширения = Новый Массив;
РазрешенныеРасширения.Добавить(".pdf");
РазрешенныеРасширения.Добавить(".xlsx");
РазрешенныеРасширения.Добавить(".docx");

ИмяФайла = "incoming_file.exe";
Если НЕ РазрешенныеРасширения.Найти(Строка(СтрПравые(ИмяФайла, 5))) Тогда
Сообщить("Запрещенное расширение файла: " + ИмяФайла, СтатусСообщения.ОченьВажное);
Возврат;
КонецЕсли;

РазмерЧасти = 10  1024  1024; // 10 МБ
РазмерФайла = ПолучитьРазмерФайла(ИсходныйФайл);
Частей = Цел(РазмерФайла / РазмерЧасти) + 1;

Для НомЧасти = 1 По Частей Цикл
Данные = ПрочитатьЧастьФайла(ИсходныйФайл, (НомЧасти-1)*РазмерЧасти, РазмерЧасти);
ЗаписатьЧастьФайла(ЦелевойФайл, Данные);
Прогресс = (НомЧасти / Частей) * 100;
УстановитьЗначениеПрогрессБару(Прогресс);
КонецЦикла;