Новая версия обработки пришла файлом: как поставить её вместо старой
Содержание
Чтобы обновить внешнюю обработку
в 1С, сначала выясните, как она подключена. Если её открывают через Файл → Открыть, достаточно заменить файл .epf на новый. Если она зарегистрирована в программе, откройте Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки, найдите её карточку, загрузите новый файл и запишите карточку. Если обработка встроена в конфигурацию, правка идёт через Конфигуратор с обновлением конфигурации базы.
Ошибка в выборе способа — главная причина жалоб «обновил, а ничего не поменялось». Пользователь кладёт новый файл в папку, а программа продолжает запускать старую копию, сохранённую внутри базы. Ниже — как определить свой случай, правильно подготовиться и сделать замену без сюрпризов.
Как понять, каким способом подключена обработка
В 1С 8.3 одна и та же обработка может «жить» в трёх местах. От этого зависит, где её обновлять.
| Способ подключения | Как её запускают | Где хранится код | Как обновлять |
|---|---|---|---|
| 📄 Внешний файл | Файл → Открыть, выбор файла .epf или .erf | В файле на диске | Заменить файл |
| 🗂️ Дополнительная обработка | Команда в разделе, кнопка «Печать», «Заполнить» в документе | Внутри информационной базы | Загрузить новый файл в карточку |
| 🧩 Объект конфигурации | Пункт меню, который есть «сам по себе» | В конфигурации | Через Конфигуратор или расширение |
Быстрые признаки, по которым определяется тип:
- 🔍 Печатная форма появилась в меню «Печать» документа — почти всегда это дополнительная обработка из справочника. Типовые печатные формы файлом не поставляются.
- 🔍 Обработку каждый раз ищут на диске — это внешний файл. Обновлять нужно его, и только его.
- 🔍 Обработка есть в дереве конфигурации в Конфигураторе, в ветке «Обработки», — она встроенная.
- 🔍 Её нет ни там, ни там, но команда в разделе есть — проверьте расширения:
Администрирование → Печатные формы, отчеты и обработки → Расширения. Доработка могла прийти расширением (.cfe), и тогда обновляется именно оно.
old_ИмяОбработки.epf, чтобы можно было вернуться.Подготовка к обновлению обработки: что сделать до замены
Обработка — это код, который читает и меняет данные базы. Новая версия может по-другому заполнять документы или иначе считать суммы. Поэтому подготовка занимает пять минут, а экономит часы.
- Сохраните старую версию. Для внешнего файла — просто копия
.epf. Для дополнительной обработки откройте карточку и выгрузите текущий файл на диск командой выгрузки в файл. Это ваш откат. - Запишите номер текущей версии. В карточке дополнительной обработки есть поле «Версия». Разработчик заполняет его в коде обработки. Если номер не изменился после загрузки, вы, возможно, загрузили не тот файл.
- Прочитайте описание изменений от разработчика. Особенно ищите слова «требуется обновление конфигурации», «новые разрешения», «изменён формат настроек».
- Проверьте версию платформы. Узнайте свою через
Справка → О программе. Если разработчик пишет «для платформы не ниже такой-то», а у вас старее, обновите платформу сначала. - Сделайте копию базы, если обработка массово меняет данные: перепроводит, перезаполняет, загружает документы. В Конфигураторе:
Администрирование → Выгрузить информационную базу, получите файл.dt.
Для встроенных в конфигурацию обработок копия базы обязательна. Без файла .dt не начинайте обновление конфигурации. Если что-то пойдёт не так, откатить структуру базы иначе нельзя.
💡 Удобно хранить все версии файлов в одной папке с датой в имени: 2026-10-07_ЗагрузкаВыписки_v2.3.epf. Через полгода вы точно вспомните, что и когда ставили.
Обновление внешней обработки, которую открывают из файла
Самый простой случай. Программа читает файл с диска при каждом открытии, поэтому обновление — это замена файла.
Порядок действий
- Попросите пользователей закрыть обработку. Открытая форма продолжит работать со старым кодом до закрытия.
- Переименуйте старый файл, например добавьте к имени
_old. - Положите новый файл в ту же папку под тем же именем, которым пользуются люди. Если путь прописан в ярлыке или в избранном, менять ничего не придётся.
- Откройте обработку через
Файл → Открытьи проверьте версию или заметное изменение.
Если файл лежит на сетевом диске
Общая папка удобна: обновили один раз — получили все. Но есть нюансы:
- 🔒 Файл может быть занят. Windows не даст перезаписать
.epf, пока его держит открытый сеанс у кого-то из коллег. Закройте сеансы или подождите. - 🔒 У пользователей должно быть право на чтение папки. Права на запись им не нужны.
- 🔒 Сервер 1С в клиент-серверном варианте тоже должен «видеть» файл, если обработка создаётся на сервере по пути. Сетевой путь лучше указывать в формате
\\server\share\..., а не буквой диска: буквы дисков у службы сервера 1С обычно не подключены.
💡 Если после замены всё равно запускается старая версия, закройте 1С полностью и откройте снова. Помогает и запуск с параметром /ClearCache, который очищает кеш клиента.
Обновление дополнительной обработки в справочнике программы
В типовых конфигурациях на современной платформе (Бухгалтерия 3.0, ЗУП 3, УТ 11 и другие на БСП) внешние печатные формы, заполнения и обработки чаще всего регистрируют в справочнике. Код хранится внутри базы. Новый файл, положенный в папку, на работу программы никак не влияет.
Путь к справочнику:
- Бухгалтерия 3.0, ЗУП 3:
Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки. - УТ 11, КА 2, ERP:
НСИ и администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки.
Если ссылки нет, в том же разделе включите флажок «Дополнительные отчеты и обработки».
Пошагово
- Найдите обработку в списке. Удобнее всего — поиском по названию в строке поиска списка.
- Откройте карточку двойным щелчком.
- Выгрузите текущую версию в файл, если ещё не сделали этого на этапе подготовки.
- Выберите команду загрузки из файла (обычно кнопка «Загрузить из файла…» в карточке) и укажите новый
.epfили.erf. - Сверьте поля «Версия» и «Информация»: они должны смениться на значения новой версии.
- Проверьте вкладку команд и размещение: в какие разделы и документы встроена обработка. Новая версия может добавить команды, и их нужно включить.
- Нажмите «Записать и закрыть».
Не создавайте новую карточку вместо обновления старой. Получите две одинаковые команды «Печать» и путаницу у пользователей. Кроме того, в старой карточке остаются настройки размещения, быстрого доступа и списка пользователей — в новой их придётся задавать заново.
Как пользователи получат новую версию
Программа подключает дополнительную обработку из базы в момент вызова команды. На практике надёжнее попросить пользователей перезапустить 1С после обновления, особенно если обработка была открыта в момент загрузки.
Режим отладки вместо загрузки
В карточке есть поле «Публикация». Значение «Используется» — обычная работа. Режим отладки нужен разработчику: он позволяет проверять обработку, не трогая рабочую версию у всех пользователей. Бухгалтеру при обновлении менять это поле не нужно. Если команда вдруг пропала у пользователей, проверьте, не стоит ли там «Отключена».
Обновление обработки, встроенной в конфигурацию
Если обработка — объект конфигурации, «загрузить файлик» не получится. Нужен Конфигуратор и монопольный доступ к базе.
Вариант 1. Замена объекта из внешнего файла
В Конфигураторе можно заменить встроенную обработку содержимым внешней:
- Сделайте копию базы (
.dt) и сохраните конфигурацию в файл:Конфигурация → Сохранить конфигурацию в файл. - Откройте конфигурацию:
Конфигурация → Открыть конфигурацию. - В дереве найдите обработку в ветке «Обработки».
- Щёлкните её правой кнопкой и выберите команду замены на внешнюю обработку. Укажите новый файл.
- Выполните
Конфигурация → Обновить конфигурацию базы данных(клавишаF7) и примите изменения.
Команда замены доступна, только если конфигурацию разрешено изменять. Если типовая конфигурация стоит на полной поддержке без возможности изменений, сначала придётся включить возможность изменения. Это меняет порядок будущих обновлений, поэтому решение принимает тот, кто сопровождает базу.
Вариант 2. Через расширение
Для типовых конфигураций правильнее держать доработки в расширениях (.cfe, механизм есть с платформы 8.3.6). Тогда обновление выглядит так:
- Откройте список расширений: в режиме 1С:Предприятие через раздел администрирования «Печатные формы, отчеты и обработки → Расширения», или в Конфигураторе через
Конфигурация → Расширения конфигурации. - Выделите нужное расширение и загрузите новую версию из файла.
- Перезапустите сеансы пользователей: расширение применяется при новом входе в программу.
Что учесть при обновлении типовой конфигурации
Встроенная доработка конфликтует с обновлениями от 1С. При очередном релизе её придётся переносить через сравнение и объединение конфигураций. Дополнительные обработки из справочника и расширения такого переноса не требуют. Если вы обновляете доработку и всё равно трогаете её — подумайте о переносе в расширение или дополнительную обработку.
| Где лежит доработка | Сложность обновления | Конфликт с релизами 1С |
|---|---|---|
| Внешний файл | Минимальная | Нет |
| Справочник дополнительных обработок | Низкая | Нет, но код может устареть |
| Расширение | Средняя | Редко, проверяется при обновлении |
| Объект конфигурации | Высокая | Да, при каждом обновлении |
Права доступа, безопасный режим и лицензии после обновления
Новая версия может требовать больше, чем старая. Именно здесь возникают сюрпризы вида «у администратора работает, у бухгалтера — нет».
Права пользователей
- 👤 Открытие внешних файлов. Чтобы запустить
.epfчерезФайл → Открыть, у пользователя должно быть право интерактивного открытия внешних обработок. В типовых конфигурациях его выдают отдельной ролью или профилем с названием вроде «Открытие внешних отчетов и обработок». Без него программа выдаётНарушение прав доступа!. - 👤 Дополнительные обработки этого права не требуют. Для них важно, кому разрешена команда в карточке и есть ли у пользователя права на сами документы, с которыми работает обработка.
Защита от опасных действий
Начиная с релизов платформы 8.3.9–8.3.10 при открытии внешнего файла появляется предупреждение безопасности. Пользователь подтверждает, что доверяет файлу. Флажок «Защита от опасных действий» задаётся в свойствах пользователя в Конфигураторе: Администрирование → Пользователи. Снимать его всем подряд не стоит: предупреждение защищает от запуска чужого кода.
Безопасный режим и разрешения
Дополнительные обработки в БСП обычно выполняются в безопасном режиме. Если новой версии нужно больше: работа с файлами на диске, обращения в интернет, внешние компоненты, — разработчик указывает запрашиваемые разрешения. При загрузке программа покажет их список, и администратор должен их подтвердить. Не подтвердили — обработка будет падать на первой же операции, требующей доступа.
Лицензии платных обработок
Платные обработки защищают по-разному: системой лицензирования (СЛК), ключом от разработчика, привязкой к ИНН организации. Что проверить после обновления:
- 🔑 Действует ли подписка на обновления. Часто новая версия работает только при оплаченном периоде.
- 🔑 Нужна ли повторная активация ключа на этом компьютере или сервере.
- 🔑 Не требует ли новая версия свежего компонента защиты, который устанавливается отдельно.
Обходить защиту не нужно и опасно: подменённый код в обработке получает доступ ко всей базе. Если лицензия «слетела» — пишите разработчику, это стандартная поддержка.
Ошибки после обновления обработки и что с ними делать
Симптомы повторяются от базы к базе. Таблица поможет сузить поиск.
| Что видно | Вероятная причина | Что проверить |
|---|---|---|
| Работает старая версия | Обновили файл на диске, а обработка из справочника; или сеанс не перезапущен | Тип подключения, поле «Версия» в карточке, перезапуск 1С |
Нарушение прав доступа! при открытии файла | Нет права на открытие внешних обработок | Роли и профиль пользователя |
| Файл не открывается, сообщение о формате или версии | Обработка сохранена в более новой платформе | Версия платформы у вас и у разработчика |
| Форма не открывается в тонком клиенте или веб-клиенте | В обработке обычная, а не управляемая форма | Попросить у разработчика версию с управляемой формой |
| Ошибка при загрузке в справочник | В файле нет описания для регистрации как дополнительной обработки | Это обычный внешний файл: открывайте через меню «Файл» или запросите у разработчика версию для справочника |
| Падает на операции с файлами или интернетом | Не выданы разрешения безопасного режима | Повторно загрузить файл и подтвердить разрешения |
| Пропала команда «Печать» | Сбилось размещение или публикация отключена | Вкладку размещения и поле «Публикация» в карточке |
| Ошибка обращения к реквизиту или объекту | Обработка написана под другой релиз конфигурации | Номер релиза конфигурации в Справка → О программе, требования разработчика |
Последний случай самый частый у купленных обработок. Разработчик обновил её под новый релиз Бухгалтерии, а у вас конфигурация не обновлялась полгода. Тогда порядок такой: сначала обновить конфигурацию, потом обработку. Либо попросить у автора версию под ваш релиз.
Как откатиться
- ↩️ Внешний файл — верните переименованный старый файл на место.
- ↩️ Дополнительная обработка — загрузите в ту же карточку файл, выгруженный перед обновлением.
- ↩️ Встроенная обработка — загрузите сохранённую конфигурацию или, если пострадали данные, базу из
.dt.
Если обработка массово изменила документы неправильно, откат файла данные не вернёт. Поможет только копия базы, сделанная до запуска. Поэтому для обработок, которые что-то перепроводят или перезаполняют, первый запуск после обновления делайте на копии базы.