Веб-клієнт

Загальна інформація

Вибір мови інтерфейсу і регіональних установок

Аутентифікація за допомогою POST-запиту

Загальна інформація

Щоб запустити веб-клієнт, потрібно відкрити веб-браузер і ввести URL інформаційної бази. Веб-браузер слід відповідно налаштувати. Одну й ту саму інформаційну базу (з однаковим URL) можна відкрити в різних вкладках одного веб-браузера.

Вибір мови інтерфейсу і регіональних установок

Мову інтерфейсу веб-клієнта можна вказати в такому порядку підвищення пріоритету:

• у налаштуваннях пріоритетних мов веб-браузера;
• у командному рядку (параметр L).

Під час вибору мови інтерфейсу виконуються такі дії:

• Під час обробки запиту до ресурсу, якому відповідає інформаційна база (наприклад, http://localhost/demo), вибирається мова локалізації:

  • за наявності в URL параметра L аналізується значення цього параметра. Якщо за результатом аналізу параметра мову не знайдено, аналізується заголовок Accept-Language;
  • за відсутності параметра в URL аналізується стандартний заголовок HTTP — Accept-Language, що містить пріоритетні мови, установлені в браузері.

• Доступна мова вибирається з набору локалізацій, установлених на веб-сервері:

  • якщо точної відповідності не знайдено (наприклад, у параметрі зазначено мову en_US), ім'я мови скорочується та виконується повторний пошук (у прикладі: en).

• Якщо під час аналізу мову не знайдено, використовується мова за замовчуванням — англійська en:

  • вибрана мова додається до базового URL програми (у прикладі виходить: http://localhost/demo/en), після чого веб-браузер автоматично перенаправляється на новий URL.

Регіональні установки сеансу веб-клієнта, що впливають на відображення значень типу Number/Число і Date/Дата, можна вказати в такому порядку підвищення пріоритету:

• у налаштуваннях пріоритетних мов веб-браузера;
• у командному рядку (параметр VL).

Регіональні установки сеансу вибираються так:

• За наявності в URL параметра VL використовуються регіональні установки, що відповідають коду з параметра. Якщо значенням параметра є код неіснуючої локалізації, робота веб-клієнта завершується з помилкою.
• За відсутності параметра VL в URL аналізується стандартний заголовок HTTP — Accept-Language, що містить пріоритетні мови, установлені в браузері.

Примітка

Веб-браузер Safari не підтримує налаштування пріоритетних мов. Замість цього використовується мова інтерфейсу операційної системи.

Аутентифікація за допомогою POST-запиту

Іноді потрібно запустити систему, оминаючи стандартне вікно аутентифікації користувачів. Це може бути необхідно під час аутентифікації через спеціалізовану форму, наприклад інтегровану в будь-який веб-сайт, або якщо логін і пароль для входу до інформаційної бази зберігаються в окремій базі даних.

Для реалізації цих вимог передбачено можливість аутентифікації сеансу веб-клієнта за допомогою POST-запиту до спеціального ресурсу інформаційної бази: e1cib/start. У такому разі запуск виконується так:

• Виконується POST-запит для аутентифікації клієнта.
• Якщо аутентифікацію виконано успішно, від імені користувача, переданого в POST-запиті, створюється сеанс.
• Запускається веб-клієнт, до командного рядка якого передаються такі параметри з POST-запиту: LowClientConnectionSpeed, LaunchParameter, LocaleCode, Zone.
• Запущений веб-клієнт підключається до аутентифікованого на кроці 2 сеансу.

Порада

Для аутентифікації рекомендовано використовувати протокол HTTPS.

У запиті передаються такі параметри:

Usr — обов'язковий

Ім'я користувача.

Pwd — необов'язковий

Пароль користувача.

Значення за замовчуванням: порожній рядок.

LowClientConnectionSpeed — необов'язковий

Швидкість з'єднання.

Можливі значення:

• on — низька швидкість з'єднання.
• off — нормальна швидкість з'єднання (значення за замовчуванням).

LaunchParameter — необов'язковий

Параметри, які потрібно передати в прикладне рішення (аналог параметра C командного рядка веб-клієнта).

Значення за замовчуванням: порожній рядок.

SystemLanguage — необов'язковий

Мова інтерфейсу. Якщо не задано, визначаються мова інтерфейсу та регіональні установки.

LocaleCode — необов'язковий

Код локалізації сеансу. Якщо не задано, визначаються мова інтерфейсу та регіональні установки.

Zone — необов'язковий

Значення роздільників.

AuthFailHandling — необов'язковий

Визначає поведінку системи в разі помилки аутентифікації. Можливі значення:

• error — повертає код помилки (код помилки — 402) і текст повідомлення про помилку;
• start — запускається веб-клієнт із запитом аутентифікації засобами системи;
• redirect — здійснюється перехід на URL, заданий параметром AuthFailRedirectURL.

Значення за замовчуванням: error.

AuthFailRedirectURL — необов'язковий

Містить URL, на який потрібно перейти в разі помилки аутентифікації, якщо для параметра AuthFailHandling встановлено значення redirect. URL має бути абсолютним.

Примітка

Параметри, передані в тілі запиту, мають пріоритет над параметрами командного рядка для запуску веб-клієнта.

Приклад.

Нижче наведено приклад HTML-сторінки, що демонструє роботу власної форми аутентифікації для інформаційної бази, розташованої за адресою http://localhost/demoapp.

<HTML xmlns="http://www.w3.org/1999/xhtml"><HEAD>
<META http-equiv="Content-Type" content="text/html; charset=utf-8" />
<BODY>
<FORM action="http://localhost/demoapp/e1cib/start" method="post">
    Користувач: <INPUT id="usr" name="usr" /><BR />
    Пароль: <INPUT id="pwd" type="password" value="" name="pwd" />
    <BR />Низька швидкість: <INPUT id="lowclientconnectionspeed" type="checkbox" name="lowclientconnectionspeed" /><BR />
    Параметр запуску: <INPUT id="launchparameter" name="launchparameter" /><BR />
    Мова інтерфейсу: <SELECT id="systemlanguage" name="systemlanguage">
        <OPTION value="uk" selected="">Українська</OPTION>
        <OPTION value="en">Англійська</OPTION>
    </SELECT><BR />
    Код локалізації сеансу: <SELECT id="localecode" name="localecode">
        <OPTION value="uk" selected="">Українська</OPTION>
        <OPTION value="en">Англійська</OPTION>
    </SELECT><BR />
    Область даних: <INPUT id="zone" name="zone" />
    <INPUT id="authfailhandling" type="hidden" value="error" name="authfailhandling" /> 
    <P><INPUT type="submit" value="ОК" /> </P>
</FORM>
</BODY>
</HTML>

У результаті буде показано таку форму аутентифікації:

Форма POST-запиту