14. Интеграция с Omnicomm Online
Для компаний, работающих в сфере интеграции и обслуживания систем мониторинга транспорта (GPS\ГЛОНАСС), мы разработали интеграцию с одной из ведущих систем мониторинга — системой Omnicomm Online от компании Omnicomm.
Сценарий интеграции
В рамках интеграции реализована синхронизация базы транспортных средств клиентов в Omnicomm Online с базой объектов обслуживания клиентов в Okdesk.При синхронизации из Omnicomm Online копируется не только основная информация о транспортном средстве, но и текущие координаты. А значит, диспетчеру будет проще распределять заявки по транспортным средствам, видя их текущее положение на карте (и сопоставляя текущее местоположение транспортных средств с местоположением сервисных инженеров).
Предварительные настройки
Для того, чтобы интеграция была возможной, в вашем аккаунте Okdesk нужно провести ряд настроек:
- В карточку компании добавить атрибут типа "Строка" с кодом omnicomm_id и названием "Логин клиента в Omnicomm Online". Этот атрибут нужен для того, чтобы Okdesk "понимал", какая Компания в Okdesk соответствует какому клиенту в Omnicomm Online. Внимание! При заполнении этого поля в карточке компании необходимо иметь ввиду, что Okdesk забирает информацию только по тем учетным записям, в которых на стороне Omnicomm Online указано свойство "Клиент" (т.е. информация синхронизируется только по клиентским логинам).
- В карточку объекта обслуживания добавить:
- Атрибут типа "Строка" с кодом omnicomm_vehicle_id и названием "ID ТС". В этом атрибуте будет храниться уникальный идентификатор транспортного средства (генерируется автоматически при создании карточки транспортного средства в Omnicomm Online). Значение этого атрибута будет "связью" между карточкой объекта обслуживания в Okdesk и карточкой транспортного средства в Omnicomm Online.
- Атрибут типа "Строка" с кодом omnicomm_terminal_id и названием "ID терминала". В этом атрибуте будет храниться ID терминала транспортного средства.
- Атрибут типа "Значение из списка" (не путать с "Набор значений из списка") с кодом omnicomm_terminal_type и названием "Тип терминала". В этом атрибуте будет справочно храниться название типа терминала, установленного на транспортном средстве.
- Создать в вашем Omnicomm Online технического пользователя для Okdesk с правами на просмотр транспортных средств и пользователей всех компаний, которые вы хотите синхронизировать с Okdesk.
Подключение интеграции
Для подключения интеграции необходимо совершить описанные выше предварительные настройки, после чего прислать в тех.поддержку Okdesk заявку на подключение с логином и паролем созданного технического пользователя.
Логика синхронизации
Синхронизация транспортных средств осуществляется один раз в сутки. Логика синхронизации следующая:
- Для каждой компании, у которой заполнен строковый атрибут "Логин клиента в Omnicomm Online" (должен быть создан в соответствии с разделом "Предварительные настройки") осуществляется забор информации обо всех транспортных средствах, которые входят в ту же группу, что и пользователь с указанным в карточке компании логином. Для каждого транспортного средства:
- Проверяется наличие в карточке компании в Okdesk объекта обслуживания с аналогичным ID (хранится в Okdesk в созданном атрибуте "ID ТС"). Если такой объект обслуживания найден, то информация по нему обновляется (в том числе, обновляется координата);
- Если такой объект в карточке компании не найден, осуществляется поиск объекта с соответствующим "ID ТС" в карточках других компаний. Если он найден в карточке другой компании, осуществляется перенос объекта в новую компанию с последующим обновлением параметров (таким образом, если транспортное средство перешло из одной компании в другую, эта информация автоматически отразится в Okdesk);
- Если такой объект не найден ни в одной карточке компании в Okdesk, в текущей карточке компании будет создан новый объект, соответствующий новому транспортному средству.
- При создании и обновлении объекта обслуживания заполняются следующие поля:
- Название объекта обслуживания заполняется названием транспортного средства в Omnicomm Online;
- Добавленные атрибуты "ID ТС", "ID терминала" и "Тип терминала" заполняются соответствующими значениями из Omnicomm Online;
- В поле "Адрес" объекта обслуживания записываются текущие координаты транспортного средства.
Внимание! Если ранее вы заносили транспортные средства в Okdesk вручную, то при запуске синхронизации с Omnicomm Online они будут задублированы вновь созданными. Так произойдет, потому что "якорем" при привязке объекта обслуживания в Okdesk и транспортного средства в Omnicomm Online служит значение параметра "ТС ID". Для того, чтобы задубливание не произошло, необходимо у ранее созданных транспортных средств заполнить данный параметр соответствующим значением.
Загрузка данных...