Подключаем внешнюю обработку и расширение к базе 1С 8.3

Добавить модуль в 1С можно тремя способами. Разовую обработку открывают через Файл → Открыть. Постоянную подключают в Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки. Расширение конфигурации (.cfe) загружают там же, в пункте «Расширения», или в Конфигураторе через Конфигурация → Расширения конфигурации.

Какой путь выбрать, зависит от того, что вам прислали: файл .epf/.erf — это внешняя обработка или отчёт, файл .cfe — расширение. Правка самой конфигурации нужна редко: она снимает типовую базу с поддержки и усложняет обновления. Инструкция написана для платформы 8.3 с интерфейсом «Такси» и типовых конфигураций на БСП: Бухгалтерия 3.0, ЗУП 3.1, УТ 11.

1. Подготовка: права, версия платформы и резервная копия

Перед подключением любого модуля проверьте три вещи. Это пять минут, но без них дальше будут непонятные отказы.

• 🔑 Права пользователя. Для постоянного подключения обработок и расширений нужна роль «Полные права» или профиль «Администратор». Обычный бухгалтер без настроек этого не сделает.
• 🧩 Номер платформы. Посмотрите его в Справка → О программе (меню с тремя полосками или значок «i» в заголовке окна). Обработка, сохранённая в более новой платформе, может не открыться в старой.
• 💾 Резервная копия. Расширение меняет поведение программы для всех пользователей. Выгрузите базу в .dt (Конфигуратор → Администрирование → Выгрузить информационную базу) или сделайте копию средствами СУБД.

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

2. Как добавить внешнюю обработку в режиме Предприятие

Разовое открытие файла

Подходит, когда обработку нужно запустить один-два раза.

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

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

Постоянное подключение через «Дополнительные отчеты и обработки»

Так подключают печатные формы, обработки заполнения и регламентные задания. После этого команда появляется прямо в нужном документе или разделе.

1. Перейдите в Администрирование → Печатные формы, отчеты и обработки.
2. Установите флажок «Дополнительные отчеты и обработки», если он снят.
3. Откройте ссылку «Дополнительные отчеты и обработки».
4. Нажмите «Добавить из файла…» и выберите .epf или .erf.
5. Подтвердите предупреждение о безопасности.
6. В открывшейся карточке проверьте вид (печатная форма, заполнение объекта, дополнительная обработка и т. д.) — он берётся из самого файла.
7. На вкладке с командами укажите размещение: в какие разделы или документы встроить команду.
8. Задайте пользователей для быстрого доступа, если это глобальная обработка.
9. Нажмите «Записать и закрыть».

Поле «Публикация» в карточке управляет доступностью. Значение «Используется» — команда работает у всех, кому назначена. «Отключена» — обработка остаётся в справочнике, но команда пропадает. Это удобно, когда нужно временно убрать форму без удаления.

Новую версию файла загружают в ту же карточку командой «Загрузить из файла…» в меню «Ещё». Тогда размещение и настройки пользователей сохранятся.

3. Как подключить расширение конфигурации

Расширения появились в платформе 8.3.6. Они дорабатывают типовую конфигурацию без снятия её с поддержки: обновления ставятся как обычно, а изменения живут отдельно.

В режиме Предприятие

1. Откройте Администрирование → Печатные формы, отчеты и обработки → Расширения.
2. Нажмите «Добавить из файла…» и выберите файл .cfe.
3. Подтвердите предупреждение о безопасности.
4. В списке у нового расширения проверьте флажки «Активно» и «Безопасный режим».
5. Перезапустите программу — изменения применяются при следующем входе. Остальным пользователям тоже нужно перезайти.

«Безопасный режим» ограничивает расширению доступ к файлам, внешним компонентам и COM-объектам. Если разработчик пишет, что расширению нужен обмен с внешней системой или запись на диск, флажок придётся снять. Делайте это осознанно и только для проверенного кода.

В Конфигураторе

Этот путь нужен разработчику или когда в Предприятии нет пункта «Расширения».

1. Запустите базу в режиме «Конфигуратор».
2. Меню Конфигурация → Расширения конфигурации.
3. В окне расширений нажмите «Добавить» — появится пустое расширение.
4. Выделите его и через меню «Конфигурация» в командной панели окна выберите загрузку конфигурации из файла, укажите .cfe.
5. Откройте свойства расширения (Alt+Enter): проверьте «Активно» и «Безопасный режим».
6. Обновите конфигурацию базы данных для расширения (F7 или кнопка «Обновить конфигурацию базы данных»).

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

4. Если нужен свой общий модуль в коде конфигурации

Иногда под «модулем» понимают общий модуль — объект конфигурации с процедурами, которые вызываются из разных мест. Его создают в Конфигураторе:

1. Откройте дерево конфигурации (Конфигурация → Открыть конфигурацию).
2. Раскройте ветку Общие → Общие модули.
3. Правой кнопкой → «Добавить».
4. Задайте имя и флажки контекста: «Клиент (управляемое приложение)», «Сервер», «Вызов сервера», «Внешнее соединение», «Привилегированный».
5. Напишите процедуры с ключевым словом Экспорт, иначе их не видно снаружи.
6. Сохраните и обновите конфигурацию БД (F7).

// Общий модуль «РаботаСДатамиКлиентСервер» (Клиент, Сервер)
Функция ПоследнийДеньКвартала(Дата) Экспорт
	Возврат КонецКвартала(Дата);
КонецФункции

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

5. Права доступа и видимость подключённого модуля

Подключить мало — нужно, чтобы пользователи увидели команду и смогли её выполнить.

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

Для дополнительных отчётов и обработок права настраиваются в двух местах:

• 👥 в карточке обработки — кому она доступна и у кого в быстром доступе;
• 🛡️ в профилях групп доступа — роли на чтение и на добавление/изменение дополнительных отчётов и обработок.

Если обработка добавлена, а команды в документе нет — сначала проверьте размещение в карточке, потом роли пользователя.

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

6. Отладка и проверка модуля после подключения

Проверяйте новый модуль сначала в копии базы. Расширение, которое правит проведение документов, в рабочей базе может испортить движения за период.

Как включить отладку

• В файловой базе отладка доступна сразу: в Конфигураторе нажмите F5 («Начать отладку»).
• В клиент-серверной базе отладку на сервере разрешают при запуске агента сервера с ключом -debug. Это делает администратор сервера, и для применения ключа службу агента нужно перезапустить.

Отладка внешней обработки

1. В Конфигураторе откройте файл .epf через Файл → Открыть.
2. Поставьте точки останова (F9) в модуле объекта или формы.
3. Запустите отладку (F5) — откроется Предприятие.
4. В Предприятии откройте тот же файл с того же пути через Файл → Открыть.
5. Выполните действие — Конфигуратор остановится на точке.

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

Отладка расширения

1. В окне Конфигурация → Расширения конфигурации откройте нужное расширение.
2. Поставьте точки останова в его модулях.
3. Запустите отладку F5.

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

Что проверить вручную

• ✅ команда появилась там, где задумано;
• ✅ печатная форма печатается на реальном документе, а не только на тестовом;
• ✅ у пользователя без полных прав всё работает так же;
• ✅ при проведении документа движения не изменились там, где не должны.

7. Ошибки при подключении модуля и как их устранить

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

Если расширение мешает входу в программу, его можно отключить в Конфигураторе: снимите флажок «Активно» в окне расширений и обновите конфигурацию БД. Данные, записанные в объекты расширения, при этом не удаляются, пока само расширение остаётся в базе.

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