AutoGRAPH.NET Service Methods — различия между версиями

Материал из TK
Перейти к: навигация, поиск
 
(не показаны 3 промежуточные версии этого же участника)
Строка 1: Строка 1:
  +
 
=== Базовые методы сервиса ===
 
=== Базовые методы сервиса ===
   
*[[AutoGRAPH.NET_Service_Login|Login]] – аутентификация и получение токена (в случае, если она включена)
+
*[[AutoGRAPH.NET_Service_Login|Login]] – аутентификация и получение токена (в случае, если она включена)
*[[AutoGRAPH.NET_Service_EnumSchemas|EnumSchemas]] – получение списка доступных сервису схем
+
*[[AutoGRAPH.NET_Service_EnumSchemas|EnumSchemas]] – получение списка доступных сервису схем
*[[AutoGRAPH.NET_Service_EnumDevices|EnumDevices]] – получение списка устройств схемы
+
*[[AutoGRAPH.NET_Service_EnumDevices|EnumDevices]] – получение списка устройств схемы
*[[AutoGRAPH.NET_Service_EnumDrivers|EnumDrivers]] – получение информации о водителях в схеме
+
*[[AutoGRAPH.NET_Service_EnumDrivers|EnumDrivers]] – получение информации о водителях в схеме
*[[AutoGRAPH.NET_Service_EnumImplements|EnumImplements]] – получение информации об инструментах в схеме
+
*[[AutoGRAPH.NET_Service_EnumImplements|EnumImplements]] – получение информации об инструментах в схеме
*[[AutoGRAPH.NET_Service_EnumParameters|EnumParameters]] – получение списка параметров устройства в схеме
+
*[[AutoGRAPH.NET_Service_EnumParameters|EnumParameters]] – получение списка параметров устройства в схеме
*[[AutoGRAPH.NET_Service_EnumGeoFences|EnumGeoFences]] – получение списка геозон схемы
+
*[[AutoGRAPH.NET_Service_EnumGeoFences|EnumGeoFences]] – получение списка геозон схемы
*[[AutoGRAPH.NET_Service_EnumStatuses|EnumStatuses]] – получение списка доступных статусов устройств
+
*[[AutoGRAPH.NET_Service_EnumStatuses|EnumStatuses]] – получение списка доступных статусов устройств
*[[AutoGRAPH.NET_Service_GetGeoFences|GetGeoFences]] – получение информации о геозонах (точки для полигонов и т.д.)
+
*[[AutoGRAPH.NET_Service_GetGeoFences|GetGeoFences]] – получение информации о геозонах (точки для полигонов и т.д.)
*[[AutoGRAPH.NET_Service_FindDevices|FindDevices]] – поиск устройств по разным критериям
+
*[[AutoGRAPH.NET_Service_FindDevices|FindDevices]] – поиск устройств по разным критериям
 
   
 
=== Получение данных по приборам ===
 
=== Получение данных по приборам ===
Строка 21: Строка 21:
 
*[[AutoGRAPH.NET_Service_GetTrips|GetTrips]] – получение информации о рейсах приборов с текущими настройками схемы
 
*[[AutoGRAPH.NET_Service_GetTrips|GetTrips]] – получение информации о рейсах приборов с текущими настройками схемы
 
*[[AutoGRAPH.NET_Service_GetTripsArea|GetTripsArea]] – получение информации о рейсах приборов с текущими настройками схемы + рассчитанные полигоны полей (если включена обработка полей)
 
*[[AutoGRAPH.NET_Service_GetTripsArea|GetTripsArea]] – получение информации о рейсах приборов с текущими настройками схемы + рассчитанные полигоны полей (если включена обработка полей)
*[[AutoGRAPH.NET_Service_GetTrips|GetTripsTotal]] – получение информации о рейсах приборов с текущими настройками схемы (только
+
*[[AutoGRAPH.NET_Service_GetTrips|GetTripsTotal]] – получение информации о рейсах приборов с текущими настройками схемы (только итоговые данные)
 
итоговые данные)
 
 
 
*[[AutoGRAPH.NET_Service_GetTripsArea|GetTripsAreaTotal]] – получение информации о рейсах приборов с текущими настройками схемы (только итоговые данные) + рассчитанные полигоны полей (если включена обработка полей)
 
*[[AutoGRAPH.NET_Service_GetTripsArea|GetTripsAreaTotal]] – получение информации о рейсах приборов с текущими настройками схемы (только итоговые данные) + рассчитанные полигоны полей (если включена обработка полей)
 
*[[AutoGRAPH.NET_Service_GetTripTables|GetTripTables]] – получение табличных данных по рейсам приборов
 
*[[AutoGRAPH.NET_Service_GetTripTables|GetTripTables]] – получение табличных данных по рейсам приборов
Строка 33: Строка 30:
 
