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

Разработка и Конфигурация · 9 мин

Как запустить 1С из конфигуратора

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

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

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

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

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

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

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

Запуск с отладкой: клавиша F5

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

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

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

Порядок запуска с отладкой
  1. 1
    Сохраните изменения конфигурации (Ctrl+S)
  2. 2
    Обновите конфигурацию базы данных (F7)
  3. 3
    Расставьте точки останова в нужных модулях (F9)
  4. 4
    Нажмите F5 — запустится клиентское приложение
  5. 5
    Выполните в приложении действие, которое вызывает ваш код
  6. 6
    Проверьте остановку на точке и значения переменных

Запуск без отладки: Ctrl+F5

Если нужно просто посмотреть результат — например, проверить внешний вид формы или печатной формы — отладка не обязательна. Нажмите Ctrl+F5 или выберите «Отладка → Начать без отладки». Клиент запустится быстрее и будет работать без подключения к отладчику.

Альтернативный путь — пункт меню «Сервис → 1С:Предприятие». Результат тот же: откроется клиентское приложение текущей базы. Этот вариант удобен тем, кто привык работать мышью и не помнит горячие клавиши.

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

Настройка параметров запуска

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

Для разовых запусков с особыми условиями удобна команда «Отладка → Параметры запуска» (в ряде версий — флажки в диалоге начала отладки). Там можно указать запуск под другим пользователем, с конкретным языком интерфейса или с параметром командной строки — например, открыть сразу нужную обработку через параметр /Execute.

Выбор пользователя для тестирования прав

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

Тонкий, толстый и веб-клиент

Толстый клиент нужен для отладки обычных форм и некоторых служебных механизмов. Тонкий клиент — стандарт для управляемых приложений и файловых баз. Веб-клиент запускается через браузер и требует опубликованной на веб-сервере базы; его отладка настраивается отдельно.

Сравнение способов запуска

F5 (с отладкой)

Для поиска ошибок в коде: точки останова, просмотр переменных. Работает медленнее, требует открытого конфигуратора.

Ctrl+F5 (без отладки)

Для быстрой визуальной проверки форм, отчётов, печати. Точки останова не срабатывают.

Запуск из стартера 1С

Для проверки «как у пользователя»: конфигуратор не участвует, удобно для финального контроля.

Отладка в клиент-серверной базе

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

Решение — включить отладку на сервере: агент сервера 1С должен быть запущен с ключом -debug. Это делается в параметрах службы агента сервера (для Windows — в реестре, в свойствах службы) с последующим перезапуском службы. Операция требует прав администратора сервера и кратковременно останавливает работу пользователей — планируйте её на нерабочее время.

Типичные ошибки и их решение

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

Ошибка «Конфликт блокировок при выполнении транзакции» или отказ обновления из-за активных сеансов означает, что в базе кто-то работает. Проверьте список активных пользователей («Администрирование → Активные пользователи» в файловом режиме) и завершите лишние сеансы.

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

Типичные ошибки
01
Запуск без обновления конфигурации БД — в клиенте видна старая версия, разработчик ищет несуществующую ошибку в коде
02
Точки останова в серверном коде при выключенной отладке на сервере — отладчик их игнорирует, включите -debug на сервере
03
Отладка на продуктивной базе в рабочее время — блокировки при реструктуризации и простои пользователей
04
Проверка прав только под администратором — ошибки прав доступа у рядовых пользователей остаются незамеченными

Проверка результата после запуска

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

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

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

Как проверить результат

Версия конфигурации в «О программе»
Норма

Совпадает с версией в конфигураторе

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

Старая версия — конфигурация БД не обновлена

Остановка на точке отладки
Норма

Выполнение останавливается, переменные видны

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

Точка не срабатывает — проверьте режим отладки и серверный -debug

Проведение тестового документа
Норма

Документ проводится без сообщений об ошибках

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

Ошибка прав или модулей — смотрите текст сообщения и журнал регистрации

Итог

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

Запуск из конфигуратора — это F5 (с отладкой) или Ctrl+F5 (без отладки). Перед запуском обновляйте конфигурацию базы данных, проверяйте права под реальным пользователем, а все эксперименты выполняйте на копии рабочей базы.

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

Почему после запуска из конфигуратора мои изменения не видны?

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

Чем F5 отличается от Ctrl+F5?

F5 запускает клиент с подключением к отладчику: работают точки останова и просмотр переменных, но приложение работает медленнее. Ctrl+F5 запускает обычный сеанс без отладки — быстрее, но остановиться в коде нельзя.

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

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

Не срабатывают точки останова в серверных процедурах. Что делать?

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

Можно ли запускать из конфигуратора веб-клиент?

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

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

Да, если база активно используется: обновление требует монопольного доступа, а реструктуризация может занять много времени. Перед обновлением сделайте резервную копию (выгрузку в dt) и выполняйте операцию в нерабочее время.