Администрирование · 10 мин
Как запустить модуль 1С: понятная инструкция
Как запустить модуль 1С: запуск конфигурации, внешних обработок и общих модулей. Пошаговые инструкции, типичные ошибки и проверка результата.
Фраза «запустить модуль 1С» может означать разные задачи: открыть конфигурацию, выполнить внешнюю обработку, вызвать процедуру общего модуля или запустить серверный модуль в режиме отладки. Прежде чем что-то нажимать, важно понять, какой именно сценарий перед вами, потому что действия и риски в каждом случае отличаются.
Для обычного пользователя запуск модуля чаще всего сводится к открытию информационной базы и нужного раздела конфигурации. Для администратора и разработчика — это работа с конфигуратором, внешними обработками, отладкой и сервером приложений. Ниже разобраны все основные сценарии с конкретными шагами и признаками успешного результата.
Критично помнить: любые изменения в конфигураторе и запуск непроверенных внешних обработок могут повредить данные. Перед экспериментами на рабочей базе сделайте резервную копию — это займёт несколько минут, но защитит от необратимых последствий.
Что считается модулем в 1С и какой сценарий вам нужен
В платформе 1С:Предприятие термин «модуль» охватывает несколько разных объектов. Общие модули — это контейнеры процедур и функций, доступных из любой точки конфигурации. Модули объектов, форм, менеджеров и приложения содержат код, привязанный к конкретным элементам. Отдельно существуют внешние обработки и отчёты — файлы с расширением .epf и .erf, которые часто называют «модулями» на бытовом уровне.
Запуск каждого типа отличается. Общий модуль нельзя «открыть» как программу — его процедуры вызываются из другого кода. Внешнюю обработку запускают как файл. Конфигурацию целиком запускают как приложение. Определите свой случай по таблице ниже и переходите к нужному разделу.
| Что нужно запустить | Инструмент | Кто выполняет |
|---|---|---|
| Конфигурацию (программу 1С) | Ярлык 1С:Предприятие или стартер | Пользователь |
| Внешнюю обработку (.epf) | Меню «Файл → Открыть» в режиме Предприятие | Пользователь с правами |
| Процедуру общего модуля | Вызов из кода или отладка | Разработчик |
| Модуль в отладчике | Конфигуратор, режим отладки | Разработчик |
| Регламентное задание (модуль по расписанию) | Консоль заданий или планировщик | Администратор |
Как запустить конфигурацию 1С в режиме Предприятие
Базовый сценарий — открыть рабочую базу. Найдите ярлык 1С:Предприятие на рабочем столе или в меню «Пуск». После запуска откроется окно со списком информационных баз. Выберите нужную базу, убедитесь, что внизу окна выбран режим «1С:Предприятие», и нажмите кнопку запуска.
Если базы нет в списке, добавьте её кнопкой «Добавить»: укажите название и путь к папке с файловой базой либо параметры сервера 1С и имя базы на SQL-сервере. Для клиент-серверного варианта путь и имя базы вам сообщит администратор — самостоятельно эти параметры определить невозможно.
Признак успешного запуска — окно авторизации с полями «Пользователь» и «Пароль», а затем открывшийся рабочий стол конфигурации с разделами меню. Если вместо этого появляется ошибка соединения, база недоступна: проверьте сеть, доступность сервера или корректность пути к файловой базе.
- 1Откройте ярлык 1С:Предприятие
- 2Выберите базу в списке или добавьте новую через «Добавить»
- 3Проверьте, что выбран режим «1С:Предприятие», а не «Конфигуратор»
- 4Нажмите кнопку запуска и введите логин и пароль
- 5Убедитесь, что открылся рабочий стол с разделами конфигурации
Как запустить внешнюю обработку или отчёт
Внешние обработки — самостоятельные файлы, которые запускаются поверх работающей конфигурации без её изменения. Откройте базу в режиме 1С:Предприятие, затем в главном меню выберите «Файл → Открыть» и укажите файл обработки с расширением .epf или отчёта .erf. Обработка откроется в отдельном окне.
Во многих конфигурациях есть встроенный механизм «Дополнительные отчеты и обработки» (раздел «Администрирование»). Через него обработку можно зарегистрировать постоянно: она появится в списке и будет запускаться обычным пунктом меню, без ручного открытия файла каждый раз. Это предпочтительный способ для регулярно используемых инструментов.
Учтите ограничение: для открытия внешних файлов у пользователя должно быть право «Интерактивное открытие внешних обработок и отчётов». Если меню «Файл → Открыть» недоступно или появляется сообщение о нарушении прав, обратитесь к администратору за выдачей права или за регистрацией обработки через штатный механизм.
Как вызвать процедуру общего модуля
Общий модуль не запускается напрямую — его процедуры вызываются из другого кода. Чтобы процедура была доступна извне, она должна быть объявлена с ключевым словом «Экспорт». Вызов выполняется по имени модуля и процедуры через точку.
// Вызов экспортной процедуры общего модуля
ОбщегоНазначения.СообщитьПользователю("Проверка запуска модуля");Для быстрой проверки работы модуля без написания полноценного кода удобно использовать внешнюю обработку с полем выполнения произвольного кода или консоль кода — такие инструменты входят в популярные наборы разработчика. Выполнение кода там происходит в контексте базы, и вызов общего модуля сработает так же, как из штатного кода конфигурации.
Обратите внимание на флаги общего модуля в его свойствах: «Сервер», «Клиент (обычное приложение)», «Клиент (управляемое приложение)», «Вызов сервера». Если модуль помечен только как серверный, вызвать его напрямую из клиентского кода не получится — компилятор выдаст ошибку «Процедура или функция не определена». Это самая частая причина «незапускающегося» модуля.
Как запустить модуль в режиме отладки
Отладка — основной способ проверить, как модуль выполняется по шагам. Откройте конфигуратор, в меню «Отладка» выберите «Начать отладку» или нажмите F5. Конфигуратор запустит сеанс 1С:Предприятие в отладочном режиме. Поставьте точку останова (F9) на нужной строке модуля, затем выполните в запущенном приложении действие, которое приводит к вызову кода.
Когда выполнение дойдёт до точки останова, управление перейдёт в конфигуратор: вы увидите текущие значения переменных, сможете шагать по коду (F10 — шаг через, F11 — шаг внутрь) и проверять выражения через Shift+F9. Это позволяет точно понять, выполняется ли модуль вообще и где логика расходится с ожиданиями.
Для клиент-серверных баз убедитесь, что на сервере 1С включён режим отладки (параметр -debug при запуске сервера). Без него серверный код в отладчике не остановится — точки останова в серверных модулях будут просто игнорироваться, и создаётся ложное впечатление, что модуль не выполняется.
Как запустить модуль по расписанию через регламентные задания
Если код модуля должен выполняться автоматически — например, обмен данными или пересчёт итогов — используются регламентные задания. В конфигураторе найдите в дереве конфигурации ветку «Общие → Регламентные задания», откройте нужное задание и проверьте, какой метод указан в его свойствах: это и есть запускаемая процедура общего модуля.
В клиент-серверном режиме задания выполняются сервером автоматически по расписанию. В файловом режиме требуется запущенный сеанс, который выполняет фоновые задания, — обычно это отдельный сеанс с параметром запуска или специальная обработка-выполнитель. Проверить фактическое выполнение можно в «Журнале регистрации»: там фиксируются запуск, завершение и ошибки каждого задания.
Как проверить, что модуль отработал
Есть событие о завершении задания без ошибок
Записи с уровнем «Ошибка» или задание вообще не появляется
Данные изменились или появились ожидаемые записи
Данные не изменились — проверяйте условия в коде
Выполнение доходит до точки останова в модуле
Точка не срабатывает — код не вызывается или отладка сервера отключена
Частые ошибки и их решение
Ошибка «Информационная база не обнаружена» при запуске конфигурации означает неверный путь к файловой базе или недоступность сервера. Проверьте путь в свойствах базы и доступность сетевого ресурса. Ошибка «Нарушение прав доступа» при открытии обработки говорит о нехватке прав — нужен администратор.
Сообщение «Процедура или функция с указанным именем не определена» при вызове общего модуля почти всегда означает одно из трёх: процедура не экспортная, не тот контекст выполнения (клиент/сервер) или опечатка в имени. Проверяйте в этом порядке — в большинстве случаев причина находится за минуту.
Что важно запомнить
Сначала определите тип модуля: конфигурация запускается ярлыком, обработка — через «Файл → Открыть», общий модуль — вызовом его экспортной процедуры, а проверка логики — через отладку. Перед любыми экспериментами делайте резервную копию, а непроверенные обработки запускайте только на копии базы.
Частые вопросы
Можно ли запустить общий модуль напрямую, как программу?
Нет. Общий модуль — это библиотека процедур, а не самостоятельное приложение. Его код выполняется только при вызове из другого модуля, обработки, команды или регламентного задания. Для ручной проверки используйте консоль кода или отладку.
Почему кнопка «Файл → Открыть» не открывает обработку?
Чаще всего у пользователя нет права интерактивного открытия внешних файлов. Попросите администратора выдать право или зарегистрировать обработку через механизм «Дополнительные отчеты и обработки» — тогда она будет доступна как обычный пункт меню.
Точка останова в серверном модуле не срабатывает. Что делать?
Проверьте, что сервер 1С запущен с параметром отладки (-debug), а в конфигураторе подключён нужный тип отладки — серверный. Также убедитесь, что код действительно вызывается: возможно, условие в программе не приводит к выполнению этой ветки.
Безопасно ли запускать обработки, скачанные из интернета?
Нет, не на рабочей базе. Обработка получает полный доступ к данным и может изменить или удалить их. Сначала сделайте копию базы, протестируйте обработку на ней и убедитесь, что результат соответствует ожиданиям.
Как запустить модуль без конфигуратора?
Если речь о процедуре общего модуля — через регламентное задание, внешнюю обработку с вызовом кода или команду, добавленную в интерфейс. Сам конфигуратор нужен только для изменения кода и отладки, для выполнения достаточно режима 1С:Предприятие.
Что делать, если после запуска модуля данные испортились?
Немедленно прекратите работу пользователей с базой и восстановите данные из последней резервной копии. Если копии нет, не выполняйте тестирование и исправление самостоятельно — привлеките специалиста, так как неправильные действия могут усугубить повреждения.