*[[AutoGRAPH.NET_Service_GetTripByPeriod|GetTripByPeriod]] -
 
*[[AutoGRAPH.NET_Service_GetTripByPeriod|GetTripByPeriod]] -
 
*[[AutoGRAPH.NET_Service_GetTripsMobileCheckpoints|GetTripsMobileCheckpoints]] – получение информации о рейсах приборов с мобильными контрольными точками
 
*[[AutoGRAPH.NET_Service_GetTripsMobileCheckpoints|GetTripsMobileCheckpoints]] – получение информации о рейсах приборов с мобильными контрольными точками
*[[GetTripsGroupByArea]] - возвращает площади обработанных полей, группированных по Поле/Устройство/Инструмент
+
*[[GetTripsGroupByArea|GetTripsGroupByArea]] [[File:Tag-new.png|RTENOTITLE]] - возвращает площади обработанных полей, группированных по Поле/Устройство/Инструмент
*[[GetTripsGroupByDevice]] - возвращает площади обработанных полей, группированных по Устройство/Поле/Инструмент
+
*[[GetTripsGroupByDevice|GetTripsGroupByDevice]] [[File:Tag-new.png|RTENOTITLE]] - возвращает площади обработанных полей, группированных по Устройство/Поле/Инструмент
   
 
=== Доступ к свойствам ===
 
=== Доступ к свойствам ===
   
*[[AutoGRAPH.NET_Service_GetProperties|GetProperties]], [[AutoGRAPH.NET_Service_GetProperties|GetGFProperties]], [[AutoGRAPH.NET_Service_GetProperties|GetDriverProperties]], [[AutoGRAPH.NET_Service_GetProperties|GetImplementProperties]] – получение списка свойств и их значений объектов
+
*[[AutoGRAPH.NET_Service_GetProperties|GetProperties]], [[AutoGRAPH.NET_Service_GetProperties|GetGFProperties]], [[AutoGRAPH.NET_Service_GetProperties|GetDriverProperties]], [[AutoGRAPH.NET_Service_GetProperties|GetImplementProperties]] – получение списка свойств и их значений объектов
*[[AutoGRAPH.NET_Service_GetProperty|GetProperty]], [[AutoGRAPH.NET_Service_GetProperty|GetGFProperty]], [[AutoGRAPH.NET_Service_GetProperty|GetDriverProperty]], [[AutoGRAPH.NET_Service_GetProperty|GetImplementProperty]] – получение значения одного свойства у списка объектов
+
*[[AutoGRAPH.NET_Service_GetProperty|GetProperty]], [[AutoGRAPH.NET_Service_GetProperty|GetGFProperty]], [[AutoGRAPH.NET_Service_GetProperty|GetDriverProperty]], [[AutoGRAPH.NET_Service_GetProperty|GetImplementProperty]] – получение значения одного свойства у списка объектов
*[[AutoGRAPH.NET_Service_SetProperties|SetProperties]], [[AutoGRAPH.NET_Service_SetProperties|SetGFProperties]], [[AutoGRAPH.NET_Service_SetProperties|SetDriverProperties]], [[AutoGRAPH.NET_Service_SetProperties|SetImplementProperties]] - установка значений свойств (или удаление свойств) у объектов
+
*[[AutoGRAPH.NET_Service_SetProperties|SetProperties]], [[AutoGRAPH.NET_Service_SetProperties|SetGFProperties]], [[AutoGRAPH.NET_Service_SetProperties|SetDriverProperties]], [[AutoGRAPH.NET_Service_SetProperties|SetImplementProperties]] - установка значений свойств (или удаление свойств) у объектов
*[[AutoGRAPH.NET_Service_SetProperty|SetProperty]], [[AutoGRAPH.NET_Service_SetProperty|SetGFProperty]], [[AutoGRAPH.NET_Service_SetProperty|SetDriverProperty]], [[AutoGRAPH.NET_Service_SetProperty|SetImplementProperty]] - установка значений одного свойства (или удаление свойства) у объектов
+
*[[AutoGRAPH.NET_Service_SetProperty|SetProperty]], [[AutoGRAPH.NET_Service_SetProperty|SetGFProperty]], [[AutoGRAPH.NET_Service_SetProperty|SetDriverProperty]], [[AutoGRAPH.NET_Service_SetProperty|SetImplementProperty]] - установка значений одного свойства (или удаление свойства) у объектов
   
 
=== Изменение объектов ===
 
=== Изменение объектов ===
   
*[[SetGeofences]] - создание/изменение/удаление геозон
+
*[[SetGeofences|SetGeofences]] - создание/изменение/удаление геозон
   
 
=== Выполнение отчетов ===
 
=== Выполнение отчетов ===
   
