ІНСТРУКЦІЯ

Підключення мобільного застосунку PULSE.Wemobile

Покрокова інструкція зі встановлення розширення та налаштування мобільного додатку.

Починаючи з версії платформи BAF 8.3.12 і вище

Обмін даними між обліковою системою BAS і мобільним застосунком PULSE.Wemobile

Покрокова інструкція

«PULSE.Wemobile»: підключення розширення та налаштування мобільного додатку

Для початку скачайте файл «PulseWemobile.cfe» в завантаженому архіві.

Відкрийте Конфігуратор і в головному меню перейдіть до “Розширення конфігурація“: Конфігурація → Розширення конфігурації:

Додайте нове розширення з такими даними:

Ім’я: PulseWemobile
Префікс: PWM_
Призначення: Доповнення

Завантажте файл розширення (PulseWemobile. cfe) натиснувши один раз на рядок з щойно доданим розширенням і у вікні «Розширення конфігурації»: Конфігурація –> Завантажити конфігурацію з файлу…

При появі помилок з сумісністю розширення з вашою конфігурацією (режиму сумісності, мови, тощо) натискайте «Виправити» (справа) та погоджуйтеся на рекомендовані зміни.

Зніміть прапорець (галочку) у колонці Безпечний режим, оскільки HTTP-сервіс розширення має взаємодіяти з мережевими запитами від мобільного додатка:

Оновіть базу даних:

Для користувачів, які будуть використовувати мобільний застосунок для підключення до бази, додайте нову роль з розширення:

Важливо: Рекомендуємо виконувати власноруч ЛИШЕ якщо ви розумієте, що таке веб-сервер та публікація на ньому HTTP-сервісу!

Щоб мобільний застосунок міг надсилати запити до бази даних, її необхідно опублікувати на веб-сервері (IIS або Apache). Для цього також необхідно, аби ваш сервер мав статичний зовнішній IP, щоб бути помітним для глобальної мережі.

Запустіть Конфігуратор від імені адміністратора операційної системи. Щоб це зробити, перемістіть курсор (стрілочку) миші на значок програми та один раз натисніть праву кнопку миші. На екрані з’явиться список додаткових команд (контекстне меню)

Відкрийте меню Адміністрування –> Публікація на веб-сервері…

2. У вікні налаштувань зніміть усі зайві галочки та:

вкажіть ім’я публікації й каталог на сервері;
на вкладці HTTP-сервіси увімкніть «Публікувати HTTP-сервіси розширень за замовчуванням».

Має вийти приблизно так:

3. Натисніть кнопку Опублікувати. Система запропонує перезапустити веб-сервер (IIS/Apache) — погоджуйтеся.

Важливо: Вартує зазначити, що якщо дана публікація робить вашу базу доступню і для звичайного входу через так званий «Веб-клієнт». Тому це треба вимкнути на рівні веб-серверу.

Далі показано приклад для вбудованого у Windows веб-серверу IIS:

Зайдіть в каталог, який був вказаний на попередньому кроці (заповнився автоматично). Скоріше за все це «C:\inetpub\wwwroot\pulse-wemobile».

Там буде файл «default.vrd». Відкрийте його в текстовому редакторі та у тегу < point> (є кореневим) додайте атрибут enable=”false”.

Приклад:

<?xml version=”1.0″ encoding=”UTF-8″?>

<point xmlns=”http://v8.baf.com.ua/8.3/virtual-resource-system”

xmlns:xs=”http://www.w3.org/2001/XMLSchema”

xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”

base=”/ім’я бази”

ib=”File="шлях-до-бази";”

enable=”false”> <!– Вимикає доступ для веб- та тонкого клієнта –>

В режимі Підприємство (не Конфігуратор) знайдіть та відкрийте регістр відомостей «Налаштування підключення мобільного застосунку (PWM)» в підсистемі Pulse.Wemobile і натисніть на нього

2. Натисніть «Встановити налаштування»:

3. Введіть адресу вашого серверу (повну включаючи URI HTTP-сервісу, що додавався на кроці 2), та згенеруйте «Ідентифікатор»:

4. (Опціонально) Оскільки кожне підключення під новим користувачем буде хоч і короткостроково, але забирати на себе одну ліцензію вашої бази, то у разі, якщо ви бажаєте заощадити ліцензії, то додатково можете у групі Авторизація цієї форми вказати «технічного користувача»:

В цьому разі разі користувачі мобільного застосунку все одно зможуть заходити в нього під своїми логіном та паролем, але при безпосередньому підключенні до BAF сеанс автоматично створюватиметься під вказаним технічним користувачем.

Також, щоб ліцензії дійсно гарантовано заощаджувалися на рівні веб-серверу треба у файлі публікації це вказати. Далі показано приклад для вбудованого у Windows веб-серверу IIS: Зайдіть в каталог, який був вказаний на кроці 2.2. Скоріше за все це «C:\inetpub\wwwroot\pulse-wemobile». Там буде файл «default.vrd». Відкрийте його в текстовому редакторі та у блоці < httpServices > (зручніше за все у його кінці одразу перед </httpServices>) додайте такий блок:

<!– ДОДАЄМО!!! – Налаштування пулу на 1 постійний сеанс, щоб не з’їдало ліцензії –>

<service name=”PulseWemobile:PWM_Mobile”

rootUrl=”pwm_mobile”

enable=”true”

reuseSessions=”autouse”

sessionMaxAge=”120″

poolSize=”1″

poolTimeout=”40″>

</accessTokenAuthentication>

</service>
Також оскільки ми явно описали http-сервіс, то в цьому файлі варто додатково вимкнути публікацію веб-серверів за-замовчуванням, щоб у разі наявності в базі http-сервісів інших розширень вони не були опубліковані.
Для цього атрибути «publishByDefault» та «publishExtensionsByDefault» тегу <httpServices> мають бути false:
Замініть:
<httpServices publishByDefault=”true”

publishExtensionsByDefault=” true “> щадити ліце

На: <httpServices publishByDefault=”false” publishExtensionsByDefault=”false”>

5. Після цього на формі налаштувань натисніть «Зберегти» і потім «Відправити». На екрані ви побачите QR-код для швидкої авторизації в мобільному застосунку.

Якщо ви бажаєте, щоб вам на телефон приходили повідомлення («пуші»), коли в BAS відбуваються якісь зміни за підтримуваними метриками, то для цього необхідно додати додаткову обробку PWM_РегламентніЗавдання.epf:

2. Для її команд Зібрати події та Відправити події задайте потрібний розклад.

3. Після чого збережіть зміни.

Залишилось найприємніше. Для входу вам знадобляться:

QR-код – той, що ви згенерували на кроці 3.5;
логін і пароль вашого користувача бази – ті самі, з якими ви заходите в BAS (користувачу має бути призначена роль з кроку 1)

Як увійти: