<< Щелкните, чтобы показать Содержание >> Разработчику > Объектная модель IS-Builder > Объекты IS-Builder > Доступ к системе > ILoginPoint – точка входа

Метод GetApplication – получить приложение

Contents

Синтаксис:

function GetApplication(

const ConnectParams: WideString;

[optional] const StoreInCache: WordBool = True): OleVariant;

Параметры:

•	ConnectParams – параметры соединения. Передаются в формате:

<Параметр1>=<Значение1>;<Параметр2>=<Значение2>;<ПараметрN>=<ЗначениеN>

В параметрах соединения нужно указать код системы (SystemCode) либо имя сервера и имя базы данных (ServerName и DBName). Остальные параметры являются необязательными.

UserName. Имя пользователя.

Password. Пароль пользователя.

IsOSAuth. Признак использования Windows-аутентификации. Возможные значения: True, False.

Рекомендуется вместо параметра IsOsAuth использовать параметр AuthType.

AuthType. Тип аутентификации. Возможные значения:

•	OS – выполнить соединение с использованием Windows-аутентификации;

•	NOVELL – выполнить соединение с использованием Novell-аутентификации.

IsVirtualPassword. Признак аутентификации по перекодированному паролю. Возможные значения: True, False.

Необходимо указать один из вышеперечисленных параметров в зависимости от типа аутентификации пользователя. Если тип аутентификация пользователя – «По паролю», в параметре IsVirtualPassword укажите значение False, а в параметре Password – пароль пользователя.

KeepLoginPoint. Признак необходимости хранения явной ссылки на SBLogon. Возможные значения: True, False. Если указать значение False, SBLogon выгрузится сразу после запуска приложения. Например, это удобно, когда при разработке сценария нужно выполнить операцию от имени другого пользователя или с другим кодом системы. В этом случае SBLogon загрузится снова с выполнением всех необходимых проверок. Если указать значение True, SBLogon останется загруженным. Это влияет на скорость работы: обращение к SBLogon будет происходить быстрее, так как данные получаются из кэша. Значение по умолчанию True.

InteractiveMode. Признак интерактивного режима работы (с показом форм, сообщений об ошибках и т.д.). Возможные значения: True, False. Значение по умолчанию True.

LiteMode. Получение приложения для доступа к основной информации о документе.

InstallationID. ИД инсталляции.

NovellServerName. Имя сервера Novell. Используется только при Novell-аутентификации.

PID. Идентификатор процесса. Возможные значения:

•	-1 – объект приложения создается в новом процессе SBRte;

•	идентификатор запущенного процесса SBRte – объект приложения создается в процессе, идентификатор которого указан;

•	параметр не указан – объект приложения создается без явного указания процесса.

Параметр PID позволяет параллельно запускать вычисления в разных процессах SBRte, вызываемых через объектную модель;

•

StoreInCache – признак необходимости добавления информации о соединении в кэш: True, если нужно добавить информацию, иначе False. Если в качестве значения параметра StoreInCache передать False, то при использовании аутентификации SQL-сервера при каждом получении приложения с такими же параметрами соединения будут запрашиваться параметры соединения.

В качестве значения параметра соединения AuthType следует передавать OS, если нужно выполнить соединение с Windows-аутентификацией, NOVELL, если нужно выполнить соединение с Novell-аутентификацией.

Возвращаемое значение:

Приложение для указанной системы. Метод возвращает объект IApplication или ILiteApplication.

Описание:

Метод создает и возвращает объект-приложение для указанной системы. Если не удалось подключиться к системе с переданными параметрами, появится сообщение об ошибке, а затем окно входа в систему, в котором можно указать верные параметры.

Пример