Переименование файлов в 1С: внешние обработки, макеты и вложения
Содержание
Слово «файл» в 1С означает три разные вещи: файл внешней обработки или отчёта на диске, макет печатной формы внутри конфигурации и вложение в карточке документа. Переименовывают их по-разному, и перепутать способ легко. Сначала определите, что именно у вас: от этого зависит, где менять имя.
Короткое правило такое. Файл .epf или .erf переименовывается средствами Windows, но имя внутри него остаётся прежним. Макет переименовывается в Конфигураторе. Вложение переименовывается в его собственной карточке прямо в программе пользователя.
Что вы переименовываете: быстрая сверка
Прежде чем что-то менять, посмотрите в таблицу.
| Объект | Где хранится | Где менять имя | Нужен ли Конфигуратор |
|---|---|---|---|
| Внешняя обработка или отчёт | Файл .epf / .erf на диске или в справочнике дополнительных обработок | Проводник и карточка в справочнике | Только для внутреннего имени |
| Макет печатной формы | Внутри конфигурации | Свойства макета, поле «Имя» | Да |
| Вложение в документе | В базе или в томе хранения файлов | Карточка файла, поле «Наименование» | Нет |
| Файл на сервере (том хранения) | Каталог на диске сервера | Только через программу | Нет |
Если база рабочая, сначала сделайте её копию. Ошибка в имени макета ломает печатную форму у всех пользователей сразу.
Для копии откройте Конфигуратор и выберите Администрирование → Выгрузить информационную базу. Получится файл .dt, из которого базу можно восстановить.
Внешняя обработка и внешний отчёт
У внешней обработки два имени. Первое — имя файла на диске, например Загрузка_остатков.epf. Второе — внутреннее «Имя» и «Синоним», которые заданы в метаданных самой обработки. Это независимые вещи.
Если переименовать файл в Проводнике, 1С откроет его без проблем. Пользователь увидит старый синоним в заголовке окна. Для большинства случаев этого достаточно.
Когда нужно изменить и внутреннее имя:
- Откройте файл через
Файл → Открытьв Конфигураторе. - Выделите корень обработки в дереве объектов.
- В палитре свойств измените «Имя» (без пробелов, не с цифры) и «Синоним» (любой читаемый текст).
- Сохраните командой
Файл → Сохранить какпод новым именем файла.
Старый файл не удаляйте сразу. Оставьте его в отдельной папке, пока не убедитесь, что новая версия открывается и работает.
Если обработка подключена через справочник
Часто внешние обработки не лежат на диске, а подключены через справочник «Дополнительные отчёты и обработки». Тогда файл уже загружен в базу. Переименование на диске ничего не изменит.
Порядок такой:
- откройте карточку обработки в справочнике;
- поменяйте «Наименование» — оно показывается в списках и меню команд;
- если нужно заменить сам файл, выберите загрузку из файла и укажите новый
.epf; - проверьте, что команды обработки по-прежнему доступны в нужных разделах.
Наименование в карточке влияет только на то, как обработка выглядит в интерфейсе. На работу кода оно не влияет.
Макеты и печатные формы
Макет печатной формы живёт внутри конфигурации. Файла на диске у него нет, поэтому «переименовать файл» здесь значит изменить свойство «Имя» у объекта метаданных.
Для этого:
- Откройте конфигурацию в Конфигураторе.
- В дереве найдите объект (документ, справочник, обработку) и раскройте ветку «Макеты».
- Выделите макет и откройте палитру свойств.
- Измените поле «Имя». Синоним можно менять независимо.
Главная опасность — код, который обращается к макету по имени. Типичный вызов выглядит так:
Макет = ПолучитьМакет("СтарыйМакет");
Если имя в метаданных поменяли, а в модуле оставили прежнее, форма перестанет открываться с ошибкой. Конфигуратор не всегда исправляет такие строки сам, поэтому проверьте вручную.
💡 Найти все обращения поможет поиск по конфигурации: Правка → Найти в конфигурации (или сочетание клавиш для глобального поиска). Введите старое имя в кавычках и пройдите по всем найденным модулям.
Отдельно учтите, что у типовых конфигураций макеты находятся на поддержке. Правка типового макета отключает его от автоматического обновления. Более безопасный путь: создать копию макета со своим именем и подключить её, а типовой оставить как есть.
Расширения
Если печатная форма доработана через расширение конфигурации , имя макета в расширении должно быть уникальным. Менять имя заимствованного объекта в расширении нельзя: оно привязано к исходному объекту основной конфигурации. Для новой формы создавайте собственный макет.
Вложения в документах и справочниках
Здесь переименование самое простое, и Конфигуратор не нужен. Вложение — это запись в программе: у неё есть наименование и расширение.
Как переименовать:
- Откройте документ или элемент справочника.
- Перейдите к списку присоединённых файлов. Обычно это значок скрепки или ссылка «Файлы» в форме объекта.
- Откройте нужный файл двойным щелчком или командой «Изменить».
- В карточке поменяйте «Наименование» и запишите.
Расширение (.pdf, .xlsx) в наименование включать не нужно: оно хранится отдельно. Если написать его дважды, при выгрузке получится имя вроде Акт.pdf.pdf.
Что нужно знать:
- изменить файл может только пользователь с правом редактирования вложений; без него поле будет недоступно;
- если файл взят «на редактирование» другим пользователем, сначала его нужно освободить;
- смена наименования не затрагивает содержимое и дату загрузки.
Пользуйтесь понятными именами по схеме «дата — контрагент — тип документа». Через год это сэкономит время при поиске.
Массовое переименование
Когда вложений много, ручной способ не годится. Есть три рабочих варианта.
| Способ | Когда подходит | Риск |
|---|---|---|
| Групповое изменение через «Ещё → Изменить выделенные…» | Нужно одно значение для всех выбранных | Низкий |
| Типовая обработка группового изменения реквизитов | Нужно сменить поле у отбора записей | Средний |
| Своя внешняя обработка с запросом | Имя меняется по правилу (префикс, замена) | Высокий |
Для простого случая выделите записи в списке файлов, откройте меню «Ещё» и поищите команду изменения выделенных элементов. Не везде она есть: набор команд зависит от конфигурации и прав.
Если имя нужно менять по правилу, пишут обработку. Идея простая: выбрать нужные файлы запросом, для каждого получить объект, изменить наименование и записать. Пример шаблона цикла:
Для Каждого Ссылка Из МассивСсылок Цикл
Объект = Ссылка.ПолучитьОбъект();
Объект.Наименование = "Акт_" + Объект.Наименование;
Объект.Записать();
КонецЦикла;
Имя справочника с файлами зависит от конфигурации, поэтому подставьте свой. Перед запуском на рабочей базе прогоните обработку на копии и сверьте результат на десяти-двадцати записях.
Никогда не запускайте массовую запись без копии базы. Откатить её по одной записи будет нечем.
Ограничения платформы
Ограничения зависят от типа объекта.
Метаданные (макеты, обработки, реквизиты). Имя — это идентификатор. Оно не может начинаться с цифры, не допускает пробелов и большинства спецсимволов. Допустимы буквы, цифры и знак подчёркивания. Длину ограничивает платформа, но практичнее держать имя коротким.
Имя файла на диске. Действуют правила операционной системы. В Windows запрещены символы \ / : * ? " < > |. Для переносимости между системами избегайте пробелов в конце и очень длинных путей.
Вложения. Наименование записи свободное, но при сохранении на диск запрещённые символы будут заменены или вызовут ошибку. Поэтому не используйте в наименованиях косую черту и двоеточие, даже если программа их пропускает.
Права и блокировки. Для правки метаданных нужен доступ в Конфигуратор. Если конфигурация закрыта для изменений или стоит на поддержке без разрешения правки, поле «Имя» не изменится. Для структурных изменений может потребоваться монопольный доступ к базе.
Правку метаданных в рабочей базе делайте вне рабочего времени. Если потребуется перезапуск или монопольный режим, у пользователей оборвутся сеансы.
Как выбрать новое имя, чтобы не переименовывать снова
Переименование обычно возникает из-за того, что исходное имя было случайным: Обработка1, Макет2, скан_новый_финал. Потратьте минуту на схему, и повторная правка не понадобится.
Для обработок и отчётов.
- Пишите назначение, а не действие автора:
ЗагрузкаВыпискиБанка, а неМояОбработка. - Версию выносите в имя файла (
ЗагрузкаВыписки_v2.epf), а внутреннее «Имя» оставляйте стабильным. Тогда код, который ссылается на обработку, не придётся трогать. - Синоним пишите так, как его хочет видеть пользователь: с пробелами и заглавной буквы.
Для макетов.
- Имя макета отражает форму:
ПФ_Накладная,ПФ_АктСверки. Префикс помогает быстро найти печатные формы в дереве. - Для нескольких вариантов одной формы добавляйте суффикс:
ПФ_Накладная_Кратко.
Для вложений.
- Начинайте имя с даты в формате год-месяц-день: такие файлы сами выстраиваются по порядку при сортировке по наименованию.
- Указывайте контрагента и тип документа, например
2026-09-15 Ромашка акт сверки. - Не используйте слова «новый», «финал», «исправленный»: через месяц их не отличить друг от друга.
Типичные промахи при переименовании
- Меняют имя файла на диске и ждут, что изменится название в меню. Меню берёт название из справочника или синонима, а не из имени файла.
- Правят «Имя» макета в рабочей базе, не проверив код. Печатная форма перестаёт открываться у всех.
- Переименовывают вложение, но забывают, что на него ссылается внешняя таблица или обработка выгрузки по прежнему наименованию. Если у вас есть такая выгрузка, обновите правило отбора.
- Запускают массовую обработку без отбора и затрагивают файлы, которые менять не планировали. Всегда добавляйте условие по виду документа или дате.
- Копируют обработку в соседнюю папку «для проверки» и потом открывают не ту версию. Держите одну рабочую копию и один архив.
Безопасный порядок действий на рабочей базе
Единая последовательность подходит для всех трёх случаев. Идите по ней сверху вниз.
Несколько пояснений к пунктам:
- Тестовую копию разворачивают из того же
.dt. Достаточно открыть печатную форму и провести один документ. - Места использования ищите не только в коде. Имя макета может встречаться в настройках печати и в дополнительных обработках.
- После правки проверьте под обычным пользователем, а не только под администратором: у него могут быть другие права.
Если что-то сломалось
Разберите симптом по таблице.
Частые вопросы
Можно ли переименовать файл обработки и ничего больше не менять?
.epf под любым именем. Внутренний синоним останется прежним, и пользователь увидит его в заголовке окна.