1. Загрузка данных по объектам (ТС) и датчикам из Wialon
- Соответствие объектных моделей в Wialon и в Okdesk
- Настройка подключений к Wialon
- Связь компании в Okdesk и учетной записи клиента в Wialon
- Настройка соответствия параметров объектов и датчиков в Wialon атрибутам объектов обслуживания и оборудования в Okdesk
- Описание алгоритма синхронизации
- Синхронизация координат транспортных средств
Данная интеграция охватывает сценарий синхронизации базы данных транспортных средств (ТС) и установленных на ТС датчиков в Wialon с базой объектов обслуживания и оборудования в Okdesk. Благодаря интеграции не нужно вести двойную работу и заводить вручную ТС и датчики в двух системах. Достаточно добавить новые сущности в Wialon, а в Okdesk они загрузятся сами.
Интеграция позволяет забирать данные из нескольких инсталляций Wialon одновременно (например, если в компании используется как Wialon Hosting так и несколько инсталляций Wialon Local).
Соответствие объектных моделей в Wialon и в Okdesk
Okdesk и Wialon это две разных системы. И у каждой системы своя собственная модель данных. Для загрузки данных из Wialon в Okdesk нужно выбрать, как мы будем сопоставлять данные из одной системы в другой. Подробнее об этом будет рассказано ниже. Но на верхнем уровне, мы выбрали следующую модель:
- Объекту (Unit) в Wialon соответствует Объекты обслуживания в Okdesk;
- Учетной записи клиента (Account) в Wialon соответствует компания в Okdesk;
- Датчику (Sensor) в Wialon соответствует оборудование (которое будет вложено в соответствующий объект обслуживания) в Okdesk;
Настройка подключений к Wialon
Для того, чтобы интеграция была возможной, необходимо добавить в Okdesk хотя бы одно подключение к Wialon (интеграция поддерживает подключения к разным инсталляциям Wialon, например к Wialon Hosting и 2 и более разных инсталляций Wialon Local). Добавить подключение можно в разделе Настройки \ Интеграция с Wialon:
После нажатия на кнопку + Добавить подключение появится окно, в которой нужно указать тип подключения (Wialon Hosting или Wialon Local). В случае если выбран Wialon Local, необходимо будет указать адрес подключения. После нажатия на кнопку OK вы будете перенаправлены в Wialon для прохождения процедуры авторизации (необходимо будет ввести логин и пароль). В случае успешной авторизации, в списке подключений к Wialon появится новое подключение. При необходимости всегда можно проверить корректность подключения:
По умолчанию все подключения создаются отключенными. Для работы интеграции подключения необходимо включить (передвинуть "ползунок" вправо).
Включение подключения возможно только в том случае, если заполнена таблица соответствий атрибутов объектов и датчиков в Wialon параметрам объектов обслуживания и оборудования в Okdesk. Подробнее об этом читайте чуть ниже в соответствующем разделе.Подключение можно удалить. Для каждого подключения отображается, какое количество клиентских аккаунтов загружается и обновляется через это подключение (подробнее в следующем разделе).
Связь компании в Okdesk и учетной записи клиента в Wialon
Логика интеграции не подразумевает полный и безусловный импорт информации обо всех объектах и датчиках из Wialon. Информация импортируется по каждому клиенту, и только в том случае, если для карточки Компании в Okdesk прописана привязка к соответствующей учетной записи клиента в Wialon (название учетной записи). Т.е. если в карточке Компании в Okdesk не прописано название учетной записи клиента в Wialon-е, то импорт объектов (ТС) и сенсоров по этому клиенту осуществляться не будет до тех пор, пока идентификатор не будет прописан.
Название учетной записи клиента можно узнать в карточке учетной записи в Wialon:
Указать название учетной записи клиента в Wialon в карточке компании в Okdesk можно в соответствующем блоке:
В этом блоке указывается не только название клиентской учетной записи, но и подключение к Wialon из списка авторизованных подключений.
Блок с реквизитами подключения к Wialon отображается только в том случае, если в Okdesk добавлено хотя бы одно подключение к Wialon.Настройка соответствия параметров объектов и датчиков в Wialon атрибутам объектов обслуживания и оборудования в Okdesk
Wialon и Okdesk разные системы, и у каждой системы своя модель данных (свой набор атрибутов). Для загрузки и обновления данных по объектам и датчикам из Wialon, на стороне Okdesk необходимо указать соответствие атрибутов в Wialon атрибутам в Okdesk.
Соответствие атрибутов задаётся в двух таблицах: в одной таблице задаётся соответствие для атрибутов объектов, в другой — для атрибутов датчиков.
Для того или иного параметра в Wialon необходимо выбрать, в какой параметр на стороне Okdesk загружать соответствующее значение.
Для объектов:
Атрибут в Wialon Атрибут в Okdesk Уникальный ID Доступны к выбору дополнительные атрибуты объекта обслуживания типа "Строка" Телефонный номер Доступны к выбору дополнительные атрибуты объекта обслуживания типа "Строка" Тип устройства Доступны к выбору дополнительные атрибуты объекта обслуживания типа "Строка" или "Элемент списка" Имя Доступны к выбору дополнительные атрибуты объекта обслуживания типа "Строка" ID объекта Доступны к выбору дополнительные атрибуты объекта обслуживания типа "Строка" Для датчиков:
Атрибут в Wialon Атрибут в Okdesk Тип оборудования Доступны к выбору элементы справочника "Типы оборудования" ID датчика Доступны к выбору дополнительные атрибуты оборудования типа "Строка" Тип датчика Доступны к выбору дополнительные атрибуты оборудования типа "Строка" или "Элемент списка" Название Доступны к выбору дополнительные атрибуты оборудования типа "Строка" и системный атрибут "Инвентарный номер" Описание Доступны к выбору дополнительные атрибуты оборудования типа "Строка" и системный атрибут "Комментарий" По умолчанию, на стороне Wialon в карточке объекта больше параметров, чем определено для карточки объекта обслуживания или оборудования на стороне Okdesk. Поэтому, на стороне Okdesk необходимо создать дополнительные атрибуты объектов обслуживания и оборудования для указания их в таблице.
Дополнительно можно указать, какие именно типы датчиков необходимо загружать из Wialon в Okdesk (например, чтобы не загружать в базу Okdesk виртуальные датчики). По умолчанию никакие типы датчиков в Okdesk загружаться не будут:
Описание алгоритма синхронизации
По каждой компании в Okdesk, для которой заполнен блок с реквизитами в Wialon (подключение и название аккаунта), осуществляется забор данных:
- По параметру ID объекта осуществляется поиск вложенного в компанию объекта с соответствующим ID:
- Если объекта нет, объект создается. Параметры объекта заполняются в соответствии с таблицей. После в новом объекте осуществляется создание датчиков, параметры датчиков заполняются в соответствии с таблицей. При этом, если в качестве соответствия параметру “Тип датчика” выбран доп. атрибут типа "Элемент справочника", то в возможные значения данного доп. атрибута добавляются ещё не добавленные варианты значения данного параметра на стороне Wialon;
- Если объект есть, то осуществляется обновление значений данного объекта в соответствии с информацией из Wialon. Далее, для каждого датчика осуществляет поиск данных датчиков в объекте (по значению параметра id датчика в Wialon-е). Если такой датчик существует, происходит обновление значения параметров соответствующего оборудования. Если такого датчика нет, осуществляется создание нового датчика по тому же алгоритму, что и при создании нового объекта обслуживания (включая добавление новых возможных значений типа датчика в доп. атрибут типа "Значение из списка"). Изменение значений оборудования при синхронизации с Wialon логируется в истории событий с оборудованием.
- Также поддерживается сценарий, когда объект в Wialon был перенесен из одной компании в другую. В этом случае, дубли не создаются, объект в Okdesk также переносится из одной компании в другую с сохранением истории обслуживания в рамках предыдущей компании.
Синхронизация координат транспортных средств
Для более эффективного планирования исполнения заявок, в Okdesk можно отображать и назначать ответственность за заявки прямо на карте, в привязке к координатам объекта обслуживания. В отрасли интеграторов систем мониторинга транспорта, объектом обслуживания является транспортное средство. Координаты транспортных средств меняются во времени, поэтому нельзя один раз указать местоположение объекта при его создании. Чтобы решить эту проблему, в процессе синхронизации с Wialon можно обновлять текущие координаты транспортных средств. Благодаря этому, связанные с ТС заявки будут отображаться на карте в соответствии с текущей координатой объекта.
По умолчанию синхронизация координат отключена. Включить её можно в разделе настроек интеграции с Wialon:
Загрузка данных...