Специальные параметры запуска

Параметр /IBName

Параметр /AppAutoCheckVersion

Параметр /AppAutoCheckMode

Параметр url

Параметр /IBName

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

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

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

Примечание

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

Параметр /AppAutoCheckVersion

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

Если в строке запуска указан параметр /AppAutoCheckVersion, система работает по следующему алгоритму:

• Определяется версия для запуска информационной базы: для файлового варианта информационной базы — по параметру Version файла *.v8i, а для клиент-серверного варианта — «по ответу» сервера системы.
• Если указан полный номер версии, выполняется поиск нужной версии (параметры InstalledLocation конфигурационных файлов). Если нужная версия не установлена на компьютере, выполняется поиск дистрибутива этой версии (параметры DistributiveLocation конфигурационных файлов). Если дистрибутив найден, устанавливается нужная версия, а если нет — запуск прекращается с выводом сообщения об ошибке.
• Если указан неполный номер версии, выполняется попытка получить нужный номер среди имеющихся версий (параметр DefaultVersion конфигурационных файлов). Если установить полный номер версии не удалось, выполняется поиск самой новой установленной версии (параметры InstalledLocation конфигурационных файлов) и самой новой версии, доступной для установки (параметры DistributiveLocation конфигурационных файлов). Если номер версии, доступной для установки, больше номера версии, установленной на компьютере, происходит установка версии с большим номером.

Параметр /AppAutoCheckMode

С помощью этого параметра можно автоматически «подобрать» для запуска вариант клиентской прикладной программы, необходимый для работы.

Если в строке запуска программы указан параметр /AppAutoCheckMode, система:

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

Параметр url

Этот параметр позволяет перейти по навигационной ссылке в запущенной клиентской прикладной программе при соблюдении определённых условий. Такой параметр доступен в программе запуска тонкого и толстого клиента.

Общая схема работы с этим параметром:

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

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

• Выполняется поиск запущенной клиентской прикладной программы, обслуживающей информационную базу с указанной в значении параметра строкой соединения. Регистр имени хоста и информационной базы не влияет на поиск. Также при поиске DNS-имя не преобразуется в IP-адрес и наоборот. Это означает, что клиентская прикладная программа не будет найдена, если в строке соединения клиентская прикладная программа использует DNS-адрес, а во внешней ссылке указан IP-адрес.
• Если прикладная программа найдена и в ней не открыто модальное окно или окно, блокирующее весь интерфейс, прикладная программа активизируется и выполняется попытка перехода по внутренней ссылке, полученной из внешней ссылки, переданной как значение параметра командной строки /url клиентской прикладной программы.
• Если прикладная программа найдена и в ней открыто модальное окно или окно, блокирующее весь интерфейс, найденная прикладная программа игнорируется, а система продолжает поиск.
• Если прикладная программа не найдена, запускается новая клиентская прикладная программа, которой в параметре /url передаётся внутренняя навигационная ссылка, полученная из исходной ссылки.
• Если навигационная ссылка, переданная программе запуска или клиентской прикладной программе, содержит только адрес информационной базы (например, e1c://host/ib-name), после открытия клиентской прикладной программы никаких действий не выполняется.

При переходе по внутренней навигационной ссылке выполняются следующие действия:

• Попытка перехода выполняется после вызова обработчика OnStart/ПриНачалеРаботыСистемы.
• Если клиентская прикладная программа работает в режиме Формы в отдельных окнах и внутренняя ссылка является ссылкой на точку навигации, вместо открытия рабочего стола выполняется переход по ссылке. Иначе форма открывается после открытия рабочего стола.
• При возникновении ошибки выводится диагностическое сообщение, а прикладная программа продолжает работу.

Если в командной строке запуска указано несколько параметров, то:

• указание параметра /Execute приводит к игнорированию параметра /url;
• указание в параметре /url абсолютной навигационной ссылки приводит к игнорированию параметров соединения с информационной базой, указанных в других параметрах. Игнорируются следующие параметры командной строки: /F, /S, /WS, /IBName. Для параметра /IBConnection игнорируются части строки соединения, описывающие информационную базу.

Для перехода можно использовать внешние навигационные ссылки, применяющие следующие схемы:

• e1c: — толстый и тонкий клиенты;
• http: или https: — только тонкий клиент.

Выполнить действие, эквивалентное использованию параметра /url, можно с помощью:

• метода встроенного языка GotoURL()/ПерейтиПоНавигационнойСсылке();
• специального диалога из окна со списком информационных баз;
• стандартной формы полнотекстового поиска (только для схемы e1c:).