Интеграция с системой мониторинга транспорта Wialon

Для работы с Wialon Hosting требуется получить токен.

Для этого необходимо перейти по ссылке и указать пользователя и пароль. У пользователя должны быть права для работы с внешними программами. Для получения прав необходимо обратиться в поддержку Wialon Hosting.

После ввода данных, появляется окно «Авторизация успешна» и в адресной строке токен:

http://hosting.wialon.com/login.html?lang=ru&access_token=e**********************************************************************F&user_name=admin&svc_error=0.

Токен необходимо сохранить для дальнейшего использования в сценарии.

Важно: Необходимо сохранять приватность токена. Его публикация дает любому человеку доступ к данным.

В Переменных пользователя задается токен и другие данные для запросов.

Переменные пользователя:

Имя	Метка	Значение
token	Токен	e*********************************************************************F
mask_object	Маска наименования объекта	Iveco*
time_from	Начало интервала	01.07.2022, 00:00
time_to	Окончание интервала	19.07.2022, 00:00
count_message	Количество сообщений	100

С помощью этой подмодели пользователь авторизуется в системе прямо из сценария. Без авторизации невозможно получить данные.

1. На вход подмодели Авторизация подается токен, который с помощью узла Сборка URL собирается в URL-адрес:

   https://hosting.wialon.com/login.html?lang=ru&wialon_sdk_url=https%3A%2F%2Fhst%2Dapi%2Ewialon%2Ecom&access_token=e*********************************************************************F&user_name=test_loginom_mgr&svc_error=0.

2. На странице Подключения настроено подключение REST-сервис:

   • URL сервиса: https://hosting.wialon.com/login.html?lang=ru&wialon_sdk_url=https%3A%2F%2Fhst%2Dapi%2Ewialon%2Ecom&access_token=e*********************************************************************F&user_name=test_loginom_mgr&svc_error=0
   • Метод: GET
   • Типа авторизации: Не требуется

   На основе этого подключения в сценарии создан производный узел REST-сервис, на вход которого передается URL, собранный в узле Сборка URL. Настройки узла REST-сервис:

   • переключатель слева от параметра URL-сервиса установлен в положение использования переменных;
   • остальные настройки по умолчанию.

3. REST-запрос для авторизации отправляет запрос к веб-сервису для авторизации и возвращает ответ в формате json.

4. С помощью узла Соединение ответа и статуса запроса объединяется строка авторизации и данные о наличии или отсутствии ошибок при выполнении запроса.
5. Узел Таблица в переменные преобразовывает данные из табличных значений в переменные.

Алгоритм работы подмодели Получение ID сессии такой же, как и у Авторизации. Ответ содержит данные об идентификаторе сессии, который извлекается узлом Извлечение ID сессии, с помощью следующей функции:

right(RegExMatchedExp("eid"":""[a-zA-Z0-9]+", Response), Count(RegExMatchedExp("eid"":""[a-zA-Z0-9]+", Response)) - 6).

Идентификатор сессии – это переменная сессии, посредством которой происходит идентификация клиента:

Имя	Метка	Значение
sid	Идентификатор сессии	5******************************d

1. На вход подмодели Запрос получения ID объектов подается идентификатор сессии и маска автомобиля. Эти параметры объединяются узлом Соединение ID сессии и маски наименования объекта.

2. С помощью узла Сборка URL объединенные данные собираются в URL-адрес:

   https://hst-api.wialon.com/wialon/ajax.html?sid=5******************************d&svc=core/search_items&params={"spec":{"itemsType":"avl_unit","propName":"sys_name","propValueMask":"Iveco*","sortType":"sys_name","propType":"sys_name,rel_user_creator_name","or_logic":0},"force":1,"flags":1,"from":0,"to":0}.

3. Узел REST-сервис, созданный на основе ранее настроенного подключения, принимает на вход URL-адрес. Настройки узла:

   • переключатель слева от параметра URL-сервиса установлен в положение использования переменных;
   • остальные настройки по умолчанию.

4. Узел REST-запрос для получения ID объектов отправляет запрос к веб-сервису и возвращает ответ в формате json.

5. В узле Таблица в переменные данные о наличии или отсутствии ошибок при выполнении запроса преобразовываются в переменную.
6. Ответ в json-формате содержит данные об автомобилях, которые подвергаются обработке с помощью подмодели Парсинг JSON.

Информация об объектах:

Наименование автомобиля	Идентификатор транспорта	Идентификатор класса	Уровень доступа к объекту
Iveco	6** *** **2	2	8** *** *** **7,**
Iveco 1	6** *** **0	2	8** *** *** **7,**
Iveco Daily	1* *** **1	2	5** *** *** **9,**
Iveco Daily1	6** *** **2	2	8** *** *** **7,**

Алгоритм получения сообщения от объектов:

1. На вход подмодели Данные о геолокации объектов подается идентификатор сессии, таблица об автомобилях и переменные, представленные временным интервалом и количеством сообщений.
2. Идентификатор сессии и информация об автомобилях объединяются в одну таблицу в узле Соединение ID сессии и информации об автомобилях.
3. Входные переменные подаются на узел Преобразование Даты/времени в UNIX-формат, где данные типа Дата/время преобразовываются в строковый UNIX-формат (только такой формат времени поддерживается запросами wialon).
4. В узле Сборка URL и подсчет количества автомобилей идентификаторы сессии и автомобилей собираются в URL-адреса, а также производится подсчет количества автомобилей, соответствующих маске. Выходные данные передаются на вход подмодели Запрос и парсинг.
5. На входе подмодели Запрос и парсинг создана переменная ID, которая отвечает за номер запроса.
6. Алгоритм работы подмодели Запрос получения геоданных от объектов такой же, как у рассмотренной ранее подмодели Запрос получения ID объектов. Результат запроса подвергается обработке с помощью подмодели Парсинг JSON.
7. В подмодели Идентификация запроса проверяется равенство ID с Количеством автомобилей, это сравнение происходит по Циклу до тех пор, пока переменные не будут равными (выполнится запрос по всем автомобилям).
8. В выходном наборе данных даты UNIX-формата преобразуются в тип Дата/время.

Сообщения от объектов:

Наименование автомобиля по id	Номер автомобиля по id	Время регистрации сообщения	...	Долгота	Широта	Высота над уровнем моря
Iveco	6** *** **2		...
Iveco 1	6** *** **0	17.07.2022, 00:17	...	39,73	54,62	134,20
...	...	...	...	...	...	...
Iveco Daily	1* *** **1	01.07.2022, 05:02	...	37,55	55,75	0
...	...	...	...	...	...	...
Iveco Daily1	6** *** **2