*[[AutoGRAPH.NET_Service_EnumReports|EnumReports]] - получение списка доступных отчетов
+
*[[AutoGRAPH.NET_Service_EnumReports|EnumReports]] - получение списка доступных отчетов
*[[AutoGRAPH.NET_Service_GetReports|GetReports]] - выполнение нескольких отчетов и загрузка его в виде XML/PDF/DOCX/XLS/.../ZIP-файла (формат выполнения указывается)
+
*[[AutoGRAPH.NET_Service_GetReports|GetReports]] - выполнение нескольких отчетов и загрузка его в виде XML/PDF/DOCX/XLS/.../ZIP-файла (формат выполнения указывается)
*[[AutoGRAPH.NET_Service_GetReport|GetReport]] - выполнение одного отчета и загрузка его в виде XML/PDF/DOCX/XLS/.../ZIP-файла (формат выполнения указывается)
+
*[[AutoGRAPH.NET_Service_GetReport|GetReport]] - выполнение одного отчета и загрузка его в виде XML/PDF/DOCX/XLS/.../ZIP-файла (формат выполнения указывается)
   
 
=== Пользователи, роли и токены ===
 
=== Пользователи, роли и токены ===
   
*[[AutoGRAPH.NET_Service_OTLCreate|OTLCreate]] - создание уникальных одноразовых ссылок с токеном (one-time link)
+
*[[AutoGRAPH.NET_Service_OTLCreate|OTLCreate]] - создание уникальных одноразовых ссылок с токеном (one-time link)
*[[AutoGRAPH.NET_Service_OTLDelete|OTLDelete]] - удаление уникальных ссылок по ID
+
*[[AutoGRAPH.NET_Service_OTLDelete|OTLDelete]] - удаление уникальных ссылок по ID
   
 
=== Работа с кэшированными данными ===
 
=== Работа с кэшированными данными ===
   
*[[AutoGRAPH.NET_Service_CacheFind|CacheFind]] - получение кэшированных данных по отрезкам
+
*[[AutoGRAPH.NET_Service_CacheFind|CacheFind]] - получение кэшированных данных по отрезкам
   
 
=== Работа с данными приложения ===
 
=== Работа с данными приложения ===
   
*[[AutoGRAPH.NET_Service_DataSave|DataSave]] - обновление кэшированных данных за указанны период
+
*[[AutoGRAPH.NET_Service_DataSave|DataSave]] - обновление кэшированных данных за указанны период
*[[AutoGRAPH.NET_Service_DataLoad|DataLoad]] - получение кэшированных данных по отрезкам
+
*[[AutoGRAPH.NET_Service_DataLoad|DataLoad]] - получение кэшированных данных по отрезкам
*[[AutoGRAPH.NET_Service_DataEnum|DataEnum]] - получение списка хранимых объектов-данных приложения
+
*[[AutoGRAPH.NET_Service_DataEnum|DataEnum]] - получение списка хранимых объектов-данных приложения
   
 
=== Прочее ===
 
=== Прочее ===
   
*[[AutoGRAPH.NET_Service_GetRoute|GetRoute]] – прокладка маршрута и получение этой информации в виде набора точек
+
*[[AutoGRAPH.NET_Service_GetRoute|GetRoute]] – прокладка маршрута и получение этой информации в виде набора точек
*[[AutoGRAPH.NET_Service_GetDeviceStatus|GetDeviceStatus]] - получение текущего статуса транспортных средств
+
*[[AutoGRAPH.NET_Service_GetDeviceStatus|GetDeviceStatus]] - получение текущего статуса транспортных средств
*[[AutoGRAPH.NET_Service_SetDeviceStatus|SetDeviceStatus]] - установка текущего статуса транспортных средств
+
*[[AutoGRAPH.NET_Service_SetDeviceStatus|SetDeviceStatus]] - установка текущего статуса транспортных средств
*[[AutoGRAPH.NET_Service_EnumTasks|EnumTasks]] [[File:Tag-new.png|RTENOTITLE]]
+
*<s>[[AutoGRAPH.NET_Service_EnumTasks|EnumTasks]]</s>
*[[AutoGRAPH.NET_Service_SetTasks|SetTasks]] [[File:Tag-new.png|RTENOTITLE]]
+
*<s>[[AutoGRAPH.NET_Service_SetTasks|SetTasks]]</s>
*[[AutoGRAPH.NET_Service_GetNotes|GetNotes]] [[File:Tag-new.png|RTENOTITLE]]
+
*[[AutoGRAPH.NET_Service_GetNotes|GetNotes]] [[File:Tag-new.png|RTENOTITLE]]
  +
*[[SendCommand|SendCommand]] - отправляет команду с аргументами на указанный список приборов
  +
