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

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

Основной инструмент — функция НайтиФайлы(Путь, Маска, ИскатьВПодкаталогах). Она возвращает массив объектов типа Файл, из которых можно получить полное имя, расширение, размер, дату изменения и признак «это каталог». Дальше массив обычно перебирается в цикле, а каждый файл обрабатывается по своей логике: читается, копируется, удаляется или помещается в список значений.

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

Базовый способ: функция НайтиФайлы

Функция НайтиФайлы() принимает до трёх параметров. Первый — путь к каталогу, в котором выполняется поиск. Второй — маска отбора, например .xml или .csv; если маску не указать или передать ., будут возвращены все объекты каталога, включая подпапки. Третий параметр — булево: искать ли в подкаталогах рекурсивно.

Минимальный рабочий пример выглядит так:

НайденныеФайлы = НайтиФайлы("D:\Обмен", "*.xml", Ложь);

Для Каждого Файл Из НайденныеФайлы Цикл
Сообщить(Файл.ПолноеИмя);
КонецЦикла;

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

Обратите внимание на слэши: платформа корректно понимает и прямые, и обратные слэши в путях, но в строковых литералах встроенного языка обратный слэш не требует экранирования, поэтому пути вида "D:\Обмен\Загрузка" записываются как есть.

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

Какие свойства файла доступны после поиска

Каждый элемент массива — это объект Файл с набором полезных свойств. Знание этих свойств избавляет от лишних вызовов и ручного разбора строк пути.

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

Отбор только файлов без подкаталогов

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

НайденныеФайлы = НайтиФайлы(КаталогОбмена, ".", Ложь);

Для Каждого Элемент Из НайденныеФайлы Цикл
Если Элемент.ЭтоКаталог() Тогда
Продолжить;
КонецЕсли;
// Обработка файла
КонецЦикла;

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

Рекурсивный обход подкаталогов

Третий параметр ИскатьВПодкаталогах = Истина включает рекурсивный поиск: платформа сама обойдёт все вложенные папки и вернёт плоский массив результатов. Это удобно, когда структура подкаталогов заранее неизвестна — например, поставщик выгружает файлы в папки по датам.

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

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

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

Клиент, сервер и тонкий клиент: где выполняется поиск

В клиент-серверной базе НайтиФайлы на сервере видит только диски и сетевые пути, доступные учётной записи, под которой работает агент сервера 1С. Локальный диск C:\ пользователя серверу недоступен — поиск вернёт пустой массив без всякой ошибки. Это выглядит как «код не работает», хотя проблема в контексте выполнения.

Если файлы лежат на компьютере пользователя, есть два рабочих варианта. Первый — выполнять поиск на клиенте (директива &НаКлиенте), а затем передавать файлы на сервер через НачатьПомещениеФайлаНаСервер или помещение во временное хранилище. Второй — настроить общий сетевой каталог, доступный и пользователям, и серверу, и работать с ним по UNC-пути вида \\server\share.

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

Альтернативные подходы и смежные задачи

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

Если требуется не просто список, а постоянный мониторинг каталога обмена, штатного «наблюдателя за папкой» в платформе нет. Практикуют регламентное задание, которое периодически вызывает НайтиФайлы и сравнивает результат с уже обработанными именами, сохранёнными в регистре сведений. Интервал опроса подбирают под интенсивность обмена.

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

Типичные ошибки и как их избежать

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

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

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