Как исправить ошибку «каталог %AppData%\Local\1C не обнаружен» при отправке почты из 1С?

← На главную

При разработке функционала отправки писем с вложениями в 1С программисты часто сталкиваются с необходимостью временного сохранения файлов (например, печатных форм в формате PDF) перед их отправкой. Одной из типичных ошибок является попытка использовать системные переменные окружения операционной системы Windows напрямую внутри строковых литералов 1С. В этой статье мы подробно разберем, почему возникает ошибка «каталог %AppData%\Local\1C не обнаружен», проанализируем нюансы клиент-серверного взаимодействия и рассмотрим правильные методы работы с файловой системой в платформе 1С:Предприятие.

Выясняем причину: почему 1С выдает ошибку?

Рассмотрим строку исходного кода, которая привела к возникновению проблемы:


Каталог = "%AppData%\Local\1C";
// ...
ИмяФайлаСчет = Каталог+"\Счет"+Счет.ДокументСчет.Номер+".pdf";
ТабДок.Записать(ИмяФайлаСчет,ТипФайлаТабличногоДокумента.PDF);

Для операционной системы Windows запись вида %AppData% является переменной окружения (Environment Variable), которая динамически заменяется на путь к папке профиля текущего пользователя (например, C:\Users\ИмяПользователя\AppData\Roaming). Однако платформа 1С воспринимает эту строку буквально. Для встроенного языка 1С строка "%AppData%\Local\1C" — это просто набор символов. Платформа пытается найти в корне текущего рабочего диска или в рабочем каталоге папку с физическим именем, начинающимся на знак процента, не находит её и возвращает ошибку выполнения.

Кроме того, в исходном пути автора темы закралась логическая неточность: переменная %AppData% по умолчанию указывает на каталог Roaming. Попытка принудительно дописать к ней \Local\1C приведет к поиску несуществующего пути AppData\Roaming\Local\1C. Для перехода в локальный профиль в Windows используется отдельная переменная — %LocalAppData%.

Важный нюанс: Клиент или Сервер?

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

Если код выполняется на стороне сервера (а в современных конфигурациях на управляемых формах отправка почты и формирование печатных форм практически всегда происходят на сервере):

Отсутствие окружения пользователя: Серверная служба 1С (обычно работающая под учетной записью USR1CV8) может не иметь стандартных пользовательских каталогов AppData. Попытка обратиться к ним вызовет ошибку прав доступа.
Кроссплатформенность: Если сервер 1С работает под управлением ОС Linux, то никаких переменных типа %AppData% или %LocalAppData% в системе в принципе не существует. Код гарантированно завершится аварийно.

Поэтому ручное конструирование путей к системным папкам Windows является грубой ошибкой разработки.

Решение №1: Использование встроенной функции ПолучитьИмяВременногоФайла()

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

Давайте разберем по шагам, как переписать проблемный участок кода:


Если ЗначениеЗаполнено(Счет.ДокументСчет) Тогда
    // Шаг 1: Получаем уникальный путь к временному файлу с расширением pdf.
    // Платформа сама определит доступный временный каталог (Temp) на клиенте или сервере.
    ИмяВременногоФайла = ПолучитьИмяВременногоФайла("pdf");
    
    // Шаг 2: Формируем печатную форму на сервере
    ТабДок = ПечатьДокументаНаСервере(Счет.ДокументСчет, "ПФ_MXL_СчетЗаказПечать", "СчетЗаказСПечатью", "Счет на оплату");
    
    Если ТабДок <> Неопределено Тогда
        // Записываем файл по уникальному временному пути
        ТабДок.Записать(ИмяВременногоФайла, ТипФайлаТабличногоДокумента.PDF);
    КонецЕсли;
    
    // Шаг 3: Добавляем файл во вложение. 
    // Вторым параметром указываем понятное «красивое» имя файла, которое увидит получатель письма.
    КрасивоеИмяФайла = "Счет № " + СокрЛП(Счет.ДокументСчет.Номер) + ".pdf";
    Сообщение.Вложения.Добавить(Новый ДвоичныеДанные(ИмяВременногоФайла), КрасивоеИмяФайла);
КонецЕсли;

Преимущества данного подхода:

Платформа гарантирует наличие прав на запись в каталог, возвращаемый для временных файлов.
Имена файлов всегда уникальны (например, v8_F3A1_12.pdf). Это исключает конфликт блокировок, если несколько пользователей одновременно запускают рассылку.
Метод работает одинаково успешно как на Windows, так и на Linux.

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

Решение №2: Использование методов Библиотеки Стандартных Подсистем (БСП)

Если ваша конфигурация построена на базе БСП (что справедливо для большинства современных решений, таких как «1С:Бухгалтерия», «1С:Управление торговлей», «1С:ERP» и др.), для работы с файлами лучше использовать готовый и протестированный функционал общего модуля ФайловаяСистема.

Проанализируем пример создания временного каталога и генерации уникального пути через БСП:


// Создаем уникальный временный каталог, который автоматически очистится после завершения сеанса
ИмяВременногоКаталога = ФайловаяСистема.СоздатьВременныйКаталог();

// Формируем безопасное имя файла внутри этого каталога
ИмяФайлаСчет = ФайловаяСистема.УникальноеИмяФайла(ИмяВременногоКаталога, "Счет.pdf");

Если ТабДок <> Неопределено Тогда
    ТабДок.Записать(ИмяФайлаСчет, ТипФайлаТабличногоДокумента.PDF);
КонецЕсли;

Использование БСП делает ваш код более лаконичным, стандартизированным и защищенным от платформенных различий операционных систем.

Решение №3: Разрешение системных переменных через COM (только для Windows-клиента)

В исключительных случаях, когда вам действительно необходимо получить доступ именно к специфическим папкам Windows текущего пользователя (и вы абсолютно уверены, что данный код выполняется строго на клиенте под управлением Windows), можно прибегнуть к использованию системного объекта WScript.Shell через механизм COM-соединения.

Посмотрим на пример реализации раскрытия переменных среды:


Попытка
    // Создаем объект оболочки Windows
    Shell = Новый COMОбъект("WScript.Shell");
    // Используем метод ExpandEnvironmentStrings для преобразования %LocalAppData% в реальный путь
    ПутьКЛокал = Shell.ExpandEnvironmentStrings("%LocalAppData%");
    Каталог = ПутьКЛокал + "\1C";
    
    // Проверяем существование каталога, и если его нет — создаем
    ФайлНаДиске = Новый Файл(Каталог);
    Если НЕ ФайлНаДиске.Существует() Тогда
        СоздатьКаталог(Каталог);
    КонецЕсли;
Исключение
    Сообщить("Не удалось получить доступ к системным папкам: " + ОписаниеОшибки());
КонецПопытки;

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

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