5.4. URI ссылки на выборки#

Сервис дает возможность открыть выборку с помощью запроса в URI ссылке

5.4.1. Формат URI ссылки#

Формат URI ссылки подобен формату Global1, но с некоторыми изменениями:

SERVER/[USERINFO@]BASE/[APPNAME/]SELECTION/?PARAMS

SERVER == http/https адрес сервера
USERINFO == login:password (необязательная секция)
BASE == Имя (алиас) базы данных
APPNAME == Имя приложения (необязательная секция)
SELECTION == ИмяВыборки.ИмяОтображения
PARAMS == PARAM[&PARAMS]
PARAM == [CONNECTPARAM|EXPARAM]
CONNECTPARAM == ИмяПараметра=Значение
EXPARAM == ex;ИмяПараметра=Значение

Пример:

http://server/SUPPORT/SEL_Sup_MainMenu/SEL_SUP_Error.UseCard/?user=myuser&password=mypassword&expandconnect=1&ex;Representation=UseCard&ex;EditingType=Edit&ex;idItem%23=242857310001&ex;UseActiveForm=0

Attention

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

Note

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

Без доменной авторизации будет отображён логин диалог с заполненными полями логина и пароля, переданными в ссылке

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

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

  • %25 <-> ‘%’

  • %23 <-> ‘#’

  • %20 <-> пробел

Полный список кодировок символов можно посмотреть на www.w3schools.com

5.4.1.1. Поддерживаемые параметры подключения (CONNECTPARAM)#

user#

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

Пример:

http://server/dbalias/?user=myusername
password#

Пароль

Пример:

http://server/dbalias/?user=myusername&password=mypassword
access_token#

Токен аутентификации (ключ доступа к базе)

Пример:

http://server/dbalias/?access_token=fb3f8bd977464cfb198ccc1b8f2cf291
expandconnect#

Флаг отображения расширенного диалога подключения. Принимает значения 0 и 1 (значение по умолчанию - 0)

Пример:

http://server/dbalias/?user=myusername&password=mypassword&expandconnect=1
selection#

Имя выборки

Пример:

http://server/oracle_dbalias/?selection=SEL_EXAMPLESELECTION.REPRESENTATION
http://server/postgres_dbalias/?selection=gtk-ru.bitec.app.btk.Btk_Example%23List
cspeed#

Скорость соединения. Принимает следующие значения:

  • 0 – Модем (14 Кбит/с)

  • 1 – Модем (56 Кбит/с)

  • 2 – Низкоскоростное подключение (128 Кбит/с - 2 Мбит/с)

  • 3 – Локальная сеть (Более 2 Мбит/с)

Пример:

http://server/dbalias/?cspeed=2&user=myusername
session#

ID сессии для подключения

Пример:

http://server/dbalias/?user=myusername&password=mypassword&session=719
forceconnect#

Флаг подключения к запущенной ранее сессии без промежуточного диалога выбора сессии. Принимает значения 0 и 1 (значение по умолчанию – 0)

Пример:

http://server/dbalias/?forceconnect=1&user=myusername&password=mypassword
configurator#

Флаг запуска конфигуратора. Принимает значения 0 и 1 (значение по умолчанию – 0)

Пример:

http://server/dbalias/?configurator=1&user=myusername&password=mypassword
appname#

Имя приложения

Пример:

http://server/dbalias/?appname=MY_APPLICATION
lcid#

Номер языка локализации. Реализованы локализации на:

  • Русском (ru-RU) 1049

  • Английском (en-US) 1033

Значение по умолчанию – 1049

Пример:

http://server/dbalias/?lcid=1049&user=myusername&password=mypassword
manual#

Флаг, указывающий на необходимость отображения логина диалога, даже при наличии сохранённых логина/пароля или ключа доступа

Пример:

http://server/dbalias/?manual=1

5.4.1.2. Параметры выборки (EXPARAM)#

Эти параметры будут передаваться в выборку, открываемую после запуска приложения