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

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

Формат¶

Global.exe [<строка подключения>] [<приложение>] [<GSC файл>] [<опции> ...]

Пример¶

Global.exe dbUser/Password1@DataBase#btk SEL_ConfiguratorMainMenu /nosplash /home=D:\Oracle11 /include=formmaster /exclude=formsuper

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

Формат¶

[login[/password]]@[server[#schema]]

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

server - БД (TNS) к которой следует подключиться.
login - логин в формате [username|proxyusername\[username\]].
username - имя пользователя.
proxyusername - имя прокси пользователя.
password - пароль пользователя. Если указан прокси-пользователь то пароль будет использоваться как пароль для прокси-пользователя, указать второй пароль для не прокси-пользователя нельзя.
schema - схема подключения.

Attention

Указываемые в строке подключения имена не должны содержать символов /, @, #, используемых в ней в качестве разделителей, а также символов ; и =, используемых в качестве разделителей в формате строки подключения в стиле ODBC. Если требуется указать такое имя, его следует заключать в парные кавычки - "name", т.е. использовать квотирование. При использовании квотирования следует учитывать, что Oracle воспринимает квотированные имена как регистрочуствительные ("name" != "Name").

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@ - будет показан диалог входа с заполненным полем “Пользователь”. Поле “База данных” будет заполнено сохранённым значением из реестра - БД последнего удачного входа.

4.7.2. Приложение¶

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

Пример¶

  Global.exe SEL_ConfiguratorMainMenu

4.7.3. Командный файл¶

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

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

4.7.4. Опции¶

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

Формат¶

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

Note

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

SingleSession¶: Все формы будут открываться в сессии приложения.

nosplash¶: Не показывать окно приветствия во время загрузки клиента.

home=<значение>¶

Значение:	Путь к OracleHome.

Явно указывает с каким 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 остаётся.

4.7.5. Опции приложения¶

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