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

Администрирование · 10 мин

Как запустить модуль 1С: понятная инструкция

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

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

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

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

Что считается модулем в 1С и какой сценарий вам нужен

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

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

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

Как запустить конфигурацию 1С в режиме Предприятие

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

Если базы нет в списке, добавьте её кнопкой «Добавить»: укажите название и путь к папке с файловой базой либо параметры сервера 1С и имя базы на SQL-сервере. Для клиент-серверного варианта путь и имя базы вам сообщит администратор — самостоятельно эти параметры определить невозможно.

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

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

Как запустить внешнюю обработку или отчёт

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

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

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

Как вызвать процедуру общего модуля

Общий модуль не запускается напрямую — его процедуры вызываются из другого кода. Чтобы процедура была доступна извне, она должна быть объявлена с ключевым словом «Экспорт». Вызов выполняется по имени модуля и процедуры через точку.

bsl
// Вызов экспортной процедуры общего модуля
ОбщегоНазначения.СообщитьПользователю("Проверка запуска модуля");

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

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

Типичные ошибки при вызове модулей
01
Вызов серверного модуля из клиентского кода — ошибка компиляции или выполнения
02
Процедура объявлена без «Экспорт» — она недоступна извне модуля
03
Опечатка в имени модуля — платформа сообщает, что метод не обнаружен
04
Вызов модуля с флагом «Привилегированный режим» без понимания: такой код игнорирует права и может изменить чужие данные

Как запустить модуль в режиме отладки

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

Когда выполнение дойдёт до точки останова, управление перейдёт в конфигуратор: вы увидите текущие значения переменных, сможете шагать по коду (F10 — шаг через, F11 — шаг внутрь) и проверять выражения через Shift+F9. Это позволяет точно понять, выполняется ли модуль вообще и где логика расходится с ожиданиями.

Для клиент-серверных баз убедитесь, что на сервере 1С включён режим отладки (параметр -debug при запуске сервера). Без него серверный код в отладчике не остановится — точки останова в серверных модулях будут просто игнорироваться, и создаётся ложное впечатление, что модуль не выполняется.

Как запустить модуль по расписанию через регламентные задания

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

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

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

Как проверить, что модуль отработал

Журнал регистрации
Норма

Есть событие о завершении задания без ошибок

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

Записи с уровнем «Ошибка» или задание вообще не появляется

Результат работы
Норма

Данные изменились или появились ожидаемые записи

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

Данные не изменились — проверяйте условия в коде

Отладка
Норма

Выполнение доходит до точки останова в модуле

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

Точка не срабатывает — код не вызывается или отладка сервера отключена

Частые ошибки и их решение

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

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

Итог

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

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

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

Можно ли запустить общий модуль напрямую, как программу?

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

Почему кнопка «Файл → Открыть» не открывает обработку?

Чаще всего у пользователя нет права интерактивного открытия внешних файлов. Попросите администратора выдать право или зарегистрировать обработку через механизм «Дополнительные отчеты и обработки» — тогда она будет доступна как обычный пункт меню.

Точка останова в серверном модуле не срабатывает. Что делать?

Проверьте, что сервер 1С запущен с параметром отладки (-debug), а в конфигураторе подключён нужный тип отладки — серверный. Также убедитесь, что код действительно вызывается: возможно, условие в программе не приводит к выполнению этой ветки.

Безопасно ли запускать обработки, скачанные из интернета?

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

Как запустить модуль без конфигуратора?

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

Что делать, если после запуска модуля данные испортились?

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