Общие команды запуска

Указывает параметры подключения

Настройка аутентификации

Определение режима запуска

Работа с сертификатами

Настройка интерфейса

Настройка локализации

Настройка отладки

Настройка тестирования

Проверки при работе клиентского прикладного приложения

Вспомогательные параметры

Другие параметры

 

Указывает параметры подключения

/F <каталог>

Каталог, в котором расположен файл базы данных 1Cv8.1CD.

/S <адрес>

Адрес информационной базы, хранящейся на сервере BAF. Формируется как <Имя компьютера, являющегося сервером прикладных программ>\<Имя-ссылка на информационную базу внутри сервера системы>.

/IBName <имя информационной базы>

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

/IBConnectionString

Позволяет задать строку соединения с информационной базой полностью в виде значения, которое возвращает функция InfoBaseConnectionString()/СтрокаСоединенияИнформационнойБазы(). Части строки соединения можно переопределить имеющимися параметрами. Для этого /IBConnectionString должен располагаться в командной строке раньше них. Передавая строку соединения как параметр командной строки, следует помнить, что она содержит кавычки. Поэтому всю строку нужно заключить в кавычки, а кавычки внутри неё — удвоить.

Дополнительные параметры строки соединения в режиме тонкого клиента:

• wsn – имя пользователя для аутентификации на веб-сервере;
• wsp – пароль пользователя для аутентификации на веб-сервере;
• wspauto – использовать автоматические настройки прокси-сервера;
• wspsrv – адрес прокси-сервера;
• wspport – порт прокси;
• wspuser – имя пользователя для прокси с авторизацией;
• wsppwd – пароль для прокси с авторизацией.

/WS <url>

Строка ws-соединения.

/O<скорость соединения>

Определяет скорость соединения, используется в тонком клиенте. Команда применяется для настройки списка информационных баз. <скорость соединения> может принимать следующие значения:

• Normal – обычная скорость соединения (значение по умолчанию);
• Low – низкая скорость соединения.

/TComp [-None|-Deflate|-SDC]

Устанавливает режим сжатия трафика между сервером и тонким клиентом. Для команды можно использовать один из параметров:

• -None – сжатие выключено.
• -Deflate – используется стандартное для протокола HTTP сжатие трафика по алгоритму deflate.
• -SDC – используется собственный алгоритм сжатия (используется по умолчанию).

UsePrivilegedMode

Запуск клиентского прикладного приложения в привилегированном режиме. Разрешён аутентифицированному пользователю, имеющему административные права. Журнал регистрации фиксирует установление или отмену возможности установления режима привилегированного сеанса.

/SLev<Уровень>

Определяет уровень защищённости соединения клиента с сервером системы. Для команды можно выбрать одно из значений уровня защищённости:

• 0 – незащищённое соединение;
• 1 – защищённое соединение только во время выполнения аутентификации;
• 2 – защищённое соединение в течение всего сеанса.

Если команда указана без значения, это эквивалентно указанию команды со значением 0 – /SLev0.

/Z "<Общий реквизит 1>,<Общий реквизит 2>,...,<Общий реквизит N>"

Установка разделителей при запуске клиентской программы.

Настройка аутентификации

/N<имя>

Имя пользователя, которое нужно указать так же, как в списке пользователей, создаваемом в Конфигураторе.

/P<пароль>

Пароль пользователя, имя которого указано в параметре /N. Если у пользователя нет пароля, этот параметр использовать не нужно.

/WA<режим>

Определяет режим использования аутентификации операционной системы при запуске программы. Если параметр /WA не указан, по умолчанию используется параметр командной строки /WA+.

<режим> может принимать следующие значения:

• + – установка обязательного применения аутентификации операционной системы при запуске программы;
• - – запрет применения аутентификации операционной системы при запуске программы.

/WSA<режим>

Определяет режим использования аутентификации операционной системы на веб-сервере. Если параметр /WSA не указан, по умолчанию используется параметр командной строки /WSA+.

