Как получить список файлов в каталоге в платформе 1С:Предприятие

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

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

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

Основной механизм поиска файлов

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

Синтаксис функции предельно прост, но требует внимательности при указании путей. Первый аргумент принимает строку с путем к каталогу, а второй — необязательную маску имени. Если маска не указана, система вернет абсолютно все объекты, находящиеся в директории, включая подкаталоги.

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

⚠️ Внимание: Функция НайтиФайлы не рекурсивна по умолчанию. Она сканирует только указанный каталог и не заходит в подпапки. Если вам нужен полный обход дерева директорий, потребуется реализовать циклический алгоритм или использовать рекурсивный вызов процедуры.

Для получения списка достаточно передать путь в переменную. Пример кода демонстрирует базовое использование:

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

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

Работа с масками и фильтрация результатов

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

Существует два основных спецсимвола для масок. Звездочка * заменяет любую последовательность символов любой длины, а вопросительный знак ? заменяет ровно один произвольный символ. Комбинируя их, можно создавать сложные фильтры.

• 📁 *.txt — найдет все файлы с расширением txt.
• 📄 Отчет_?.pdf — найдет файлы вроде "Отчет_1.pdf", но пропустит "Отчет_10.pdf".
• 📂 2026*.xml — отберет все xml-файлы, имя которых начинается с 2026.

Стоит отметить, что регистр символов в маске обычно игнорируется в Windows, но может быть важен в Linux-серверах, где часто развернуты серверы 1С. Поэтому для кроссплатформенной совместимости лучше использовать нижний регистр в расширениях или проверять имя файла программно после получения списка.

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

Анализ свойств найденных объектов

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

Наиболее востребованными свойствами являются Размер, ДатаИзменения и ЭтоФайл. Последнее свойство критически важно, так как функция поиска возвращает и файлы, и каталоги. Без проверки вы можете попытаться прочитать папку как файл, что вызовет ошибку выполнения.

Свойство объекта	Тип данных	Описание
Имя	Строка	Краткое имя файла без пути
ПолноеИмя	Строка	Абсолютный путь к объекту
ЭтоФайл	Булево	Истина, если объект является файлом
Размер	Число	Размер файла в байтах
ДатаИзменения	Дата	Время последнего изменения атрибутов

Использование свойства Расширение позволяет быстро группировать файлы по типам. Это удобно при организации импорта данных, когда разные форматы требуют разных обработчиков. Например, XML-файлы могут отправляться в парсер, а картинки — в хранилище бинарных данных.

⚠️ Внимание: Свойство Размер для каталогов возвращает 0 или технический размер служебной информации, но не объем всех вложенных файлов. Не используйте его для оценки занятого места на диске внутри папки.

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

Если Файл.Размер > 10485760 Тогда // Ограничение 10 Мб
Продолжить;
КонецЕсли;

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

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

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

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

• 🔄 Создайте процедуру с параметром ПутьККаталогу.
• 📂 Внутри вызовите НайтиФайлы для текущего пути.
• 📝 Пройдите циклом: если это файл — обработайте, если папка — вызовите процедуру снова.

Ниже приведен пример структуры такой процедуры. Обратите внимание на использование оператора Продолжить для пропуска служебных директорий, таких как "." и "..", хотя в 1С они обычно автоматически фильтруются, явная проверка не помешает.

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

Оптимизация рекурсии

Для ускорения работы на больших дисках можно добавить параметр Глубина, который будет уменьшаться с каждым вложенным вызовом и прерывать рекурсию при достижении нуля.

Особенности работы в клиент-серверном варианте

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

Попытка вызвать НайтиФайлы на сервере с путем к диску клиента (например, C:\Users\Ivanov\Docs) завершится ошибкой или вернет пустой массив, так как сервер физически не имеет доступа к этому ресурсу. И наоборот, клиент не может напрямую читать файлы с диска сервера.

Для решения этой проблемы используются механизмы передачи файлов. Если нужно обработать файлы пользователя, выбор маски и списка должен происходить на клиенте, а сами файлы передаваться на сервер через ХранилищеЗначения или потоки. Если же файлы лежат на сервере, то весь процесс поиска и анализа должен выполняться в серверном контексте.

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

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

Обработка ошибок и исключительных ситуаций

Работа с внешними ресурсами, такими как файловая система, всегда сопряжена с рисками. Файл может быть удален в момент обращения, путь может стать недоступным из-за сетевых проблем, или у процесса 1С может не быть прав на чтение каталога.

Корректная обработка ошибок позволяет приложению оставаться стабильным. В 1С для этого используется конструкция Попытка...Исключение. Оборачивая вызовы файловой системы в этот блок, вы предотвращаете падение всей транзакции или зависание интерфейса.

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

Попытка
Список = НайтиФайлы(Путь);
Исключение
Сообщить("Ошибка доступа к каталогу: " + ОписаниеОшибки());
КонецПопытки;

Также стоит учитывать, что некоторые антивирусы могут блокировать попытки скриптов сканировать определенные системные директории. Если вы получаете странные ошибки доступа к легальным папкам, проверьте настройки безопасности ОС и логи антивирусного ПО.

Можно ли получить список файлов в веб-клиенте 1С?

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

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

Массив, возвращаемый функцией НайтиФайлы, не гарантированно отсортирован. Для сортировки используйте метод Упорядочить() объекта Массив, передав в него описание сортировки по полю ДатаИзменения.

В чем разница между Имя и ПолноеИмя файла?

Свойство Имя содержит только имя файла с расширением (например, "report.txt"). Свойство ПолноеИмя содержит абсолютный путь, включая все родительские директории (например, "C:\Docs\report.txt").

Почему НайтиФайлы возвращает пустой массив?

Это может происходить по нескольким причинам: каталог действительно пуст, неверно указана маска имени (например, регистр на Linux), у пользователя нет прав на чтение папки или путь не существует.

Как получить только файлы определенного размера?

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