К статье
Практический материал

Другое · 7 мин

Перебор файлов в каталоге в 1C: практическая инструкция

Практичная инструкция по перебору файлов в папке на языке 1C: способы, маски, рекурсия, типичные ошибки и проверка результата в конфигурации

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

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

В типовых версиях платформы перебор начинается с получения массива имён файлов в указанной папке. Обычно применяются глобальные функции для работы с файловой системой, а маска позволяет ограничить набор, например только файлы с расширением .xml, .pdf или .tif. Если маска не задана или задана некорректно, результат может быть пустым без сообщения об ошибке.

Путь к папке может быть абсолютным или относительным. Для надёжности лучше явно следить за завершающим разделителем каталога и не склеивать пути вручную без проверки, иначе полученные имена могут не совпадать с реальными полными путями. При работе на сервере путь должен быть доступен процессу сервера 1C, а не только клиентскому компьютеру.

Способы получения списка файлов в каталоге

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

Путь к папкеАбсолютный или относительный

Проверьте наличие завершающего разделителя и доступ папки для сеанса 1C

Маска файловНапример, <em>.xml или </em>.pdf

Неверная маска часто приводит к пустому результату без ошибки

Контекст выполненияКлиент или сервер

На сервере путь должен быть доступен процессу сервера 1C

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

После получения списка имена нужно преобразовать в полные пути. Для этого путь к папке объединяется с именем файла, а полученный результат передаётся в конструктор объекта Файл. Объект позволяет проверить, существует ли файл, и получить его атрибуты без открытия содержимого.

Порядок действий при переборе файлов
  1. 1
    Укажите путь к папке и маску файлов
  2. 2
    Получите список имён файлов
  3. 3
    Пройдите по списку циклом и составьте полные пути
  4. 4
    Проверьте существование и доступность каждого файла
  5. 5
    Обработайте подходящие файлы и зафиксируйте ошибки

Проверка файла через объект Файл

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

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

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

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

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

Типичные ошибки
01
Пропуск проверки существования файла перед открытием — ошибка при удалении или блокировке файла
02
Использование неверной маски или пути без разделителя — пустой результат без сообщения об ошибке

Ограничения, риски и типичные ошибки

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

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

Контрольные точки

Как проверить результат

Количество найденных файлов
Норма

Совпадает с ожидаемым по маске

Тревожный признак

Ноль файлов при ожидаемом наличии

Обработанные файлы
Норма

Зафиксированы в журнале или перемещены

Тревожный признак

Повторно попадают в список при следующем запуске

Ошибки доступа
Норма

Отсутствуют или описаны

Тревожный признак

Массовые ошибки блокировки или прав доступа

Как проверить результат перебора

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

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

Итог

Что важно запомнить

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

Нужно ли использовать внешние компоненты для перебора файлов?

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

Что делать, если функция вернула пустой список?

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

Можно ли удалять файлы во время перебора?

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

Как обрабатывать вложенные папки?

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

Чем отличается клиентский и серверный вызов?

На клиенте доступ к файлам определяется правами пользователя и клиентского компьютера, на сервере — правами и доступом процесса сервера 1C. Укажите путь, который действительно доступен в том контексте, где выполняется код.