URI ссылки на выборки
========================

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

Формат URI ссылки
~~~~~~~~~~~~~~~~~

Формат URI ссылки подобен `формату Global1 <http://docs.global-system.ru/global1/dev/Guide/services/uri_links.html#id2>`_, но с некоторыми изменениями::

  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:: 

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

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

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

* %25 <-> '%'
* %23 <-> '#'
* %20 <-> пробел

Полный список кодировок символов можно посмотреть  на `www.w3schools.com <https://www.w3schools.com/tags/ref_urlencode.asp>`_

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

.. option:: user 

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

    Пример::

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

.. option:: password 
    
    Пароль

    Пример::

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

.. option:: access_token 
    
    :term:`Токен аутентификации` (ключ доступа к базе)

    Пример::

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

.. option:: expandconnect

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

    Пример::

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

.. option:: selection

    Имя :term:`выборки <Выборка>`

    Пример::

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

.. option:: cspeed

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

    * 0 -- Модем (14 Кбит/с)
    * 1 -- Модем (56 Кбит/с)
    * 2 -- Низкоскоростное подключение (128 Кбит/с - 2 Мбит/с)
    * 3 -- Локальная сеть (Более 2 Мбит/с)

    Пример::

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

.. option:: session

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

    Пример::

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

.. option:: forceconnect

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

    Пример::

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

.. option:: configurator

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

    Пример::

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

.. option:: appname

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

    Пример::

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

.. option:: lcid

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

    * Русском (ru-RU) 1049
    * Английском (en-US) 1033

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

    Пример::

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

.. option:: manual

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

    Пример::

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

Параметры выборки (EXPARAM)
+++++++++++++++++++++++++++++

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