Как загрузить модуль в 1С: способы, ограничения и проверка результата

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

Определить тип файла проще всего по расширению. Файлы с расширением .epf — внешние обработки, .erf — внешние отчёты, .cfe — расширения конфигурации. Если речь идёт о фрагменте кода для встроенного модуля (общего модуля, модуля объекта, модуля формы), то такой код не «загружается» отдельным файлом, а вставляется в конфигураторе. Отдельный случай — внешние компоненты (Native API, COM), которые подключаются методом ПодключитьВнешнююКомпоненту().

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

Определяем тип модуля и подходящий способ загрузки

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

Ориентируйтесь на таблицу соответствия: она связывает тип файла с правильным инструментом загрузки.

Если файл получен от стороннего разработчика и тип неясен, откройте его в текстовом редакторе: XML-заголовок с описанием ExternalDataProcessor указывает на обработку, а упоминание ConfigurationExtension — на расширение. Это быстрый способ проверки без риска что-либо испортить.

Загрузка внешней обработки или отчёта (EPF/ERF)

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

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

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

Загрузка расширения конфигурации (CFE)

Расширения — штатный способ доработать типовую конфигурацию без снятия её с поддержки. Загрузка выполняется в конфигураторе: откройте «Конфигурация → Расширения конфигурации», в появившемся окне нажмите «Добавить» (или «Загрузить из файла» в зависимости от версии платформы), укажите файл .cfe и задайте имя расширения.

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

В клиент-серверном варианте и при работе через веб-сервер расширения можно подключать и в режиме 1С:Предприятие через «Все функции → Стандартные → Управление расширениями конфигурации» (в типовых конфигурациях есть аналогичная обработка). Это удобно, когда доступа к конфигуратору нет, но есть права администратора.

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

Добавление и изменение встроенных модулей в конфигураторе

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

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

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

// Пример вызова процедуры из общего модуля после успешной загрузки
Результат = МойОбщийМодуль.РассчитатьПоказатель(Параметр1);
// Проверка подключения внешней компоненты
Если ПодключитьВнешнююКомпоненту("ОбщийМакет.Компонента") Тогда
    // компонента доступна
КонецЕсли;

Подключение внешних компонентов (DLL)

Внешние компоненты (библиотеки DLL, разработанные по технологии Native API или COM) загружаются программно. Обычно компоненту помещают в макет конфигурации или в общий макет в виде ZIP-архива, а в коде вызывают ПодключитьВнешнююКомпоненту() с указанием места хранения, после чего создают объект компоненты.

Ограничения этого механизма важно знать заранее: компонента должна соответствовать разрядности клиентского приложения (32/64 бита), на веб-клиенте возможности подключения существенно ограничены, а в серверном варианте компонента должна быть доступна на сервере 1С, а не только на машине пользователя. Если подключение возвращает «Ложь», проверьте журнал регистрации и разрядность платформы.

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

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

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

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