В разделе «Ретрансляция» WALIOT.Админ инженер настраивает передачу телеметрии объектов во внешние системы: заводит сервер ретрансляции с адресом приемника и протоколом (ЕГТС, Wialon IPS и Retranslator, НАВТЕЛЕКОМ FLEX и другие) и привязывает к нему объекты.
Waliot передает данные в ЭРА-ГЛОНАСС, ФГИС ЛК и РНИС ретрансляцией по ЕГТС (адреса — в реестре получателей); требования к аппаратуре спутниковой навигации выполняет сертифицированное оборудование. Ретрансляция передает данные и в корпоративные платформы. Сервер ретрансляции задается адресом «хост : порт» и протоколом, привязывается к организации, а к нему привязываются ретранслируемые объекты (транспортные средства). Состав передаваемых данных по каждому протоколу и принцип работы отправки приведены на странице Ретрансляция данных во внешние системы.
💡 Этот раздел управляет исходящей ретрансляцией — из платформы во внешние системы. Прием данных из внешних систем (входящая ретрансляция) здесь не настраивается: чужая платформа направляет данные на порты приема ретрансляции Waliot (см. Входящая ретрансляция и Совместимое оборудование и протоколы). Флажок «Ретрансляция из сторонней системы» и статус «Ретранслируемая» у объекта (см. Объекты) — пометки, которые ставятся вручную и на прием не влияют. Пока данные идут через ретранслятор сторонней системы, имена атрибутов телеметрии определяет протокол этой системы; после перевода трекера на прямое подключение к платформе имена меняются, поэтому выражения датчиков, настроенные на прежние имена, нужно пересмотреть — см. Таблица соответствия имен параметров. Раздел доступен пользователям с правом «Расширенный доступ администратора», которое можно выдать роли «Расширенный администратор»; у остальных вкладка скрыта.
¶ Возможности раздела
- Создание, редактирование и удаление серверов ретрансляции (в том числе групповое удаление);
- Выбор протокола передачи данных из 11 поддерживаемых вариантов;
- Задание адреса сервера-приемника (хост и порт), а для протокола SOAP — логина и пароля;
- Включение и выключение ретрансляции (статус «Активен» / «Неактивен»);
- Назначение ретранслируемых объектов через дерево организаций, групп и транспортных средств;
- Просмотр количества ретранслируемых объектов и состояния отправки по каждому объекту (последняя успешная отправка и последняя попытка);
- Повторная отправка накопленной телеметрии за выбранный период («Отправить историю»);
- Просмотр журнала обмена с внешним сервером через «Аудит ретрансляции».
¶ Структура раздела
Интерфейс раздела состоит из дерева организаций слева и основной таблицы серверов ретрансляции по центру. Выбор организации в дереве фильтрует таблицу по этой организации и вложенным в нее (подробнее о дереве — в разделе Интерфейс).
¶ Основная таблица
В таблице перечислены серверы ретрансляции выбранной ветви дерева. По умолчанию видимы все столбцы, сортировка — по столбцу ID по убыванию. Доступны столбцы:
- № — порядковый номер строки;
- ID — уникальный идентификатор сервера ретрансляции;
- Название организации — организация, которой принадлежит сервер;
- Статус — состояние ретрансляции: «Вкл.» или «Выкл.»; отражает переключатель «Активен» сервера, а не ошибки связи — ошибки доставки смотрят в аудите ретрансляции;
- Хост — адрес сервера-приемника (IP-адрес или доменное имя);
- Порт — TCP-порт сервера-приемника;
- Протокол — протокол передачи данных (см. Протоколы ретрансляции);
- Ретранслируемые — количество объектов, привязанных к серверу;
- Логин — логин авторизации (используется протоколом SOAP); копируется кнопкой;
- Пароль — пароль авторизации (используется протоколом SOAP); копируется кнопкой;
- Комментарий — произвольная заметка; ее используют как название сервера — отдельного поля «Название» у сервера нет.
Нажатие на строку открывает карточку сервера справа. Общие элементы таблицы (поиск, сортировка, настройка столбцов, экспорт) описаны в разделе Интерфейс.
¶ Создание сервера ретрансляции
Чтобы добавить сервер, нажмите кнопку «Создать» на верхней панели таблицы, заполните поля формы «Сервер ретрансляции» и нажмите «Сохранить». Сервер создается в текущей организации администратора — той, под которой выполнен вход. Поля формы:
- Активен — переключатель включения ретрансляции; включите его, иначе данные не передаются. При выключенном состоянии сервер и настройки сохраняются, но платформа данные не передает;
- Хост (обязательное) — адрес сервера-приемника (IP-адрес или доменное имя); для протокола SOAP указывается полный URL-адрес приемника;
- Порт (обязательное) — TCP-порт; целое число в диапазоне 0–65535;
- Протокол (обязательное) — протокол передачи данных из выпадающего списка (см. Протоколы ретрансляции);
- Логин и Пароль — появляются только при выборе протокола SOAP (НИС ГЛОНАСС) и используются для HTTP-авторизации на приемнике, когда заданы оба поля;
- Комментарий — необязательное текстовое поле, в нем записывают назначение сервера.
Для всех протоколов, кроме SOAP, платформа подключается к приемнику напрямую по TCP на указанные хост и порт; для SOAP передача идет по HTTP. В рамках одной организации сочетание «хост + порт + протокол» должно быть уникальным — второй такой же сервер платформа не создаст. Адрес, порт и протокол сообщает оператор принимающей системы; адреса и порты популярных получателей — в разделе Реестр популярных ретрансляций, как выбрать протокол — на странице Ретрансляция данных во внешние системы.
💡 Обязательны для заполнения: хост, порт и протокол. Привязать ретранслируемые объекты можно после создания сервера — в режиме редактирования (см. Назначение объектов и редактирование).
¶ Протоколы ретрансляции
Протокол выбирается из выпадающего списка. Поддерживаются 11 протоколов: ЕГТС (с авторизацией), ЕГТС (с авторизацией, расширенный), ЕГТС (без авторизации), ЕГТС (без авторизации, расширенный), Wialon IPS 1.1, Wialon IPS 1.1 (расширенный), Wialon IPS 2.0, Wialon IPS 2.0 (расширенный), SOAP (НИС ГЛОНАСС), Wialon Retranslator 1.0 и FLEX 1.0 (НАВТЕЛЕКОМ). Вариант «расширенный» означает передачу показаний датчиков и дополнительного оборудования сверх базовых навигационных данных. Полная таблица протоколов с составом передаваемых полей — на странице Ретрансляция данных во внешние системы.
Каждому протоколу нужен определенный идентификатор у трекера объекта: ЕГТС с авторизацией — IMEI и серийный номер, ЕГТС без авторизации — серийный номер, остальные протоколы (Wialon IPS, Wialon Retranslator, SOAP, FLEX) — IMEI. Если нужный идентификатор у трекера не заполнен, данные объекта не отправляются, а в журнал ретрансляции записывается ошибка. В протоколе SOAP объекты идентифицируются по IMEI, а логин и пароль относятся к доступу к самому серверу-приемнику.
¶ Карточка сервера ретрансляции
При нажатии на строку в таблице справа открывается карточка сервера. В ней отображаются:
- счетчик «Объекты ретрансляции» — количество привязанных объектов;
- индикатор «Активен» / «Неактивен» (только отображение — переключить ретрансляцию можно в режиме редактирования) и кнопка «Аудит ретрансляции»;
- основные данные: ID, хост, порт, протокол, логин, пароль;
- поле «Комментарий» (если заполнено);
- блок «Родительская организация» — переход к организации, кнопки «Войти под организацией» и «Объекты организации» (см. Организации);
- кнопка «Отправить историю» (неактивна, пока к серверу не привязан ни один объект);
- в нижней части — кнопки «Редактировать данные» и «Удалить сервер ретрансляции».
«Аудит ретрансляции» открывает журнал обмена с внешним сервером: успешные ретрансляции, ошибки авторизации трекера на удаленном сервере, ошибки ретрансляции и записи «Данные слишком долго не отправлялись» — с указанием времени, а для успешных отправок — длительности и числа отправленных записей (подробнее — в разделе Аудит).
Успешная отправка фиксируется с типом действия «Ретрансляция успешна»; это значит, что пакет передан приемнику, но не что приемник его сохранил (для протокола SOAP платформа не дожидается ответа приемника). В колонке «Описание» отображается текст вида:
Ретрансляция на сервер с id 123 для трекера с id 456789 выполнена за 5 секунд. Было отправлено 100 телематических записей.
Колонки «Время отправки, сек» и «Отправлено записей» заполняются из этого описания (длительность в секундах и число переданных телематических записей за сессию).
¶ Назначение объектов и редактирование
Кнопка «Редактировать данные» открывает форму сервера с теми же полями, что и при создании, и деревом объектов справа. В дереве организации и группы показывают сводные статусы ретрансляции (цветные метки), а флажками у транспортных средств отмечаются объекты, которые ретранслируются на этот сервер; уже привязанные объекты отмечены заранее. Поиск в дереве по названию организации или группы показывает все ее объекты — из найденной организации можно отметить отдельные объекты. Во всплывающей подсказке у каждого объекта показываются «Последняя успешная отправка» и «Последняя попытка отправки» — как читать эти поля при диагностике, описано в разделе Диагностика по полям «Последняя успешная отправка» и «Последняя попытка отправки». После изменений нажмите «Сохранить изменения» — платформа обновит параметры сервера и привязки.
Один объект можно ретранслировать на несколько серверов одновременно; один сервер обслуживает множество объектов. Ретранслируются объекты с назначенным трекером, привязанные к включенному серверу. Изменения привязок и включение/выключение сервера применяются не мгновенно, а с небольшой задержкой. Назначение объекта проверяют по списку объектов каждого сервера ретрансляции.
💡 Ретранслируемые объекты привязываются к серверу именно здесь — через дерево в режиме редактирования. Количество привязанных объектов отображается в столбце «Ретранслируемые» таблицы и в карточке сервера.
¶ Когда сервер доступен объекту
Отметка «объект — сервер ретрансляции» допустима, пока объект остается доступен серверу по иерархии организаций. Сервер доступен объекту, если:
- организация объекта — это организация сервера или любая организация внутри нее, на любой глубине; или
- объект ретранслируется по ссылке с правом «Создание настроек ретрансляции», и эта ссылка лежит в организации сервера или внутри нее (см. Ссылки и дубликаты).
Платформа проверяет только те отметки, которые изменение может сломать, и отклоняет изменение целиком, если хотя бы одна из них станет недопустимой: не сохраняются ни перенос, ни другие поля того же запроса. Сообщение приходит уведомлением «Некорректный запрос: …» и называет пары «объект — сервер ретрансляции» по ID; серверы, которые останутся доступны, в нем не названы, а если объектов больше десяти, названы первые десять и «и еще N». Проверяются:
- перенос объекта в другую организацию (карточка объекта, групповое редактирование, API) — все отметки этого объекта; сообщение: «Нельзя перенести объект в организацию, где его сервер ретрансляции окажется недоступен»;
- смена родительской организации у организации — отметки ее объектов (и объектов, доступных ее ветви по ссылкам с правом ретрансляции), чей сервер окажется снаружи; сообщение: «Нельзя перенести организацию: ее объекты потеряют доступ к своим серверам ретрансляции». Если сервер принадлежит переносимой организации, он переезжает вместе с ней;
- изменение или удаление ссылки на объект (снятие права «Создание настроек ретрансляции», перенос ссылки за пределы дерева сервера, удаление) и удаление пользователя, на которого выпущена такая ссылка, — если на этой ссылке держится отметка; сообщение: «Нельзя изменить или удалить ссылку на объект: на ней держится ретрансляция объекта. Сначала снимите отметки ретрансляции»;
- создание отметки через API на объект вне дерева сервера и без подходящей ссылки; сообщение: «Нельзя отметить объект на сервере ретрансляции: объект вне иерархии сервера и не доступен ему по ссылке с правом ретрансляции». В дереве карточки сервера такие объекты не показываются.
Отметки, которые уже недопустимы и которых изменение не касается, ничего не блокируют: объект с такой отметкой по-прежнему сохраняется, если его организация не меняется. Чтобы выполнить заблокированное действие, снимите отметку ретрансляции у названных объектов в дереве сервера (кнопка «Редактировать данные»). Организацию самого сервера ретрансляции пользователь сменить не может — поле закрыто для всех ролей.
¶ Как платформа передает данные
Входящая телеметрия накапливается в буфере отдельно по каждой паре «трекер — сервер» и отправляется на приемник небольшими пакетами по расписанию. При недоступности приемника или ошибке отправки платформа повторяет попытки, и неотправленная телеметрия досылается в следующих циклах. Исключение — пара «трекер — сервер», по которой в пределах срока хранения не было ни одной успешной отправки (например, на новом сервере указан неверный порт): при ошибке соединения или передачи накопленные данные не сохраняются, поэтому после исправления настроек пропущенный период отправьте кнопкой «Отправить историю». Срок хранения в буфере ограничен: данные, не отправленные за это время, удаляются, а в журнале ретрансляции появляется запись об истечении срока хранения. Если приемник не подтверждает авторизацию трекера, данные этого объекта не передаются — фиксируется ошибка в журнале. Новые данные организации в период блокировки не ретранслируются; пропущенный период можно дослать кнопкой «Отправить историю». Что и как передается, описано в разделе Как работает отправка страницы «Ретрансляция данных во внешние системы».
¶ Диагностика по полям «Последняя успешная отправка» и «Последняя попытка отправки»
Понять, на чьей стороне проблема, когда ретрансляция не идет, помогают поля «Последняя успешная отправка» и «Последняя попытка отправки» (всплывающая подсказка у объекта в режиме редактирования сервера ретрансляции):
- «Последняя попытка отправки» обновляется при каждой попытке передать накопленные данные объекта на внешний сервер — независимо от результата;
- «Последняя успешная отправка» обновляется только при успешной попытке: платформа установила соединение с приемником и передала данные, а в протоколах с авторизацией (ЕГТС с авторизацией, Wialon IPS) приемник перед этим подтвердил пакет авторизации. Если успешных отправок еще не было, поле остается пустым.
Если «Последняя попытка отправки» обновляется, а «Последняя успешная отправка» отстает от нее или пустая — платформа пытается передавать данные, но попытки завершаются ошибкой: не удается соединиться с приемником, передать данные или пройти авторизацию. Конкретная причина видна в «Аудите ретрансляции»:
- запись «Ошибка авторизации» — приемник не подтвердил пакет авторизации трекера; частые причины: идентификатор трекера (IMEI или серийный номер) не заведен на принимающей стороне либо выбран не тот протокол;
- запись «Ошибка ретрансляции» — не удалось установить соединение или передать данные: неверные хост или порт, приемник недоступен или разрывает соединение.
- данные вообще не доходят до платформы, поэтому и ретранслировать нечего — в частности, если в конфигурации трекера выключена передача времени фиксации координат: у ряда протоколов запись без времени фиксации не принимается; проверьте настройку передачи времени на трекере. Это же стоит проверить, когда сервер приемника пингуется, а записей в аудите ретрансляции нет.
Если не обновляется и «Последняя попытка отправки» — платформа не пытается отправлять данные этого объекта: проверьте, что сервер включен (статус «Активен»), объект привязан к серверу и у объекта назначен трекер, а от объекта поступает новая телеметрия — если объект не выходит на связь, отправлять нечего. Пропущенный период можно дослать кнопкой «Отправить историю» (см. Отправка истории).
Состояние отправки контролируют по полям отправки объекта и в аудите ретрансляции сервера.
💡 «Последняя успешная отправка» подтверждает отправку, а не сохранение данных у приемника. Платформа фиксирует успех, когда соединение установлено и пакет передан, а в протоколах с авторизацией — когда приемник подтвердил пакет авторизации. Подтверждения того, что приемник записал данные к себе, протоколы ретрансляции не предусматривают: если приемник не отвечает на пакет с данными, отправка все равно считается успешной. Поэтому ситуация «по части объектов данные на принимающей стороне видны, по части нет, а статусы у всех успешные» разбирается на стороне приемника — передайте его администратору ID сервера ретрансляции и время из «Аудита ретрансляции».
¶ Отправка истории
Кнопка «Отправить историю» (в карточке сервера) открывает окно, где выбираются период и объекты из числа привязанных к серверу. Период выбирается по дням и может охватывать любое их число. Кнопка «Сохранить» в окне активна, когда выбран хотя бы один объект и обе границы периода. После подтверждения платформа повторно отправит на внешний сервер накопленную за период телеметрию по выбранным объектам: отправка выполняется в фоне через тот же буфер и расписание, что и текущие данные; объекты без назначенного трекера пропускаются.
💡 Отправка истории полезна, если внешний сервер был временно недоступен: она позволяет «дослать» данные за пропущенный период.
¶ Удаление сервера ретрансляции
Кнопка «Удалить сервер ретрансляции» в нижней части карточки удаляет сервер после подтверждения — в окне отображаются протокол и ID сервера. Передача данных на приемник прекращается по всем объектам, привязки объектов к серверу снимаются автоматически; сами объекты при этом не изменяются. При удалении организации удаляются и все ее серверы ретрансляции вместе с привязками.
⚠️ Удаление сервера ретрансляции необратимо.
¶ Множественные операции
С помощью флажков слева в строках таблицы можно выбрать несколько серверов (механика выбора и подтверждения описана в разделе Интерфейс). Единственное групповое действие — удаление; по завершении показывается уведомление с количеством удаленных серверов. Групповое удаление доступно роли «Расширенный администратор».
¶ Входящая ретрансляция
Прием ретрансляции в Waliot — обратное направление: другая платформа отправляет данные на отдельные порты приема ретрансляции Waliot. Wialon IPS принимается на порт 30017, ЕГТС — на порт 30018, Wialon Retranslator — на порт 30027; еще два порта — в таблице портов. Раздел «Ретрансляция» эти данные не настраивает; подробнее — в разделе Совместимое оборудование и протоколы.
Флажок «Ретрансляция из сторонней системы», столбец «Ретранслируемая» в таблице объектов и статус «Ретранслируемая» — пометки, что данные объекта приходят из внешней системы; они ставятся вручную и на прием не влияют. Не путайте их со столбцом «Ретранслируемые» в таблице организаций: он показывает число объектов организации и вложенных организаций, для которых настроена исходящая ретрансляция.
¶ Что дальше
- Ретрансляция в РНИС Москвы — сервер для РНИС заведен: зарегистрируйте машины в РНИС и сверьте серийный номер трекера с идентификатором АТТ.
- Реестр популярных ретрансляций — приемник из списка госсистем: возьмите его адрес и порт оттуда и сверьте с оператором.
¶ Связанные возможности
В зависимости от роли пользователя и назначенного ему набора прав доступ к разделам может быть ограничен.