*[[GetCommandResponse|GetCommandResponse]] - получает список ответов приборов&nbsp;на команды за период
   
 
Также сервис поддерживает загрузку/выгрузку и получение списка схем. AutoGRAPH.Pro (начиная с версии 2015.8.6) умеет работать с AutoGRAPH.NET Service как с веб-сервером. [[AutoGRAPH.NET_Service_WorkingSchemas|Подробнее здесь]].
 
Также сервис поддерживает загрузку/выгрузку и получение списка схем. AutoGRAPH.Pro (начиная с версии 2015.8.6) умеет работать с AutoGRAPH.NET Service как с веб-сервером. [[AutoGRAPH.NET_Service_WorkingSchemas|Подробнее здесь]].

Текущая версия на 12:01, 31 мая 2021

Базовые методы сервиса

  • Login – аутентификация и получение токена (в случае, если она включена)
  • EnumSchemas – получение списка доступных сервису схем
  • EnumDevices – получение списка устройств схемы
  • EnumDrivers – получение информации о водителях в схеме
  • EnumImplements – получение информации об инструментах в схеме
  • EnumParameters – получение списка параметров устройства в схеме
  • EnumGeoFences – получение списка геозон схемы
  • EnumStatuses – получение списка доступных статусов устройств
  • GetGeoFences – получение информации о геозонах (точки для полигонов и т.д.)
  • FindDevices – поиск устройств по разным критериям

Получение данных по приборам

  • GetDevicesInfo – получение информации об устройстве в схеме
  • GetOnlineInfo – получение информации о последнем местоположении устройств
  • GetOnlineInfoAll – получение информации о последнем местоположении всех устройств
  • GetDataRanges – получение информации о загруженных данных для приборов (минимальная/максимальные доступные даты)
  • GetTrips – получение информации о рейсах приборов с текущими настройками схемы
  • GetTripsArea – получение информации о рейсах приборов с текущими настройками схемы + рассчитанные полигоны полей (если включена обработка полей)
  • GetTripsTotal – получение информации о рейсах приборов с текущими настройками схемы (только итоговые данные)
  • GetTripsAreaTotal – получение информации о рейсах приборов с текущими настройками схемы (только итоговые данные) + рассчитанные полигоны полей (если включена обработка полей)
  • GetTripTables – получение табличных данных по рейсам приборов
  • GetTripsCustom – получение информации о рейсах приборов с указанными геозонами
  • GetStage – получение информации по одному отрезку для приборов
  • GetTrack – получение трека (даты/время, координаты, скорость) прибора
  • GetTripItems -
  • GetTripByPeriod -
  • GetTripsMobileCheckpoints – получение информации о рейсах приборов с мобильными контрольными точками
  • GetTripsGroupByArea RTENOTITLE - возвращает площади обработанных полей, группированных по Поле/Устройство/Инструмент
  • GetTripsGroupByDevice RTENOTITLE - возвращает площади обработанных полей, группированных по Устройство/Поле/Инструмент

Доступ к свойствам

Изменение объектов

  • SetGeofences - создание/изменение/удаление геозон

Выполнение отчетов

  • EnumReports - получение списка доступных отчетов
  • GetReports - выполнение нескольких отчетов и загрузка его в виде XML/PDF/DOCX/XLS/.../ZIP-файла (формат выполнения указывается)
  • GetReport - выполнение одного отчета и загрузка его в виде XML/PDF/DOCX/XLS/.../ZIP-файла (формат выполнения указывается)

Пользователи, роли и токены

  • OTLCreate - создание уникальных одноразовых ссылок с токеном (one-time link)
  • OTLDelete - удаление уникальных ссылок по ID

Работа с кэшированными данными

  • CacheFind - получение кэшированных данных по отрезкам

Работа с данными приложения

  • DataSave - обновление кэшированных данных за указанны период
  • DataLoad - получение кэшированных данных по отрезкам
  • DataEnum - получение списка хранимых объектов-данных приложения

Прочее

  • GetRoute – прокладка маршрута и получение этой информации в виде набора точек
  • GetDeviceStatus - получение текущего статуса транспортных средств
  • SetDeviceStatus - установка текущего статуса транспортных средств
  • EnumTasks
  • SetTasks
  • GetNotes RTENOTITLE
  • SendCommand - отправляет команду с аргументами на указанный список приборов
  • GetCommandResponse - получает список ответов приборов на команды за период

Также сервис поддерживает загрузку/выгрузку и получение списка схем. AutoGRAPH.Pro (начиная с версии 2015.8.6) умеет работать с AutoGRAPH.NET Service как с веб-сервером. Подробнее здесь.

Примеры

(C#, .NET 4+, Visual Studio 2013 или Visual Studio Express)

Скачать примеры (консольные и WinForms): http://agi.tk-chel.ru/install/service/AutoGRAPHServiceExamples.zip

Примеры на Powershell (JSON и экспорт в CSV)