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

Получение списка файлов в каталоге — одна из базовых задач при разработке обменов данными, загрузке прайсов, обработке выгрузок из других систем и автоматизации рутинных операций в 1С. Во встроенном языке для этого предусмотрен метод НайтиФайлы(), который возвращает массив объектов типа Файл с полной информацией о каждом найденном элементе.

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

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

Синтаксис метода НайтиФайлы

Метод НайтиФайлы() доступен глобально и принимает три параметра, из которых обязательный только первый:

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

Результат — массив объектов типа Файл. Если ни один файл не подошёл под условия, возвращается пустой массив, а не Неопределено и не исключение. Это важно для корректной проверки результата.

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

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

Базовый пример: получить и перебрать файлы

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

Функция ПолучитьСписокФайлов(ПутьКПапке, Маска = "*")
Результат = Новый Массив;

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

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

Возврат Результат;
КонецФункции

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

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

Как отличить файлы от папок и прочитать атрибуты

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

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

Атрибуты полезны для отбора: например, обрабатывать только файлы, изменённые за последние сутки, или пропускать нулевого размера, которые часто остаются после незавершённой выгрузки. Проверка Размер() = 0 — простой способ отсечь «битые» файлы до попытки чтения.

Свойство Расширение возвращает строку вида .xml в нижнем регистре, поэтому сравнение лучше выполнять через НРег(Элемент.Расширение) = ".xml" — это защитит от файлов с расширением в верхнем регистре.

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

Маски поддерживают стандартные символы подстановки: заменяет любую последовательность символов, ? — один произвольный символ. Можно перечислить несколько масок через точку с запятой, например .xml;*.csv, чтобы одним вызовом получить файлы разных форматов.

Третий параметр включает рекурсию: при значении Истина метод обойдёт все вложенные папки и вернёт полный список. Это удобно, но на больших деревьях каталогов рекурсивный поиск может занимать заметное время и блокировать сеанс. Если структура папок известна, иногда быстрее обойти подкаталоги вручную с контролем глубины.

Работа в клиент-серверном режиме и управляемых формах

Главное правило: НайтиФайлы видит файловую систему того узла, где выполняется код. Серверный вызов ищет на дисках сервера 1С, клиентский — на компьютере пользователя. Если обменная папка лежит на сетевом ресурсе, убедитесь, что у учётной записи, под которой работает агент сервера 1С, есть к ней доступ — у системных учётных записей сетевые диски пользователя обычно недоступны.

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

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

&НаКлиенте
Процедура НайтиФайлыЗавершение(НайденныеФайлы, ДополнительныеПараметры) Экспорт
Для Каждого Файл Из НайденныеФайлы Цикл
Сообщить(Файл.ПолноеИмя);
КонецЦикла;
КонецПроцедуры

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

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

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

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

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