К статье
Практический материал

Разработка и Конфигурация · 9 мин

Как редактировать файл в 1С

Как открыть и отредактировать файл в 1С: внешние обработки, файлы конфигурации, макеты, текстовые файлы и табличные документы. Пошаговые инструкции и типичные ошибки.

Формулировка «отредактировать файл в 1С» объединяет сразу несколько разных задач: открыть внешнюю обработку или отчёт (.epf, .erf), внести правки в файл конфигурации (.cf), поправить текстовый файл или XML прямо из программы, изменить табличный документ (.mxl) или макет печатной формы. Для каждого случая инструменты и порядок действий отличаются, и ошибка на старте — например, попытка открыть .epf через конфигуратор как конфигурацию — приводит к сообщениям об ошибке формата.

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

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

Определяем тип файла перед редактированием

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

РасширениеЧто этоГде редактировать
.epfВнешняя обработкаКонфигуратор (Файл → Открыть) или запуск в режиме Предприятия
.erfВнешний отчётКонфигуратор или режим Предприятия
.cfФайл конфигурацииТолько конфигуратор через «Загрузить конфигурацию из файла»
.dtВыгрузка информационной базыНе редактируется, только загружается в конфигураторе
.mxlТабличный документРедактор табличных документов (Файл → Открыть)
.txt, .xml, .json, .bslТекстовые файлы и кодВстроенный текстовый редактор или модуль в конфигураторе

Файлы .dt редактировать нельзя в принципе — это бинарная выгрузка базы целиком, её можно только загрузить в пустую базу. Попытки внести правки сторонними утилитами гарантированно разрушают файл.

Редактирование внешней обработки или отчёта (.epf, .erf)

Это самая частая задача. Чтобы изменить код или форму внешней обработки, откройте конфигуратор любой базы (конфигурация базы при этом не затрагивается), затем выберите «Файл → Открыть» и укажите файл .epf или .erf. Откроется структура обработки: модули, формы, макеты — как у обычного объекта конфигурации.

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

Если обработка на поддержке у поставщика

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

Порядок действий с .epf
  1. 1
    Скопируйте файл .epf в отдельную папку как резервную копию
  2. 2
    Откройте конфигуратор любой базы, затем «Файл → Открыть» и выберите файл
  3. 3
    Внесите правки в модуль, форму или макет
  4. 4
    Сохраните файл через «Файл → Сохранить»
  5. 5
    Запустите обработку в режиме Предприятия и проверьте изменённый сценарий

Редактирование текстовых файлов и кода из 1С

Платформа умеет открывать и редактировать обычные текстовые файлы прямо в режиме Предприятия: «Файл → Открыть» и выбор файла .txt, .xml, .csv или .bsl откроет встроенный текстовый редактор. Это удобно для быстрого просмотра файлов обмена, логов или выгрузок без переключения во внешние программы.

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

Программно текстовые файлы читаются и пишутся объектами ЧтениеТекста и ЗаписьТекста. При записи важно явно указывать кодировку — иначе файл, созданный в UTF-8, может быть прочитан другой системой в ANSI, и кириллица превратится в нечитаемые символы.

bsl
Текст = Новый ЗаписьТекста("C:\Обмен\result.txt", КодировкаТекста.UTF8);
Текст.ЗаписатьСтроку("Строка данных");
Текст.Закрыть();

Редактирование табличных документов и макетов (.mxl)

Файлы .mxl — это сохранённые табличные документы: печатные формы, отчёты, прайсы. Открываются они в режиме Предприятия через «Файл → Открыть». Редактирование похоже на работу в электронных таблицах: можно менять текст в ячейках, форматирование, ширину колонок, добавлять строки.

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

Макеты печатных форм внутри конфигурации или внешней обработки редактируются в конфигураторе: откройте объект, перейдите на закладку «Макеты», откройте нужный макет и измените области, параметры и оформление. Помните, что текст в ячейках макета с типом «Параметр» подставляется из кода — правка такого макета без анализа модуля может сломать заполнение.

Работа с файлом конфигурации (.cf)

Файл .cf — это полная конфигурация в виде одного файла. Напрямую «открыть и поправить» его нельзя: правильный путь — загрузить его в пустую или тестовую базу через конфигуратор («Конфигурация → Загрузить конфигурацию из файла»), внести изменения в структуру и модули, а затем при необходимости выгрузить обратно («Конфигурация → Сохранить конфигурацию в файл»).

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

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

После любых правок проверьте результат в контролируемом порядке: сначала синтаксическая проверка модуля в конфигураторе («Конфигурация → Проверка конфигурации» или кнопка проверки в редакторе модуля), затем запуск в тестовой базе, и только потом перенос в рабочую среду.

Типичные ошибки
01
Редактирование файла без резервной копии — после сохранения отменить изменения невозможно
02
Правка типовой конфигурации напрямую вместо расширения — изменения теряются при обновлении
03
Запись текстового файла без указания кодировки — кириллица ломается в сторонних программах
04
Загрузка .cf в рабочую базу без выгрузки .dt — при ошибке базу можно потерять
05
Попытка открыть .epf как конфигурацию — конфигуратор выдаёт ошибку формата, нужно «Файл → Открыть»
Контрольные точки

Как проверить результат

Синтаксис модуля
Норма

Проверка конфигурации завершается без ошибок

Тревожный признак

Сообщения об ошибках в окне служебных сообщений

Запуск обработки
Норма

Обработка открывается и выполняет изменённый сценарий

Тревожный признак

Ошибка при открытии формы или выполнении кода

Текстовый файл после записи
Норма

Файл открывается в сторонней программе, кириллица читается

Тревожный признак

Кракозябры — несовпадение кодировок

Печатная форма
Норма

Параметры заполняются, форматирование не разъехалось

Тревожный признак

Пустые поля вместо данных — повреждены имена параметров

Часто задаваемые вопросы

Можно ли редактировать файл .epf без конфигуратора?

Нет. Изменить код, формы и макеты внешней обработки можно только в конфигураторе. В режиме Предприятия файл .epf можно лишь запустить на выполнение через «Файл → Открыть».

Чем открыть файл .mxl без 1С?

Формат .mxl — проприетарный, сторонние табличные редакторы его не читают. Варианты: открыть в 1С и сохранить как Excel (.xlsx) или PDF через «Файл → Сохранить копию», после чего редактировать в соответствующей программе.

Почему конфигуратор выдаёт ошибку при открытии .epf?

Чаще всего файл открывают не тем способом (например, через «Загрузить конфигурацию из файла») или обработка создана в более новой версии платформы, чем установлена у вас. Обновите платформу и открывайте файл именно через «Файл → Открыть».

Как изменить печатную форму, не трогая конфигурацию?

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

Безопасно ли править файлы обмена (XML) вручную?

Только если вы понимаете структуру файла: лишний или удалённый тег делает XML невалидным, и загрузка завершится ошибкой. Перед правкой сохраните копию, после правки проверьте файл на небольшом объёме данных в тестовой базе.

Итог

Что важно запомнить

Определите тип файла по расширению и выберите правильный инструмент: конфигуратор для .epf/.erf/.cf, встроенные редакторы для текстов и .mxl. Перед правками всегда делайте копию, а загрузку .cf в рабочую базу — только после резервной выгрузки. Проверяйте результат синтаксической проверкой и запуском в тестовой базе.