Запускает новый сеанс 1С:Предприятия. Новый сеанс будет запущен с текущими установками.
Синтаксис
ЗапуститьСистему(<ДополнительныеПараметрыКоманднойСтроки>, <ДождатьсяЗавершения>, <КодВозврата>)Полное описание, параметры и ограничения
Глобальный контекст.ЗапуститьСистему (Global context.RunSystem)
Глобальный контекст (Global context)
ЗапуститьСистему (RunSystem)
Доступен, начиная с версии 8.1.
Синтаксис:
ЗапуститьСистему(<ДополнительныеПараметрыКоманднойСтроки>, <ДождатьсяЗавершения>, <КодВозврата>)
Параметры:
<ДополнительныеПараметрыКоманднойСтроки> (необязательный)
Тип: Строка.
Содержит дополнительные параметры, которые будут переданы новому сеансу. Если такие параметры уже есть среди текущих установок, переданные заменят текущие.
Если режим приложения (УправляемоеПриложение/ ОбычноеПриложение) не задан явно дополнительным параметром командной строки, при запуске текущего приложения учитывается использование параметров принудительного включения режима управляемого или обычного приложения /RunModeManagedApplication и /RunModeOrdinaryApplication.
<ДождатьсяЗавершения> (необязательный)
Тип: Булево.
Указывает необходимость дождаться завершения запуска системы для продолжения работы.
Значение по умолчанию: Ложь.
<КодВозврата> (необязательный)
Тип: Число, Неопределено.
Параметр (если он указан) содержит код завершения работы сеанса "1С:Предприятия"- значение, передаваемое платформой операционной системе, если работа была завершена корректно, и если такой код был получен. В противном случае возвращает Неопределено.
Для получения кода возврата значение параметра <ДождатьсяЗавершения> должно быть установлено в Истина, а сеанс должен быть корректно завершен.
Возможны следующие значения:
0 - успешное завершение;
1 - ошибка;
101 - ошибка в данных (такой код может быть возвращен при обновлении конфигурации, при проверке и исправлении конфигурации, а также при создании дистрибутива конфигурации).
Описание:
Запускает новый сеанс 1С:Предприятия. Новый сеанс будет запущен с текущими установками.
Доступность:
Тонкий клиент, толстый клиент.
Примечание:
По умолчанию новая система запускается в режиме 1С:Предприятия. Если в качестве одного из дополнительных параметров будет передан ключ DESIGNER, новая система будет запущена в режиме Конфигуратора.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Запустить второй собственный сеанс и получить код выхода
Код возвращается выходным третьим параметром только при ожидании корректного завершения.
Где и как запускать
Тонкий или толстый клиент.
Подготовка
Вставьте блок в модуль собственной управляемой формы. Клиентскую процедуру вызовите из обработчика своей кнопки; серверную — через собственный серверный обработчик команды. Специальное место вставки указано отдельно.
Только собственная учебная база в тонком или толстом клиенте. Метод запустит реальный новый сеанс с текущими установками; завершают его вручную. Здесь запуск не выполняется.
&НаКлиенте
Процедура ОткрытьВторойУчебныйСеанс()
КодВыхода = Неопределено;
ЗапуститьСистему("", Истина, КодВыхода);
Если КодВыхода = Неопределено Тогда
Сообщить("Код завершения не получен");
Иначе
Сообщить("Код завершения: " + Строка(КодВыхода));
КонецЕсли;
КонецПроцедурыРазбор по шагам
Подготовьте отдельный учебный сеанс.
Запустите с ожиданием и третьим выходным параметром.
После завершения прочитайте код или отсутствие кода.
Как проверить результат
Процедуре не присваивается вымышленное возвращаемое значение.
Неопределено не подменяется успешным кодом 0.
Ожидаемый результат
При корректном завершении можно получить код нового сеанса.
На что обратить внимание
Ожидание приостанавливает продолжение вызывающего кода. Не запускайте рекурсивно из стартового обработчика, иначе можно породить множество сеансов.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.