Как переименовать файл в 1С: инструкция и примеры кода

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

Важно различать два разных сценария. Первый — работа с файлами на диске (локальными или сетевыми) из кода на встроенном языке. Второй — переименование присоединённых файлов, которые хранятся внутри информационной базы через механизм БСП «Работа с файлами». Подходы принципиально разные, и путать их нельзя.

Ниже разобраны оба сценария: синтаксис методов, работа в тонком и веб-клиенте, обработка ошибок, переименование присоединённых файлов и проверка результата. Примеры приведены для актуальных версий платформы 1С:Предприятие 8.3.

Какой сценарий вам нужен: файл на диске или файл в базе

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

Если файл хранится в базе как присоединённый (например, скан договора, прикреплённый к элементу справочника), то у него нет «пути на диске» в привычном смысле. Такой файл существует как элемент служебного справочника, и его имя — это реквизит объекта. Переименование выполняется записью этого объекта, а не файловыми операциями.

Переименование файла на диске методом ПереместитьФайл

Во встроенном языке нет отдельной команды «переименовать». Стандартный приём — метод ПереместитьФайл, где источник и приёмник находятся в одном каталоге, но у приёмника другое имя. Метод работает и на клиенте, и на сервере, что важно учитывать при разработке.

// Переименование файла в том же каталоге
СтароеИмя = "C:\Обмен\выгрузка.xml";
НовоеИмя  = "C:\Обмен\выгрузка_обработана.xml";

ПереместитьФайл(СтароеИмя, НовоеИмя);

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

Файл = Новый Файл(СтароеИмя);
Если Не Файл.Существует() Тогда
ВызватьИсключение "Файл не найден: " + СтароеИмя;
КонецЕсли;

Попытка
ПереместитьФайл(СтароеИмя, НовоеИмя);
Исключение
Сообщить("Не удалось переименовать файл: "
+ ОписаниеОшибки());
КонецПопытки;

ПереместитьФайл("C:\Обмен\старое.xml", "C:\Обмен\новое.xml");

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

Работа в клиент-серверном режиме: где выполняется код

Частая причина «неработающего» переименования — неправильное место исполнения кода. Если код выполняется на сервере 1С, пути интерпретируются относительно сервера, и каталог C:\Обмен — это диск сервера, а не компьютера пользователя. Файл, который пользователь видит у себя, серверу может быть недоступен.

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

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

Пакетное переименование и поиск файлов

Когда нужно переименовать группу файлов по маске (например, все отчёты за период), используют метод НайтиФайлы. Он возвращает массив объектов Файл, по которым удобно пройти циклом и сформировать новые имена.

Найденные = НайтиФайлы("C:\Обмен\", "*.xml");
Для Каждого Файл Из Найденные Цикл
Если Файл.ЭтоКаталог() Тогда
Продолжить;
КонецЕсли;
НовоеИмя = Файл.Путь + "архив_" + Файл.Имя;
ПереместитьФайл(Файл.ПолноеИмя, НовоеИмя);
КонецЦикла;

Объект Файл даёт готовые свойства для разбора имени: Путь (каталог с завершающим слэшем), Имя (имя с расширением), ИмяБезРасширения и Расширение. Это избавляет от ручного разбора строки и ошибок с разделителями.

Переименование присоединённого файла в базе

Присоединённые файлы в типовых конфигурациях на БСП хранятся в справочниках вида «<ИмяОбъекта>ПрисоединенныеФайлы» или в общем справочнике «Файлы». Переименование такого файла — это изменение реквизита Наименование (и при необходимости связанных реквизитов) с последующей записью объекта.

ФайлОбъект = СсылкаНаФайл.ПолучитьОбъект();
ФайлОбъект.Наименование = "Договор_подписанный";
ФайлОбъект.Записать();

В пользовательском режиме переименовать присоединённый файл можно без программирования: откройте карточку файла из списка присоединённых файлов объекта и измените наименование. В ряде конфигураций доступно редактирование имени прямо в списке по клавише F2 или через команду «Изменить».

Расширение файла при переименовании в базе обычно хранится в отдельном реквизите (Расширение), поэтому менять его вместе с наименованием не нужно — иначе файл может перестать открываться штатными средствами просмотра.

Проверка результата и обработка ошибок

После переименования убедитесь, что операция прошла: файл со старым именем отсутствует, а с новым — существует и открывается. Для присоединённых файлов достаточно перечитать объект и проверить наименование, а также попробовать открыть файл на просмотр.

Для журналирования ошибок в регламентных операциях используйте ЗаписьЖурналаРегистрации вместо Сообщить — тогда сведения о сбоях останутся в журнале регистрации и будут доступны администратору даже при фоновом выполнении.

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