<режим> может принимать следующие значения:

• + – принудительное выполнение аутентификации средствами операционной системы на веб-сервере (по умолчанию).
• - – запрет применения аутентификации средствами операционной системы на веб-сервере.

/WSN <имя>

Имя пользователя операционной системы, которое будет использоваться системой для выполнения аутентификации на веб-сервере при указании параметра /WSA+. Пароль пользователя указывается в параметре /WSP.

/WSP <пароль>

Пароль пользователя, имя которого указано в параметре /WSN, для аутентификации на веб-сервере.

/NoProxy

Запретить использование прокси (только для ws-соединения).

/Proxy -PSrv <адрес прокси> -PPort <порт> [-PUser <имя пользователя прокси> [-PPwd <пароль>]]

Использовать указанные настройки прокси, игнорируя значения по умолчанию (только для ws-соединения).

/OIDA<режим>

Применение сквозной аутентификации пользователя между различными информационными базами и/или внешними ресурсами для тонкого и веб-клиентов. Если при запуске клиента параметр /OIDA не задан или задан параметр /OIDA+, выполняется попытка аутентификации через OpenID-провайдера, адрес которого задан в файле deafault.vrd публикации этой информационной базы.

Если OpenID-провайдер требует интерактивной аутентификации (происходит первое обращение или истёк срок жизни признака аутентифицированности), клиент отображает диалог для ввода имени и пароля пользователя.

Аутентификация выполняется по списку пользователей информационной базы OpenID-провайдера.

Пользователь информационной базы с OpenID-аутентификацией должен соответствовать по имени пользователю информационной базы OpenID-провайдера.

<режим> может принимать следующие значения:

• + – использовать OpenID-аутентификацию (по умолчанию);
• - – не использовать OpenID-аутентификацию.

/Authoff

Выполняет операцию OpenID logout (завершение сеанса работы пользователя). Завершение сеанса работы выполняется независимо от метода аутентификации, который будет использоваться в дальнейшем.

/SAOnRestart

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

Не используется в тонком клиенте.

Определение режима запуска

/AppAutoCheckVersion<режим>

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

<режим> может принимать следующие значения:

• + – выполнять подбор версий при запуске (значение по умолчанию);
• - – не выполнять подбор версий при запуске.

По умолчанию подбор выполняется. Команда /AppAutoCheckVersion эквивалентна команде /AppAutoCheckVersion+.

/AppAutoCheckMode

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

/RunModeOrdinaryApplication

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

/RunModeManagedApplication

Запуск толстого клиента в режиме управляемого прикладного приложения с учётом настроек клиента в списке информационных баз (настройка Основной режим запуска):

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

Дополнительно при запуске клиента отключается механизм автоматического подбора клиентского прикладного приложения.

/AppArch <разрядность>

Позволяет указать разрядность используемого клиентского прикладного приложения.

<разрядность> может принимать одно из следующих значений:

• x86 – использовать только 32-разрядные версии;
• x86_prt – использовать преимущественно 32-разрядные версии;
• x86_64 – использовать только 64-разрядные версии;
• x86_64_prt – использовать преимущественно 64-разрядные версии.

/MainWindowMode <режим запуска>

Позволяет явно указать режим запуска основного окна клиентского прикладного приложения. Параметр <режим запуска> может принимать одно из следующих значений:

• -Normal – обычный режим запуска;
• -Workplace – режим рабочего места;
• -EmbeddedWorkplace – режим встроенного рабочего места (для встраивания веб-клиента в сторонний сайт);
• -FullscreenWorkplace – режим полноэкранного рабочего места.
• -Kiosk – режим киоска.

Работа с сертификатами

/HttpsCert [-windows] [-linux] [-macos] [-recent] [-auto] [-choose] [-file <path>] [-pwd <password>] [-none]

Указывает источник клиентского сертификата.

Параметры команды:

