Как создать каталог на диске в 1С

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

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

Базовый метод СоздатьКаталог

Основной инструмент — глобальный метод СоздатьКаталог(ИмяКаталога). В параметре передаётся полный или относительный путь. При успешном выполнении папка появляется на диске, при ошибке (нет прав, недопустимые символы, несуществующий родительский путь) вызывается исключение.

Процедура СоздатьПапкуВыгрузки()
	ПутьККаталогу = "D:\Обмен\Выгрузка";
	Попытка
		СоздатьКаталог(ПутьККаталогу);
		Сообщить("Каталог создан: " + ПутьККаталогу);
	Исключение
		Сообщить("Ошибка: " + ОписаниеОшибки());
	КонецПопытки;
КонецПроцедуры

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

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

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

Функция КаталогСуществует(Путь)
	Найденные = НайтиФайлы(Путь, "*");
	Если Найденные.Количество() > 0 Тогда
		Возврат Найденные[0].ЭтоКаталог();
	КонецЕсли;
	// Проверка самого пути как каталога
	Файл = Новый Файл(Путь);
	Возврат Файл.Существует();
КонецФункции

Более простой вариант — объект Файл: конструктор принимает путь, а метод Существует() возвращает Истина, если такой файл или каталог есть на диске. Для различения файла и папки используйте метод ЭтоКаталог().

Типовой шаблон «создать, если нет» выглядит так: проверили через Новый Файл(Путь), при отсутствии вызвали СоздатьКаталог, результат обернули в Попытка/Исключение. Это защищает от гонок, когда папку создаёт другой процесс между проверкой и созданием.

Создание вложенной структуры каталогов

Для построения цепочки вида D:\Архив\2026\Январь путь разбивают на части и создают каждый уровень последовательно. Удобно написать универсальную процедуру, которую затем вызывать из любого места конфигурации.

Процедура СоздатьКаталогРекурсивно(ПолныйПуть)
	Разделитель = ПолучитьРазделительПути();
	Части = СтрРазделить(ПолныйПуть, Разделитель);
	ТекущийПуть = "";
	Для Каждого Часть Из Части Цикл
		ТекущийПуть = ?(ТекущийПуть = "", Часть, ТекущийПуть + Разделитель + Часть);
		Файл = Новый Файл(ТекущийПуть);
		Если Не Файл.Существует() Тогда
			СоздатьКаталог(ТекущийПуть);
		КонецЕсли;
	КонецЦикла;
КонецПроцедуры

Функция ПолучитьРазделительПути() возвращает «\» для Windows и «/» для Linux, что делает код переносимым между серверами на разных ОС. Не зашивайте обратный слэш в строки жёстко, если база может работать на Linux-сервере.

1. 1
   Сформируйте полный путь к нужному каталогу
2. 2
   Проверьте существование через Новый Файл(Путь)
3. 3
   Создайте недостающие уровни по очереди
4. 4
   Оберните создание в Попытка/Исключение
5. 5
   Проверьте результат повторным вызовом Существует()

Выбор пути пользователем через диалог

Если папку должен указывать пользователь, используйте объект ДиалогВыбораФайла в режиме выбора каталога. В тонком клиенте диалог работает асинхронно через Показать() с описанием оповещения.

&НаКлиенте
Процедура ВыбратьКаталог(Команда)
	Диалог = Новый ДиалогВыбораФайла(РежимДиалогаВыбораФайла.ВыборКаталога);
	Диалог.Заголовок = "Выберите папку для выгрузки";
	Если Диалог.Выбрать() Тогда
		ПутьВыгрузки = Диалог.Каталог;
	КонецЕсли;
КонецПроцедуры

После выбора имеет смысл сразу проверить доступность папки на запись: создать в ней временный файл и удалить его. Это отсечёт ситуации, когда пользователь указал защищённый системный каталог вроде C:\Windows.

Где выполняется код: клиент или сервер

Ключевой нюанс — место создания каталога. Код с директивой &НаКлиенте создаёт папку на компьютере пользователя, а &НаСервере — на сервере 1С под учётной записью агента сервера (обычно USR1CV8). Частая ошибка новичка — создать папку на сервере и искать её на своём компьютере.

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

Временные каталоги и очистка

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

После завершения операции временные файлы и созданный подкаталог следует удалить методом УдалитьФайлы(Путь). Иначе на сервере постепенно накапливается мусор, который при активной выгрузке отчётов способен занять значительное место на диске.

Проверка результата и типичные ошибки

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

Если ошибка возникает только на сервере, первым делом проверьте права учётной записи агента сервера 1С на целевую папку. Вторая частая причина — сетевой путь: служба сервера 1С может не иметь доступа к сетевым ресурсам, подключённым как диски интерактивного пользователя. Используйте UNC-пути вида \\Сервер\Ресурс\Папка и выдайте права именно служебной учётной записи.

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