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

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

Как сохранить обработку в 1С: полное руководство

Как сохранить внешнюю обработку в 1С 8.3: через конфигуратор и режим предприятия, сохранение в файл epf, в справочник дополнительных обработок, типичные ошибки.

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

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

Что нужно знать перед сохранением обработки

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

Также важно различать тип обработки. Внешняя обработка (.epf) — самостоятельный файл, который можно переносить между базами. Встроенная обработка — часть конфигурации, она сохраняется только вместе с конфигурацией и отдельным файлом не выгружается стандартными средствами. Если вы открыли конфигуратор и не видите обработку в дереве конфигурации — значит, она внешняя и открывается через меню «Файл → Открыть».

Сохранение обработки через конфигуратор

Конфигуратор — основной инструмент для создания и изменения обработок. Чтобы сохранить новую или изменённую обработку, откройте её через меню «Файл → Открыть» (или Ctrl+O), внесите изменения в модуль, форму или макет, затем выберите «Файл → Сохранить» (Ctrl+S). Если обработка новая и ещё не имеет файла, откроется диалог выбора папки и имени — укажите понятное имя без спецсимволов, расширение .epf платформа добавит автоматически.

Если нужно сохранить копию под другим именем или в другую папку, используйте «Файл → Сохранить как». Это удобно при версионировании: например, перед рискованной доработкой сохраните копию с суффиксом версии, чтобы иметь возможность откатиться. Учтите, что после «Сохранить как» вы продолжаете работать уже с новым файлом, а исходный остаётся нетронутым.

Порядок действий в конфигураторе
  1. 1
    Откройте обработку: Файл → Открыть (Ctrl+O), выберите файл .epf
  2. 2
    Внесите изменения в модуль объекта, форму или макет
  3. 3
    Нажмите Файл → Сохранить (Ctrl+S) или «Сохранить как» для копии
  4. 4
    Убедитесь, что в заголовке окна исчез признак несохранённых изменений
  5. 5
    Проверьте файл на диске: дата изменения должна обновиться

Сохранение при синтаксических ошибках

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

Сохранение обработки из режима «Предприятие»

Иногда обработка открыта только в пользовательском режиме — например, её передал коллега, и вы запустили файл через «Файл → Открыть». Чтобы сохранить такой файл в нужное место, в режиме «Предприятие» откройте меню «Файл → Сохранить как» (в некоторых интерфейсах — «Сохранить копию»), укажите папку и имя. Так вы получите копию файла .epf на диске.

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

Добавление обработки в справочник дополнительных обработок

В типовых конфигурациях (Бухгалтерия, Управление торговлей, ERP и других на базе БСП) есть механизм «Дополнительные отчеты и обработки»: файл хранится внутри базы, а запускается из интерфейса как обычный пункт меню. Чтобы сохранить обработку таким способом, откройте раздел «Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки», нажмите «Создать» и выберите файл .epf с диска.

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

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

Способы хранения обработки

Файл .epf на диске

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

Справочник дополнительных обработок

Подходит для постоянной работы в типовой конфигурации: единая версия для всех, запуск из интерфейса. Ограничение: требуется соответствие формату БСП.

Встроенная в конфигурацию

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

Как проверить, что обработка сохранилась корректно

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

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

Контрольные точки

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

Файл на диске
Норма

Дата изменения файла .epf соответствует моменту сохранения

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

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

Повторное открытие в конфигураторе
Норма

Изменения в коде и формах на месте

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

Изменений нет — сохранение не выполнено или записан другой файл

Запуск в режиме Предприятие
Норма

Обработка открывается и выполняется без ошибок

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

Ошибка компиляции модуля — в коде синтаксические ошибки

Типичные ошибки при сохранении обработок

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

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

Типичные ошибки
01
Редактирование файла из временной папки — изменения теряются при очистке временных файлов, сохраняйте копию в постоянный каталог
02
Путаница между «Сохранить» и «Сохранить как» — после «Сохранить как» работа идёт с новой копией, а правки исходного файла прекращаются
03
Загрузка новой версии в справочник без обновления сведений — в карточке остаётся старая версия, пользователи не понимают, что обработка обновлена
04
Сохранение без проверки синтаксиса — файл записывается, но в режиме Предприятие обработка падает с ошибкой компиляции

Ограничения и когда нужен разработчик

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

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

Маршрут решения

Как выбрать действие

Обработка нужна один раз или идёт разработкаХраните как файл .epf на диске, сохраняйте через конфигуратор
Обработкой регулярно пользуются несколько сотрудниковДобавьте её в справочник «Дополнительные отчеты и обработки»
Обработка тесно связана с объектами конфигурацииРассмотрите встраивание в конфигурацию с участием разработчика
Файл получен из недоверенного источникаОткройте в конфигураторе и изучите код до первого запуска
Итог

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

Обработка сохраняется в файл .epf через конфигуратор («Файл → Сохранить») или копируется из режима «Предприятие» через «Сохранить как». Для постоянной работы в типовой конфигурации её добавляют в справочник дополнительных обработок. Перед запуском обработок, изменяющих данные, всегда делайте резервную копию базы.

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

Какое расширение должно быть у файла обработки 1С 8.3?

Внешняя обработка платформы 1С 8 имеет расширение .epf, внешний отчёт — .erf. Файлы с расширением .ert относятся к устаревшей платформе 7.7 и в восьмёрке не открываются без конвертации. Если при сохранении расширение не добавилось автоматически, допишите .epf вручную.

Почему кнопка «Сохранить» неактивна в конфигураторе?

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

Можно ли сохранить обработку, не открывая конфигуратор?

Да, если обработка уже открыта в режиме «Предприятие»: используйте «Файл → Сохранить как», чтобы записать копию файла .epf на диск. Но изменить код или форму без конфигуратора невозможно — режим «Предприятие» предназначен только для выполнения обработок.

Как обновить обработку, уже добавленную в дополнительные обработки?

Откройте карточку элемента справочника «Дополнительные отчеты и обработки» и загрузите новый файл командой загрузки из файла (обычно доступна по кнопке в форме элемента). После записи всем пользователям станет доступна новая версия, менять что-либо у пользователей не потребуется.

Потеряются ли данные базы, если сохранить обработку с ошибкой в коде?

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

Как перенести обработку в другую базу 1С?

Если обработка хранится файлом — просто скопируйте .epf и откройте в другой базе через «Файл → Открыть». Если она добавлена в справочник дополнительных обработок, выгрузите её из карточки элемента в файл, а затем загрузите этот файл в справочник целевой базы.