• -windows – указывает, что при соединении нужно использовать клиентский сертификат из системного хранилища сертификатов ОС Windows. Этот параметр игнорируется, если указан хотя бы один из параметров: -file или -none.
• -linux – указывает, что при соединении нужно использовать сертификат из специального каталога ОС Linux, в котором хранятся сертификаты. Этот параметр игнорируется, если указан хотя бы один из параметров: -file или -none.
• -macos – указывает, что при соединении нужно использовать клиентский сертификат из системного хранилища сертификатов ОС macOS. Этот параметр игнорируется, если указан хотя бы один из параметров: -file или -none.
• -recent – выбирать или использовать ранее выбранный клиентский сертификат при работе в ОС Windows или macOS.
• Если в системном хранилище сертификатов пользователя есть более одного подходящего сертификата, пользователю предоставляется возможность выбрать сертификат для использования через системный диалог выбора. В дальнейшем выбранный сертификат используется автоматически.
• Этот способ выбора клиентского сертификата используется по умолчанию для параметров команд -windows и -macos, если параметры -auto и -choose не указаны.
• -auto – использовать автоматически выбранный клиентский сертификат из имеющихся в системном хранилище сертификатов Windows или MacOS. Этот параметр игнорируется, если команда не имеет параметра -windows или -macos (соответственно).
• -choose – всегда выбирать клиентский сертификат ОС Windows или macOS.
• Если в системном хранилище сертификатов пользователя есть более одного подходящего сертификата, пользователю предоставляется возможность выбрать сертификат для использования через системный диалог выбора независимо от того, был ли сертификат выбран ранее. Выбранный сертификат в дальнейшем может использоваться автоматически с параметром -recent.
• Этот параметр можно указать, если необходимо избежать автоматического использования ранее выбранного клиентского сертификата из системного хранилища сертификатов ОС Windows или macOS и выбрать новый сертификат из установленных в системе сертификатов, соответствующих этому соединению. Этот параметр игнорируется, если команда не имеет параметра -windows/-macos или установлен параметр -auto.
• -file <path> – указывает, что необходимо использовать клиентский сертификат и приватный ключ из указанного файла. Этот параметр игнорируется, если у команды установлен параметр -none.
• -pwd <password> – указывает пароль файла, содержащего клиентский сертификат и его приватный ключ. Если сервер требует предоставления клиентского сертификата и файл сертификата защищён паролем, соединение возможно только при правильно указанном пароле. Этот параметр игнорируется, если для команды не указан параметр -file.
• -none – указывает, что клиентский сертификат не используется. Соединение возможно только с серверами, которые не требуют проверки клиентского сертификата.

Если ни один из параметров -windows, -linux, -macos, -file или -none не указан, команда /HttpsCert игнорируется.

/HttpsCA [-windows] [-linux] [-macos] [-file <path>] [-pwd <password>] [-none]

Указывает источник сертификатов удостоверяющих центров, используемых для проверки сертификата сервера.

Параметры команды:

• -windows – указывает, что для проверки сертификата сервера при соединении нужно использовать сертификаты удостоверяющих центров из системного хранилища сертификатов ОС Windows. Этот параметр игнорируется, если установлен хотя бы один из параметров: -file или -none.
• -linux – указывает, что для проверки сертификата сервера при соединении необходимо использовать сертификаты удостоверяющих центров из специального каталога ОС Linux, в котором хранятся сертификаты. Этот параметр игнорируется, если указан хотя бы один из параметров: -file или -none.
• -macos – указывает, что для проверки сертификата сервера при соединении нужно использовать сертификаты удостоверяющих центров из системного хранилища сертификатов ОС macOS. Этот параметр игнорируется, если указан хотя бы один из параметров: -file или -none.
• -file <path> – указывает, что для проверки сертификата сервера при соединении нужно использовать сертификаты удостоверяющих центров, загруженные из указанного файла. Этот параметр игнорируется, если указан параметр -none.
• -pwd <password> – пароль файла, содержащего корневые сертификаты. Если файл сертификата защищён паролем, соединение возможно только при правильно указанном пароле. Этот параметр игнорируется, если для команды не указан параметр -file.
• -none – указывает, что корневые сертификаты не используются, а сертификат сервера не проверяется.

