Другое · 9 мин
Как получить файлы из каталога в 1С
Практическая инструкция по получению файлов из каталога в 1С: проверка пути и прав, обход файлов по маске, чтение содержимого, ошибки и клиент-серверные нюансы.
Задача получения файлов из каталога в 1С возникает при обмене данными, загрузке отчётов, импорте выписок и обработке вложенных документов. Платформа не даёт одной универсальной кнопки «выбрать папку и забрать всё», поэтому разработчику приходится самостоятельно составить путь, проверить доступность каталога, получить список файлов и обработать каждый из них. Ниже разбирается порядок действий, применимый к типовым конфигурациям 1С:Предприятия 8.
Первое условие — чётко задать папку. Путь может быть абсолютным, например «C:\Загрузка\Отчёты», или относительным к рабочему каталогу информационной базы. В client-server варианте Неправильное представление о местонахождении каталога — частая причина того, что файлы не находятся, хотя папка видна в проводнике пользователя.
Второе условие — права доступа. Учётная запись, от имени которой работает 1С, должна иметь право на чтение каталога и список файлов. Если папка сетевая, проверяется доступ по UNC-пути и права на общий ресурс. Антивирус или политика безопасности могут блокировать массовое чтение файлов, особенно с расширениями.exe.bat.js. Перед внедрением рекомендуется протестировать сценарий на копии базы и в изолированной тестовой папке.
Задание пути и маски файлов
Перед поиском файлов формируют строку с путём к каталогу. Если папка постоянная, путь можно вынести в настройки или справочник, чтобы не править код при переносе базы на другой сервер. Для временных загрузок удобно использовать диалог выбора папки, но в серверном режиме такой диалог может быть недоступен, поэтому путь чаще задают программно.
Маска определяет, какие файлы попадают в выборку. Можно брать все файлы «», только XML «.xml», только изображения «.jpg;.png» или конкретные имена. Если маска слишком широкая, в список попадут служебные файлы, временные копии и архивы, что приведёт к ошибкам чтения. Если слишком узкая, нужные файлы останутся незамеченными. Рекомендуется заранее составить перечень допустимых расширений и проверять его перед обработкой.
Проверка доступности каталога
Перед попыткой получить список файлов следует убедиться, что каталог существует и доступен. Обращение к несуществующему пути или к отключённому сетевому диску вызывает ошибку выполнения и может прервать обработку. Проверка должна включать наличие папки, права на чтение и отсутствие блокировки другим процессом.
Если каталог сетевой, стоит проверить подключение по UNC-пути из-под той же учётной записи, от которой запущен сервер 1С или клиентское приложение. Иногда папка открывается в проводнике от имени пользователя, но недоступна для службы 1С из-за отличий в правах. Признаком успешной проверки является возможность получить список файлов без исключения.
Получение списка файлов и обход коллекции
После проверки пути выполняется перебор файлов в каталоге по заданной маске. На этом этапе формируется коллекция имён или полных путей к файлам. Каждый элемент проверяется на соответствие ожидаемому типу: например, пропускаются подпапки, если нужны только файлы, и игнорируются файлы нулевого размера. Результатом обхода должен быть набор путей, готовых к чтению.
При большом количестве файлов обработка может занять длительное время. В таких случаях целесообразно обрабатывать файлы пачками, фиксировать прогресс и предусмотреть возможность прерывания. Если в процессе обхода появляются новые файлы, они могут не попасть в текущую выборку, поэтому повторный запуск нужен для обработки только что поступивших документов.
- 1Задать путь к каталогу и маску файлов
- 2Проверить существование каталога и права на чтение
- 3Получить список файлов по маске
- 4Пройти по списку и прочитать нужные файлы
- 5Зафиксировать результат и ошибки
Чтение содержимого найденных файлов
Каждый файл из полученного списка открывается по отдельности. Для текстовых файлов подходит построчное чтение, для XML — разбор структуры, для двоичных — чтение потока. Перед чтением уточняют кодировку: UTF-8, Windows-1251 или другая, иначе содержимое может отображаться некорректно. После чтения файл закрывают, чтобы не оставить блокировку.
Результат чтения записывают в регистры, документы или таблицу значений в зависимости от задачи. Если файл повреждён или открыт другой программой, обработка этого файла прерывается с записью в журнал, а общая загрузка продолжается со следующим файлом. Признаком успешного завершения является отсутствие необработанных файлов и наличие записей в целевых объектах информационной базы.
Клиент-серверный режим и место выполнения кода
В файловом варианте 1С код и файлы обычно находятся на одном компьютере, и пути работают привычно. В клиент-серверном варианте обработка может выполняться на сервере приложений, а пользователь сидит за своим рабочим столом. Тогда путь «C:\Загрузка» означает диск сервера, а не диск пользователя, и файл, лежащий на рабочем столе менеджера, сервер не увидит.
Если нужно загрузить файл с компьютера пользователя, применяется механизм загрузки через клиентское приложение или временное хранение в общем каталоге, доступном и клиенту, и серверу. Попытка чтения клиентского диска из серверной процедуры приведёт к ошибке или пустому результату. Граница безопасной самостоятельной работы — использование только тех папок, к которым у запускающего процесса есть прямой доступ.
Ограничения, риски и типичные ошибки
Основные ограничения связаны с правами доступа, длиной пути и блокировками файлов. Слишком длинный путь с вложенными папками может вызвать ошибку при обращении. Файл, открытый в Excel или другой программе, может быть недоступен для чтения из 1С. Сетевые папки временно недоступны при сбое связи или перезагрузке сервера файлов.
К типичным ошибкам относятся попытка прочитать подпапку как файл, отсутствие проверки кодировки, обработка всех файлов подряд без фильтра по расширению и запись результата в базу без резервной копии. Массовое удаление или перемещение файлов после чтения без проверки успешной загрузки может привести к потере данных. Перед такими операциями обязательно делают резервную копию информационной базы и исходных файлов.
Альтернативы и когда использовать готовые механизмы
Если задача заключается в обмене с внешней системой, целесообразно использовать встроенные механизмы обмена данными, импорт из файла или сервисы загрузки, а не писать обход каталога с нуля. Для регулярной выгрузки банковских выписок или отчётов удобнее настроить запланированное задание, которое само забирает файлы из определённой папки по расписанию.
Ручной обход каталога оправдан, когда файлы лежат в нестандартном месте, требуется предварительная фильтрация по имени или содержимому, или нужно обработать файлы перед загрузкой нестандартным образом. В остальных случаях готовые механизмы надёжнее и проще в поддержке. Выбор зависит от частоты операции, количества файлов и критичности данных.
Сравнение вариантов
Подходит для нестандартных папок и сложной фильтрации, требует написания кода и проверки прав.
Надёжнее для регулярных операций, но ограничены поддерживаемыми форматами и путями.
Безопасность и проверка результата
Работа с файловой системой несет риск изменения или удаления данных, поэтому операции с файлами лучше проводить на копии базы и в тестовой папке. Не следует давать учётной записи 1С избыточных прав на целые диски; достаточно доступа к конкретному каталогу загрузки. После завершения обработки проверяют, что все ожидаемые файлы прочитаны, ошибки записаны в журнал, а целевые объекты в базе заполнены корректно.
Если в процессе возникла ошибка на одном из файлов, не стоит прерывать всю загрузку. Лучше пропустить проблемный файл, зафиксировать причину и продолжить со следующим. По окончании сверяют количество обработанных файлов с количеством файлов в каталоге по маске. Расхождение указывает на пропущенные, заблокированные или несоответствующие маске файлы.
Что важно запомнить
Укажите верный путь и маску, проверьте права и место выполнения кода, читайте файлы по одному с обработкой ошибок и делайте резервные копии перед массовыми операциями.
Часто задаваемые вопросы
Можно ли получить файлы из папки на компьютере пользователя из серверной процедуры 1С?
В клиент-серверном режиме серверная процедура обращает путь на сервере приложений, а не на рабочем столе пользователя. Файлы с клиентского диска нужно сначала передать через клиентское приложение или положить в общую папку, доступную и клиенту, и серверу.
Что делать, если 1С не видит файлы в сетевой папке?
Проверьте UNC-путь, права учётной записи, от которой запущен сервер или клиент 1С, доступность сетевого ресурса и блокировку антивирусом. Папка может открываться у пользователя, но быть недоступной для службы 1С из-за отличий в правах.
Нужно ли удалять исходные файлы после чтения?
Удалять стоит только после подтверждения успешной записи данных в информационную базу и создания резервной копии. При сомнениях лучше переместить файлы в папку «Обработано» вместо безвозвратного удаления.
Как обработать большое количество файлов без зависания?
Разбейте загрузку на пачки, фиксируйте прогресс и предусмотрите возможность прерывания. Не пытайтесь прочитать тысячи файлов в одной транзакции без промежуточного сохранения результата.
Какие файлы следует исключать из обработки?
Исключайте подпапки, временные файлы, файлы нулевого размера и расширения, не относящиеся к задаче. Используйте чёткую маску по расширениям и проверяйте имя файла перед открытием.