Служба технічної підтримки

Система контролю транспорту ГЛОБУС

Служба технічної підтримки

Экспорт данных - общие сведения

Система контроля транспорта Глобус имеет возможность экспорта данных в формате csv.

Данные экспорта доступны через разные интерфейсы системы:

  1. Меню “Экспорт” в клиентском ПО
  2. Автоматизированное получение данных при помощи запуска клиентского ПО с определенными ключами командной строки
  3. Получение csv файла через раздел “Экспорт” web версии клиента.
  4. Автоматизированное получение экспорта с использованием web сервиса.

В данном списке способы перечислены в порядке их добавления в систему. П. 1 и 3 - предполагают ручное получение данных экспорта. Для автоматизированного получения данных внешними системами предназначены п. 2 и 4. 

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

 

Структура данных

Разделителем полей в генерируемых csv файлах служит символ ; (точка с запятой). 

Если поля содержат в своем значении символ точки с запятой - то они заключаются в двойные кавычки. 

Двойная кавычка внутри значения поля экранируется добавлением перед ней ещё одного символа двойной кавычки.

Строки отделяются либо по стандарту Windows (<CR><LF>), либо по стандарту Unix (<LF>).

Т.е. формат соответсвует тому, который генерирует Excel по-умолчанию.

Первая строка каждого файла содержит названия данных в соотсветствующей колонке.

 

Единицы измерения величин в данных

Сами наборы данных для экспорта - одни и те же во всей системе. Однако, следует учесть, что данные полученные при помощи клиентского ПО (через интерфейс, либо через командную строку) будут в других единицах, по сравнению с данными, полученными через web интерфейс. В частности, в данных полученных через ПО расстояния - в см, скорость - в см/с, также несколько отличается формат времени.

В данных, полученных через web интерфейс используются такие единицы и форматы:

  • время - по гринвичу, в формате iso8601 (YYYY-MM-DDThh:mm:ss±hh:mm).
  • расстояния - метры
  • скорость  - метры в секунду
  • интервалы времени - секунды.

 

Запрос данных

Запрос данных можно выполнить выбрав пункт меню “Экспорт” web клиента. Это откроет окно с адресом http://< ;server>/exports. Вместо <server> - будет конкретный адрес сервера, на котором выполняется web клиент и на котором обслуживаются машины данной учетной записи. В данный момент у нас задействовано несколько серверов. При автоматическом запросе важно учитывать, что запрос должен выполняться к правильному серверу (к тому, на котором обслуживается клиент, данные которого запрашиваются).

Данную страницу можно рассматривать как конструктор запросов, который позволяет как загрузить данные вручную, так и получить готовую строку с примером запроса для использования во внешней системе.

 

Использование ключа авторизации

Пользователь, авторизованный в web клиенте может экспортировать любые данные для доступных ему устройств. Для запроса экспорта данных из внешней программной системы следует воспользоваться ключом доступа. Ссылка на страницу с генератором ключей “Управление ключами” (/ekeys) находится внизу страницы “Экспорт”. 

При использовании запроса экспорта из внешней системы нужно добавить к http get запросу параметр key=..., куда подставить значение сгенерированного ключа.

 

Запрос данных

Запрос данных от системы осуществляется путем отправки http GET запроса вида:

http://< ;сервер>/export/<export name>?...

Вместо <сервер> подставляется нужное имя сервера для данного клиента.

Вместо <export name> - имя набора данных.

 

Параметры запроса:

from_date - дата в формате DD.MM.YYYY с которой запрашиваются данные

to_date - дата по которую запрашиваются данные

from_time - время в формате hh:mm:ss с которого запрашиваются данные. Время - локальное. Если время не задано, то считается равным 0:00:00

to_time - время до которого запрашиваются данные. Если не задано, то равно 23:59:59

ids - номера устройств, для которых запрашиваются данные. Отдельные устрйоства в списке разделяются символом | (%7C). Если параметр не задан - то считается равен всем устройствам, доступным пользователю.

key - ключ авторизации для доступа.

 

Несмотря на то, что для некоторых запросов диапазон времени не имеет значения (список зон, устройств и т.д.) задание параметров from_data и to_date является обязательным даже для них. Это связано с тем, что экспорты обслуживает общий код, который был написан до того, как в систему были добавлены подобные экспорты. 

© 2016 Система контролю транспорту "Глобус". Всі права захищені

Please publish modules in offcanvas position.