Если ни один из параметров -windows, -linux, -macos, -file или -none не установлен, команда /HttpsCA игнорируется.

/HttpsForceSSLv3

Указывает на необходимость принудительного использования протокола SSL версии 3.0 тонким клиентом при работе через веб-сервер по протоколу HTTPS.

Запрещено одновременное использование параметров /HttpsForceSSLv3 и /HttpsForceTLS1_0. В случае одновременного указания параметров поведение программы не определено.

/HttpsForceTLS1_0

Указывает на необходимость принудительного использования протокола TLS версии 1.0 при работе через веб-сервер по протоколу HTTPS.

Запрещено одновременное использование параметров /HttpsForceSSLv3 и /HttpsForceTLS1_0. В случае одновременного указания поведение не определено.

Настройка интерфейса

/iTaxi

Запуск в режиме интерфейса Такси.

/itdi

Запуск в режиме интерфейса с использованием вкладок.

/TechnicalSpecialistMode

Включает команду меню Функции для технического специалиста.

Настройка локализации

/L<код языка>

Указывается код языка интерфейса платформы. Поддерживаемые языки интерфейса задаются значением <код языка>.

/VL<код локализации сеанса>

Указывается код локализации сеанса, используемый для форматирования данных типа Number/Число и Date/Дата, а также в методах NumberInWords()/ЧислоПрописью() и PeriodPresentation()/ПредставлениеПериода().

Настройка отладки

/debug [<режим>] [-attach]

Означает, что это клиентское прикладное приложение будет запущено в режиме отладки. Протокол, используемый для работы отладки, определяет параметр <режим>:

• -tcp – для отладки используется протокол TCP/IP;
• -http – для отладки используется протокол HTTP.

Если в командной строке указан параметр -attach, это означает, что отладчик будет автоматически подключать предметы отладки (клиентский и серверный) запускаемой программы, которые будут зарегистрированы на сервере отладки. Параметр используется только для отладки по протоколу HTTP.

/debuggerURL <адрес отладчика>

Эта команда указывает адрес отладки (при отладке по протоколу TCP/IP) или адрес сервера отладки (при отладке по протоколу HTTP) при работе в режиме отладки. При указании сервера отладки необходимо указать не только имя компьютера, на котором работает сервер отладки, но и порт, через который происходит взаимодействие с ним.

DisplayPerformance

Включает отображение количества вызовов сервера и объёма данных, отправляемых на сервер и принимаемых с сервера.

/EmulateServerCallDelay [-Call<задержка>] [-Send<задержка>] [-Recevie<задержка>]

Эта команда имитирует работу клиентского прикладного приложения при медленном соединении.

Можно использовать следующие параметры:

• -Call<задержка> – указывает время задержки при вызове сервера в секундах. Если параметр не указан, значение задержки будет равно 1.45 секунды.
• -Send<время> – указывает время задержки в секундах в расчёте на каждые 1 Кбайт данных, отправляемых на сервер. Если параметр не указан, значение задержки будет равно 0.45 секунды.
• -Recevie<задержка> – указывает время задержки в секундах в расчёте на каждые 1 Кбайт данных, принятых с сервера. Если параметр не указан, значение задержки будет равно 0,15 секунды.

Максимальное значение временных задержек – 9.99 секунды.

Настройка тестирования

/TestManager

Запуск толстого или тонкого клиента для управления клиентами тестирования с помощью специализированной объектной модели.

/TestClient [-TPort<Номер tcp-порта>] [-TestClientID<Идентификатор>]

Запуск клиентского прикладного приложения (тонкий клиент, толстый клиент, веб-клиент и мобильный клиент) как клиента тестирования.

Параметры команды:

