5.7. Параметры командной строки

Параметры командной строки - параметры передаваемые клиенту Global.exe при запуске. Они регламентируют режим работы клиента или уточняют параметры запуска, которые при обычном запуске запрашиваются диалогами (диалог входа, выбора приложения).

Формат
Global.exe [<строка подключения>] [<приложение>] [<GSC файл>] [<опции> ...]
Пример
Global.exe dbUser/Password1@DataBase#btk SEL_ConfiguratorMainMenu /nosplash /home=D:\Oracle11 /include=formmaster /exclude=formsuper

5.7.1. Строка подключения

Формат
[login[/password]@][server[#schema]]

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

  • server - БД (TNS) к которой следует подключиться.
  • login - логин.
  • password - пароль.
  • schema - схема подключения.

Hint

Передавая строку подключения в параметрах командной строки нельзя указать в качестве строки подключения один только сервер. Для этого следует писать: @server или /@server.

Причина в том, что в качестве параметра командной строки server не будет распознан как строка подключения.

Если заданы login, password и server, то при старте Global подключение к базе будет устанавливаться без диалога. Диалог будет показан только в случае неудачной попытки подключения.

Если схема подключения не указана, то по умолчанию используется схема btk

Примеры:
  • Global.exe dbUser/Password1@DataBase#btk - сразу будет выполнен вход в базу данных DataBase, под пользователем dbUser с паролем Password1.
  • Global.exe dbUser@DataBase - При запуске клиента будет показан диалог входа, где требуется указать пароль.
  • Global.exe @DataBase, Global.exe /@DataBase - будет показан диалог входа с заполненным полем "База данных". Поле "Пользователь" будет заполнено сохранённым значением из реестра - логин последнего удачного входа.
  • Global.exe dbUser@ - будет показан диалог входа с заполненным полем "Пользователь". Поле "База данных" будет заполнено сохранённым значением из реестра - БД последнего удачного входа.

5.7.2. Приложение

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

Пример
  Global.exe SEL_ConfiguratorMainMenu

5.7.3. Командный файл

Путь к существующему файлу с расширением *.gsc. Этот файл будет прочитан и выполнен. Выполняется по возможности в одном из уже запущенных клиентов Global, если это возможно, или запускается новый клиент.

Тип файла *.gsc должен быть проассоциирован в ОС с приложением Global.exe, тогда двойной клик будет автоматически выполнять команду описанную в файле - запускать приложение Global с указанием этого файла.

See also

Подробнее о возможностях и формате

5.7.4. Опции

Формат
  /<имя параметра>[=<значение>[,<значение> ...]]

Note

Исключением является префикс /@. Он служит для указания строки подключения.

/SingleSession все формы будут открываться в сессии приложения
/nosplash не показывать окно приветствия во время загрузки клиента
/home=<значение>
 явно указывает с каким OracleHome работать, в случае если установлено несколько Oracle.
/eo=<значение> системное имя операции основной главной выборки, операция будет выполнена после загрузки приложения.
/uri=<значение>
 Подробнее об URI ссылках
/pv=<значение> (<имя параметра>=<значение>)[;<имя параметра>=<значение> ...] параметры операции, которые будут добавлены в главную выборку приложения. Параметр актуален, только если задан параметр /eo. Можно получить командой GetVar('ParamName');
/ld=<значение>

(std|tsd [/lcp=<имя метода> [/lcm=<имя dll>]] /lcip=<строка параметров>) - задать используемый диалог авторизации клиентом (окно логина).

  • std - стандартный вариант диалогового окна, используется по умолчанию без указания параметра
  • tsd - диалог для Терминалов Сбора Данных
    • осуществляет ввод логина через Штрих-код.
    • если в параметрах командной строки была передана строка соединения клиента, то диалог не даст сменить сервер. Чтобы просто заблокировать возможность изменения сервера необходимо передать неполную строку соединения: "server#schem".
    • ProcName - наименование метода преобразования "Штрих-кода" в "Стандартный логин системы". Если параметр не задан - по умолчанию применяется метод поиска логина в БД Oracle ("OraLoginConverter")
    • dll-name - библиотека в которой расположен ProcName, по умолчанию, если параметр не задан - метод ищется в самом клиенте Global.
    • StrParams - строка инициализации/настройки метода преобразования ШК-логин; для OraLoginConverter она имеет вид: /lcip=stdConnectionString;oraMethod
      1. stdConnectionString - стандартная строка подключения.
      2. oraMethod - серверный метод который будет вызываться для преобразования: 1 входной параметр типа varchar и возвращаемый результат типа varchar. Имеет значение по умолчанию "ac_userapi.FindByBarcode", в этом случае строка параметров будет иметь вид /lcip=user/password@server#schem.
/lookandfeel=<значение>
 

(Flat|Standard|UltraFlat|Native) изменить стиль отображения элементов интерфейса.

Если указан этот параметр настройка стиля из реестра игнорируется, но возможность менять стиль через TbtkScriptSkinControllerObject.LookAndFeel остаётся.

See also

/skin=<значение>
 

изменить тему приложения.

Если указан этот параметр настройка темы из реестра игнорируется, но возможность менять тему через TbtkScriptSkinControllerObject.ActiveSkinName остаётся.

See also

/include=<значение>, /i=<значение>
 (<значение>)[,<значение> ...] включение опций приложения
/exclude=<значение>, /e=<значение>
 (<значение>)[,<значение> ...] отключение опций приложения. Противоположна команде /include

5.8. Опции

Имя (сокращение) Значение по умолчанию Описание
formsuper (fs) Включена Если опция включена мастером главной выборки формы является создавшая её выборка. В противном случае, мастером является главная выборка приложения.
formmaster (fm) Выключена Определяет поведение скриптового метода Selection.Master для главной выборки формы. Если включена, Selection.Master вернет выборку, создавшую форму. В противном случае Selection.Master вернет мастера в соответствии с иерархией мастер-деталь.
singlesession (ss) Выключена Все формы будут открываться в сессии приложения (аналог ключа /SingleSession).
threadsstack (ts) Выключена

Собирать стеки всех потоков для записи в файл отчета при возникновении исключения. Если опция отключена, то будет собираться только стек потока исключения.

Warning

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