Как получить все файлы из каталога в 1С

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

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

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

Функция НайтиФайлы: синтаксис и параметры

Функция НайтиФайлы() — основной способ получить содержимое каталога. Она принимает до трёх параметров:

• Путь — строка с каталогом поиска, например "C:\Обмен\" или "/mnt/exchange/";
• Маска — шаблон отбора файлов, например ".xml" или ".*" для всех файлов; параметр необязательный, по умолчанию отбирается всё;
• ИскатьВПодкаталогах — булево, определяет, нужен ли рекурсивный обход вложенных папок.

Результат — массив объектов типа Файл. Если каталог пуст или не существует, функция вернёт пустой массив, а не ошибку, поэтому проверку результата нужно делать через Количество().

МассивФайлов = НайтиФайлы("C:\Обмен\", "*.xml", Ложь);
Если МассивФайлов.Количество() = 0 Тогда
    Сообщить("Файлы не найдены");
    Возврат;
КонецЕсли;
Для Каждого Файл Из МассивФайлов Цикл
    Сообщить(Файл.Имя + " — " + Файл.ПолноеИмя);
КонецЦикла;

Обратите внимание: в строковых литералах 1С обратный слэш не является управляющим символом, поэтому путь Windows записывается как есть, без удвоения. Завершающий слэш в пути желателен, но не обязателен.

Отбор файлов по маске и расширению

Маска поддерживает символы (любая последовательность символов) и ? (один произвольный символ). Чтобы получить только XML-файлы обмена, используйте ".xml"; чтобы найти файлы с определённым префиксом — "Прайс_*.xlsx".

Если нужно отобрать несколько типов файлов сразу (например, и XML, и TXT), одна маска не справится. Получите все файлы маской "." и отфильтруйте их в цикле по свойству Расширение:

Для Каждого Файл Из НайтиФайлы(Каталог, "<em>.</em>") Цикл
    Расширение = НРег(Файл.Расширение);
    Если Расширение = ".xml" Или Расширение = ".txt" Тогда
        // обработка файла
    КонецЕсли;
КонецЦикла;

Расширение возвращается с точкой, и регистр букв может отличаться в зависимости от того, как файл был создан. Поэтому сравнение всегда выполняйте после приведения к нижнему регистру через НРег().

Как получить файлы из всех подкаталогов

Третий параметр функции включает рекурсивный поиск. Вызов НайтиФайлы(Каталог, ".", Истина) вернёт файлы из самого каталога и из всех вложенных папок любой глубины. Это удобно, когда структура вложенности заранее неизвестна — например, при разборе архивной выгрузки с годовыми и месячными папками.

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

Если рекурсия не нужна, но требуется обойти два-три конкретных подкаталога, надёжнее вызвать НайтиФайлы() для каждого из них отдельно — так проще контролировать порядок обработки и локализовать ошибки доступа.

Чтение свойств найденных файлов

Каждый элемент массива — объект Файл с набором свойств, достаточных для большинства задач обработки:

• Имя — имя файла с расширением, без пути;
• ИмяБезРасширения и Расширение — части имени по отдельности;
• ПолноеИмя — полный путь, который передаётся в методы чтения, копирования, удаления;
• Путь — каталог, в котором лежит файл;
• Размер() — метод, возвращающий размер в байтах;
• ПолучитьВремяИзменения() — дата последней модификации, удобна для отбора «только новых» файлов.

Типовой сценарий инкрементальной загрузки — сравнивать время изменения файла с датой предыдущего обмена, хранящейся в константе или регистре сведений. Так обработка не будет повторно загружать старые файлы при каждом запуске.

Клиентский и серверный контекст: где искать файлы

Ключевой момент, который часто упускают: НайтиФайлы() ищет файлы в файловой системе того компьютера, где выполняется код. В серверной процедуре это сервер 1С, в клиентской — рабочая станция пользователя. Путь "C:\Обмен\", прекрасно работавший в файловой базе, в клиент-серверном варианте будет указывать на диск C сервера, а не пользователя.

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

Для регламентных заданий учитывайте ещё одну деталь: задание выполняется под учётной записью службы агента сервера 1С. У этой учётной записи должны быть права на чтение сетевого каталога, и путь лучше указывать в формате UNC (\\server\share\), а не через подключённый сетевой диск — буквы дисков для служб часто недоступны.

Типичные ошибки и их последствия

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

Проверка результата и отладка

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

Полезный приём — выводить найденные файлы в таблицу значений на форме обработки с колонками «Имя», «Размер», «Изменён», «Статус загрузки». Это даёт пользователю визуальный контроль и упрощает поиск причины, если какой-то файл не загрузился.

Частые вопросы