• -TPort<Номер tcp-порта> – указывает номер порта для взаимодействия клиента и менеджера тестирования. По умолчанию используется порт 1538.
• -TestClientID<Идентификатор> – указывает уникальный идентификатор тестируемой клиентской программы. Параметр используется для веб-клиента или мобильного клиента при необходимости различать несколько клиентов тестирования, одновременно используемых через одну программу менеджера тестирования. Для параметра нет значения по умолчанию.

/UILogRecorder [-TPort<Номер порта TCP/IP>] [-File<Путь>]

Позволяет в клиентском прикладном приложении (тонкий клиент, толстый клиент, веб-клиент, мобильный клиент) записывать журнал интерактивных действий пользователя. В дальнейшем журнал действий может использоваться для формирования на его основе программы на встроенном языке, которая позволит воспроизвести записанные действия. Может сочетаться с параметром /TestClient.

Параметры команды:

• -TPort<Номер TCP-порта> – указывает номер порта для взаимодействия клиента и менеджера тестирования. По умолчанию используется порт 1538.
• -File<Путь> – имя файла, в котором будет храниться журнал действий пользователя после завершения записи, если к клиенту не подключён менеджер тестирования.

Проверки при работе клиентского прикладного приложения

/EnableCheckModal

Включает режим строгой проверки использования модальных методов.

/EnableCheckExtensionsAndAddInsSyncCalls

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

/EnableCheckServerCalls

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

/EnableCheckScriptCircularRefs

Включает поиск циклических ссылок при выполнении кода на встроенном языке.

Вспомогательные параметры

/C <строка текста>

Передача параметра в прикладное решение.

/ClearCache

Выполняется очистка кеша клиент-серверных вызовов, в котором хранятся метаданные форм, модули и т. п., а также сохранённый индекс поиска по текстам модулей.

/AllowExecuteScheduledJobs -Off |-Force

Управление запуском регламентных заданий. Регламентные задания начинают выполняться на первом по порядку запуска клиенте, у которого для команды /AllowExecuteScheduledJobs не установлен параметр -Off. После завершения сеанса этого клиента выполнение переходит к следующему запущенному сеансу с такими параметрами. Если запускается сеанс с командой /AllowExecuteScheduledJobs -Force, регламентные задания начинают выполняться на нём независимо от наличия других сеансов.

/UC <код доступа>

Позволяет установить соединение с информационной базой, для которой установлена блокировка соединений. Если при установлении блокировки задан непустой код доступа, для установления соединения с заблокированной базой необходимо в параметре /UC указать этот код доступа.

Не используется при работе тонкого клиента через веб-сервер.

/RunShortcut <имя файла>

Позволяет запустить BAS со списком информационных баз, помещённым в указанный файл. Это может быть файл списка общих информационных баз (*.v8i) или файл ярлыка информационных баз (*.v8l).

/AppAutoInstallLastVersion<режим>

Управляет возможностью автоматической установки новых версий клиентского прикладного приложения.

<режим> может принимать следующие значения:

• + – установка новых версий разрешена;
• - – установка новых версий запрещена.

/Execute <имя файла внешней обработки>

Предназначен для запуска внешней обработки, полный путь к которой указан после параметра, в пользовательском режиме сразу после запуска программы. Если указать параметр /Execute, параметр /URL игнорируется.

/URL <адрес>

Указывает необходимость перехода по ссылке. Поддерживаются ссылки формата e1c и http(s):

• Если указана внешняя ссылка, выполняется поиск работающего клиентского прикладного приложения с такой же строкой соединения, что и в параметре. В найденной клиентской программе не должно быть открыто модальное или блокирующее окно. После этого выполняется попытка перехода по локальной ссылке из исходной навигационной ссылки и активизируется основное окно программы. В случае неудачи клиентское прикладное приложение продолжает работу. Если исходная навигационная ссылка не содержит локальной ссылки (содержит только адрес информационной базы), попытка перехода не выполняется, а сразу активизируется основное окно найденного клиентского прикладного приложения.
• Если нужное клиентское прикладное приложение не найдено, строка соединения определяется из параметра командной строки /URL.
• Если указана локальная ссылка, клиентское прикладное приложение запускается в общем порядке. После запуска выполняется попытка перехода по переданной локальной ссылке.

