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

Работа с файлами в 1С:Предприятие — одна из самых частых задач, с которыми сталкиваются разработчики.hether вы загружаете данные из Excel, сохраняете отчёты в PDF или обрабатываете архивы, рано или поздно потребуется получить имя файла — будь то для логов, проверок или динамического формирования путей. Казалось бы, что может быть проще? Но в 1С есть нюансы: от различий между клиентом и сервером до ограничений безопасности при работе с файловой системой.

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

1. Стандартные функции 1С для работы с именами файлов

В 1С:Предприятие 8.3 есть встроенные функции, которые упрощают работу с путями. Их главное преимущество — кросс-платформенность (работают и в Windows, и в Linux-версиях платформы). Рассмотрим основные:

📁 СтрЗначениеПути(Путь) — возвращает последнюю часть пути (имя файла или папки). Пример: для "C:\Temp\Отчет.xlsx" вернёт "Отчет.xlsx".
🔍 НайтиФайлы(Маска) — ищет файлы по маске и возвращает их полные пути. Из результата можно извлечь имена.
📄 ПолучитьИмяВременногоФайла() — генерирует уникальное имя для временного файла (полезно для промежуточных операций).

Пример использования СтрЗначениеПути():

ПутьКФайлу = "C:\Отчеты\Продажи_2026.xlsx";
ИмяФайла = СтрЗначениеПути(ПутьКФайлу);
// Результат: "Продажи_2026.xlsx"

Важно! Функция СтрЗначениеПути() работает только с корректными путями. Если передать строку без разделителей (например, "Отчет.xlsx"), она вернёт её без изменений. Также она не проверяет существование файла — только анализирует строку.

💡

Если вам нужно не только имя, но и расширение файла, используйте комбинацию СтрЗначениеПути() и СтрРазделить() по точке. Например, для разделения "Отчет.xlsx" на "Отчет" и "xlsx".

2. Получение имени файла из диалога выбора

Частая задача — дать пользователю возможность выбрать файл через стандартный диалог, а затем извлечь его имя. В 1С для этого используется объект ФайловыйДиалог. Вот как это сделать:

Диалог = Новый ФайловыйДиалог(РежимФайловогоДиалога.Открытие);
Диалог.Заголовок = "Выберите файл для обработки";
Диалог.Фильтр = "Excel файлы (.xlsx)|.xlsx";
Если Диалог.Выбрать() Тогда
ПолныйПуть = Диалог.ПолноеИмяФайла;
ИмяФайла = СтрЗначениеПути(ПолныйПуть);
Сообщить("Выбран файл: " + ИмяФайла);
КонецЕсли;

Обратите внимание на свойства диалога:

📌 ПолноеИмяФайла — возвращает путь с именем (например, "C:\Temp\data.xlsx").
📌 ИмяФайла — возвращает только имя без пути (например, "data.xlsx").
📌 Фильтр — ограничивает типы файлов, которые пользователь может выбрать.

Если диалог используется для сохранения файла (режим РежимФайловогоДиалога.Сохранение), можно заранее задать предлагаемое имя через свойство ИмяФайла:

Диалог.ИмяФайла = "Отчет_" + Формат(ТекущаяДата(), "ДФ=ddMMyyyy") + ".xlsx";

💡

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

3. Работа с путями: разбор на компоненты

Иногда недостаточно просто получить имя файла — требуется разложить путь на части: диск, папки, расширение. Для этого в 1С есть функция РазложитьПуть(), но она возвращает массив, который нужно обработать. Альтернатива — ручной разбор с помощью СтрРазделить().

Пример разбора пути на компоненты:

Путь = "C:\Documents\Отчеты\Продажи_2026.pdf";
ЧастиПути = СтрРазделить(Путь, "\");
ИмяФайлаСРасширением = ЧастиПути[ЧастиПути.ВГраница()];
ИмяБезРасширения = Лев(ИмяФайлаСРасширением, Найти(ИмяФайлаСРасширением, ".") - 1);
Расширение = Прав(ИмяФайлаСРасширением, СтрДлина(ИмяФайлаСРасширением) - Найти(ИмяФайлаСРасширением, "."));

Для удобства можно создать общую функцию, которая будет возвращать ассоциативный массив с компонентами пути:

Функция РазобратьПуть(Путь)
Результат = Новый Структура;
Части = СтрРазделить(Путь, "\");
Результат.Вставить("Диск", Части[0]);
Результат.Вставить("Папки", СокрЛП(Сред(Путь, СтрДлина(Части[0]) + 1, Найти(Путь, Части[Части.ВГраница()]) - СтрДлина(Части[0]) - 2)));
Результат.Вставить("ИмяСРасширением", Части[Части.ВГраница()]);
Результат.Вставить("ИмяБезРасширения", Лев(Части[Части.ВГраница()], Найти(Части[Части.ВГраница()], ".") - 1));
Результат.Вставить("Расширение", Прав(Части[Части.ВГраница()], СтрДлина(Части[Части.ВГраница()]) - Найти(Части[Части.ВГраница()], ".")));
Возврат Результат;
КонецФункции;

Компонент	Пример значения	Как получить
Диск	`"C:"`	`Части[0]`
Папки	`"Documents\Отчеты"`	Средняя часть пути
Имя с расширением	`"Продажи_2026.pdf"`	`Части[Части.ВГраница()]`
Имя без расширения	`"Продажи_2026"`	`Лев(..., Найти(..., ".") - 1)`
Расширение	`"pdf"`	`Прав(..., СтрДлина(...) - Найти(..., "."))`

4. Ошибки при работе с именами файлов и как их избежать

Даже в простых операциях с файлами можно столкнуться с ошибками. Рассмотрим типичные проблемы и их решения:

❌ Ошибка доступа: Ошибка при вызове метода контекста (Выгрузить) — возникает, если у 1С нет прав на запись в папку. Решение: проверьте права или используйте временные файлы через ПолучитьИмяВременногоФайла().
❌ Неправильная кодировка: имена файлов с кириллицей могут отображаться как "?????.xlsx". Решение: используйте КодировкаТекста.UTF8 при работе с файлами.
❌ Пустой результат: СтрЗначениеПути() возвращает пустоту, если путь заканчивается разделителем (например, "C:\Temp\"). Решение: удалите последний символ через Лев(Путь, СтрДлина(Путь) - 1).

⚠️ Внимание: В 1С:Предприятие 8.3.20+ при работе с сетевыми путями (например, "\\server\share\file.txt") функция СтрЗначениеПути() может вести себя нестабильно. Всегда тестируйте код на реальных данных!

Ещё одна распространённая ошибка — переполнение пути. В Windows максимальная длина пути — 260 символов. Если ваш путь длиннее, используйте префикс \\?\":

ДлинныйПуть = "\\?\C:\ОченьДлинныйПуть\...\файл.txt";
ИмяФайла = СтрЗначениеПути(ДлинныйПуть);

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

Проверьте, не содержит ли путь пробелов в конце или некорректных символов (например, |, ?, *). Используйте СокрЛП() для удаления пробелов и СтрЗаменить() для очистки от запрещённых символов.

5. Получение имени файла на сервере и в тонком клиенте

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

На сервере (в модуле объекта или менеджера):

Функция ПолучитьИмяФайлаНаСервере(ПолныйПуть)
Возврат СтрЗначениеПути(ПолныйПуть);
КонецФункции;

В тонком клиенте:

🖥️ Используйте ФайловыйДиалог — он работает и в тонком клиенте.
📂 Для операций с файлами применяйте HTTPСервис или FTPСоединение, если нужна работа с удалёнными файлами.
⚙️ Для локальных файлов пользователя запросите путь через диалог и обрабатывайте его на клиенте.

Критическое замечание: в тонком клиенте невозможно напрямую прочитать файловую систему сервера или другого клиента. Все операции с локальными файлами пользователя должны инициализироваться через клиентский код.

⚠️ Внимание: При работе в веб-клиенте доступ к локальным файлам пользователя ограничен браузером. Используйте загрузку через &НаКлиенте процедуры с элементами формы ПолеФайла.

6. Практические примеры: отчёты, обмен данными, логи

Рассмотрим реальные сценарии, где требуется работа с именами файлов:

Пример 1: Сохранение отчёта с динамическим именем

&НаКлиенте
Процедура СохранитьОтчет(Отчет)
Диалог = Новый ФайловыйДиалог(РежимФайловогоДиалога.Сохранение);
Диалог.Заголовок = "Сохранить отчет";
Диалог.Фильтр = "PDF файлы (.pdf)|.pdf";
Диалог.ИмяФайла = "Отчет_" + Формат(ТекущаяДата(), "ДФ=ddMMyyyy") + ".pdf";
Если Диалог.Выбрать() Тогда
Отчет.Сохранить(Диалог.ПолноеИмяФайла);
Сообщить("Отчет сохранен как: " + Диалог.ИмяФайла);
КонецЕсли;
КонецПроцедуры;

Пример 2: Логирование с указанием имени файла

Функция ЗаписатьВЛог(Сообщение, ИмяФайлаЛога = "log.txt")
ПутьКЛогу = КаталогВременныхФайлов() + ИмяФайлаЛога;
Текст = Новый ЗаписьТекста(ПутьКЛогу, КодировкаТекста.UTF8, Истина);
Текст.ЗаписатьСтроку(Формат(ТекущаяДата(), "ДФ=dd.MM.yyyy HH:mm:ss") + " | " + Сообщение);
Текст.Закрыть();
Возврат СтрЗначениеПути(ПутьКЛогу); // Возвращаем имя лога
КонецФункции;

Пример 3: Обработка архива с извлечением имён файлов

Процедура ОбработатьАрхив(ПутьКАрхиву)
ZIP = Новый ЧтениеZIPФайла(ПутьКАрхиву);
Пока ZIP.ПрочитатьФайл() Цикл
ИмяФайла = ZIP.ИмяФайлаВнутриАрхива;
Сообщить("Обрабатывается файл: " + ИмяФайла);
// Далее можно извлечь файл или проанализировать имя
КонецЦикла;
КонецПроцедуры;

☑️ Проверка перед работой с файлами

Убедиться, что путь не пустойПроверить существование файла через Новый Файл(Путь).Существует()Обработать исключения с помощью Попытка...ИсключениеУчесть кросс-платформенность (разделители путей \" или /")

Выполнено: 0 / 4

7. Альтернативные подходы: регулярные выражения и внешние компоненты

Если встроенных функций 1С недостаточно, можно использовать:

🔄 Регулярные выражения: для сложного разбора имён (например, извлечение даты из имени "Отчет_2026-05-15.xlsx").
🛠️ Внешние компоненты: например, .NET-библиотеки через COMОбъект для работы с файловой системой.
📦 HTTP-запросы: если файлы хранятся на удалённом сервере, имя можно получить из заголовков ответа.

Пример с регулярными выражениями:

Текст = "Отчет_2026-05-15_data.xlsx";
Регулярка = Новый РегулярноеВыражение("Отчет_(\d{4}-\d{2}-\d{2})");
РезультатПоиска = Регулярка.Поиск(Текст);
Если РезультатПоиска.Найдено Тогда
ДатаИзИмени = РезультатПоиска.ПолучитьГруппу(1).Значение; // "2026-05-15"
КонецЕсли;

Для работы с Cloud Storage (например, Yandex Disk или Google Drive) можно использовать HTTPСоединение:

HTTP = Новый HTTPСоединение("cloud.example.com");
Запрос = Новый HTTPЗапрос("/api/files/info?id=123");
Ответ = HTTP.Получить(Запрос);
ИмяФайла = JSON.Прочитать(Ответ.ПолучитьТелоКакСтроку()).name;

⚠️ Внимание: При использовании внешних компонент убедитесь, что они поддерживаются вашей версией 1С:Предприятие и разрядностью платформы (x86 или x64). Некоторые библиотеки могут требовать регистрации в системе.

8. Оптимизация и безопасности при работе с файлами

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

🔒 Права доступа: ограничьте доступ к чувствительным файлам через настройки ОС или 1С.
🗑️ Временные файлы: всегда очищайте их после использования, особенно на сервере.
⚡ Производительность: при работе с тысячами файлов используйте асинхронные операции или фоновые задания.

Пример безопасного удаления временных файлов:

Процедура ОчиститьВременныеФайлы(МассивПутей)
Для Каждого Путь Из МассивПутей Цикл
Попытка
УдалитьФайлы(Путь);
Исключение
ЗаписатьВЛог("Ошибка удаления файла: " + Путь + " | " + ОписаниеОшибки());
КонецПопытки;
КонецЦикла;
КонецПроцедуры;

Для защиты от инъекций путей (например, если имя файла формируется из пользовательского ввода) всегда проверяйте символы:

Функция БезопасноеИмяФайла(Имя)
ЗапрещенныеСимволы = "|\/?*:<>""";
Для Сч = 1 По СтрДлина(ЗапрещенныеСимволы) Цикл
Имя = СтрЗаменить(Имя, Сред(ЗапрещенныеСимволы, Сч, 1), "_");
КонецЦикла;
Возврат Имя;
КонецФункции;

💡

Всегда валидируйте имена файлов, полученные от пользователей. Злоумышленник может попытаться подсунуть путь вида "../../../etc/passwd" для доступа к системным файлам.

FAQ: Частые вопросы по работе с именами файлов в 1С

Как получить имя файла без расширения?

Используйте комбинацию СтрЗначениеПути() и Лев() с Найти():

ИмяСРасширением = СтрЗначениеПути("C:\Temp\file.txt");
ИмяБезРасширения = Лев(ИмяСРасширением, Найти(ИмяСРасширением, ".") - 1);

Если в имени несколько точек (например, "file.tar.gz"), используйте СтрРазделить() по точке и берите первую часть.

Почему СтрЗначениеПути() возвращает пустую строку?

Это происходит в трёх случаях:

Путь заканчивается разделителем (например, "C:\Temp\"). Удалите последний символ.
Путь пустой или содержит только разделители.
В пути используются некорректные символы (например, | или *).

Проверьте путь через Сообщить(Путь) перед вызовом функции.

Как получить список файлов в папке с их именами?

Используйте НайтиФайлы():

Маска = "C:\Temp\*.xlsx";
Файлы = НайдиФайлы(Маска);
Для Каждого Файл Из Файлы Цикл
Сообщить(СтрЗначениеПути(Файл.ПолноеИмя));
КонецЦикла;

Для рекурсивного поиска (включая подпапки) используйте ПолучитьФайлы() с флагом Рекурсия = Истина.

Можно ли получить имя файла, открытого в 1С через "Файл → Открыть"?

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

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

Как работать с именами файлов в Linux-версии 1С?

В Linux разделитель путей — "/", а не "\". Используйте:

СтрЗаменить(Путь, "\", "/") для унификации разделителей.
Функцию КаталогВременныхФайлов() — она корректно работает в обеих ОС.

Для проверки существования файла используйте:

Файл = Новый Файл(Путь);
Если Файл.Существует() Тогда
// Обработка
КонецЕсли;

Получение имени файла в 1С: все методы от простого к сложному