Для ссылок формата http(s) всегда запускается или находится активный тонкий клиент.

Другие параметры

/@ <файл с командой>

Позволяет указать командную строку запуска в файле, который является значением команды (<файл с командой>). Команда /@ предназначена для обхода ограничения длины командной строки операционной системы. В этом файле команда должна быть записана полностью, со всеми параметрами, в одну строку. Кодировка файла должна соответствовать кодировке командного интерпретатора, в котором выполняется запуск клиентской программы.

При обработке командной строки содержимое файла полностью заменит командную строку запускаемой программы. Из этого следуют два вывода:

• Команда /@ должна быть первой или единственной командой командной строки запуска программы.

1. Если команда /@ указана не первой, поведение является неопределённым.

/Out <имя файла> [-NoTruncate]

Установка файла для вывода служебных сообщений. Если установлен параметр -NoTruncate (через пробел), файл не очищается (не используется в тонком клиенте).

При выполнении пакетных команд файл сообщений можно открыть для просмотра. В пакетном режиме запуска запись сообщений в файл не буферизуется (сообщения записываются сразу).

Файл формируется в кодировке UTF-8.

/DisableStartupMessages

Отключает стартовые сообщения:

• Конфигурация базы данных не соответствует сохранённой конфигурации. Продолжить?;
• Возможностей Вашего компьютера недостаточно для редактирования справки конфигурации. Для редактирования справки необходимо установить Microsoft Internet Explorer версии 7.0 или новее.;
• Возможностей Вашего компьютера недостаточно для редактирования html-документов, в том числе разделов справки. Для редактирования html-документов необходимо установить Microsoft Internet Explorer версии 7.0 или новее. В этом запуске редактирование html-документов будет недоступно..

/DisableStartupDialogs

Отключает вызов стартового диалога и диалогов аутентификации. При этом:

• Выдаётся ошибка:

  • если командной строки недостаточно для выбора информационной базы или определения режима запуска;
  • если командной строки недостаточно для авторизации пользователя в информационной базе;
  • если в командной строке ошибочная авторизация в хранилище конфигурации;
  • если выполняется попытка создания информационной базы (CREATEINFOBASE), но для кластера серверов задан администратор.
• Если в командной строке отсутствует авторизация в хранилище конфигурации, конфигуратор запускается без связи с хранилищем.

Команда поддерживается конфигуратором, тонким и толстым клиентом. При использовании этой команды в командной строке запуска клиентского прикладного приложения включается пакетный режим запуска клиентской программы.

/DisableSplash

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

/DisableUnrecoverableErrorMessage.

Позволяет установить специальное поведение при возникновении невосстановимой ошибки, в том числе аварийного завершения:

• Окно с ошибкой не будет показано.
• В случае аварийного завершения дамп сформируется в соответствии с настройками в файле logcfg.xml (в ОС Windows) или настройками операционной системы (в ОС Linux).
• Отчёт об ошибке будет отправлен при настройке автоматической отправки отчёта об ошибке и размере отчёта не более ограничения на отправку без запроса о большом размере (5 Мбайт).
• Прикладная программа завершена с кодом возврата, отличным от нуля.

Рекомендуется указывать эту команду, если нужно запустить клиентское прикладное приложение в окружении, где не будет пользователя, который отреагирует на сообщение о невосстановимой ошибке.

/LogUI

Включает протоколирование действий пользователя.

/UseHwLicenses<режим>

Определяет режим поиска ключа защиты.

<режим> может принимать следующие значения:

• + – поиск ключа защиты выполняется.
• - – поиск ключа защиты не выполняется.

/DisplayUserNotificationList

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