AutoGRAPH.NET Service EnumParameters — различия между версиями
Grax (обсуждение | вклад) |
Ivan (обсуждение | вклад) |
||
(не показано 9 промежуточных версий 2 участников) | |||
Строка 1: | Строка 1: | ||
− | Возвращает список параметров по одному или нескольким приборам. Приборы, ID которых не найден |
+ | Возвращает список параметров по одному или нескольким приборам. Приборы, ID которых не найден – в результате отсутствуют. |
+ | |||
+ | == JSON == |
||
+ | |||
+ | Вызов: |
||
+ | <pre>http://localhost/ServiceJSON/EnumParameters?session=B05043B71F4B9C67C910163779FFF06EDBBAEF994B2D6C3A84DD96EB767A0F44&schemaID=b4b68be6-a124-4ca3-ab02-589e7c2ef1022&IDs=2682e6d3-5055-4a3b-b9c8-0b723c57512a,9c60db53-5054-44f6-a708-8e3c9b62553f |
||
+ | </pre> |
||
+ | |||
+ | *Demo - название схемы |
||
+ | *'''2682e6d3-5055-4a3b-b9c8-0b723c57512a''' и '''9c60db53-5054-44f6-a708-8e3c9b62553f''' - идентификаторы двух приборов из этой схемы. ID приборов указываются через запятую. |
||
+ | |||
+ | Результат: [[Media:AutoGRAPHNET_Service_EnumParameters.json.txt|скачать файл]] |
||
+ | |||
+ | {| style="width: 100%;" |
||
+ | |- |
||
+ | | rowspan="2" style="text-align: left; vertical-align: top;" | http://wiki.tk-chel.ru/images/4/4f/AutoGRAPHNET_Service_EnumParameters.png<br/> |
||
+ | | Параметры ТС в AutoGRAPH.NET: |
||
+ | |- |
||
+ | | [[File:AutoGRAPHNET Service EnumParametersAG.png|RTENOTITLE]]<br/> |
||
+ | |} |
||
== WCF == |
== WCF == |
||
− | Определение: |
+ | Определение: |
− | Dictionary<Guid,RParameters> EnumParameters(string |
+ | <pre>Dictionary<Guid,RParameters> EnumParameters(string schemaID, Guid[] IDs) |
+ | </pre> |
||
− | </syntaxhighlight> |
||
− | + | *IDs – список идентификаторов ТС (их можно получить с помощью [[AutoGRAPH.NET_Service_EnumDevices|EnumDevices]] – поле ID в классе RGroupItem) |
|
Результат: |
Результат: |
||
+ | <pre>public class RParameters |
||
− | |||
− | <syntaxhighlight lang="csharp"> |
||
− | public class RParameters |
||
{ |
{ |
||
public Guid ID { get; set; } // ID ТС |
public Guid ID { get; set; } // ID ТС |
||
public RParameter[] FinalParams { get; set; } // финальные (итоговые) параметры |
public RParameter[] FinalParams { get; set; } // финальные (итоговые) параметры |
||
public RParameter[] OnlineParams { get; set; } // онлайн (табличные) параметры |
public RParameter[] OnlineParams { get; set; } // онлайн (табличные) параметры |
||
+ | public RParameter[] TripsParams { get; set; } // рейсовые параметры |
||
} |
} |
||
Строка 23: | Строка 41: | ||
public string Name { get; set; } // имя параметра (внутренее название, латиница - например Daylight, Speed, ...) |
public string Name { get; set; } // имя параметра (внутренее название, латиница - например Daylight, Speed, ...) |
||
public string Caption { get; set; } // название параметра (например "Дн. освещ", "Скорость", ...) |
public string Caption { get; set; } // название параметра (например "Дн. освещ", "Скорость", ...) |
||
− | public string |
+ | public string Alias { get; set; } // алиас параметра, может быть пустой строкой |
public ReturnType ReturnType { get; set; } // тип параметра (см. ниже) |
public ReturnType ReturnType { get; set; } // тип параметра (см. ниже) |
||
+ | public AddValueType ValueType { get; set; } // модификатор параметра (см. ниже) |
||
public string Unit { get; set; } // ед.измерения параметра (км/ч, км, кг, ...) |
public string Unit { get; set; } // ед.измерения параметра (км/ч, км, кг, ...) |
||
public string Format { get; set; } // форматирование параметра (dd.MM.yyyy, ...) |
public string Format { get; set; } // форматирование параметра (dd.MM.yyyy, ...) |
||
Строка 35: | Строка 54: | ||
public int Value { get; set; } // численное значение статуса |
public int Value { get; set; } // численное значение статуса |
||
public string Caption { get; set; } // название статуса |
public string Caption { get; set; } // название статуса |
||
+ | public Guid ReferenceID { get; set; } // если статус геозона или водитель - здесь хранится GUID этого объекта |
||
+ | public Guid[] ReferenceIDs { get; set; } // если геозоны с наложениями - здесь полный список геозон (максимум 4), в которых находится прибор |
||
} |
} |
||
// тип данных = тип статуса |
// тип данных = тип статуса |
||
− | public enum ReturnType |
+ | public enum ReturnType : int |
{ |
{ |
||
Boolean = 0, |
Boolean = 0, |
||
Строка 51: | Строка 72: | ||
String = 9, |
String = 9, |
||
Image = 10, |
Image = 10, |
||
− | Coordinates = 11 |
+ | Coordinates = 11, |
+ | Location = 12 |
||
} |
} |
||
− | </syntaxhighlight> |
||
+ | </pre> |
||
− | == JSON == |
||
+ | <pre>public enum AddValueType : int |
||
− | |||
+ | { |
||
− | Вызов: <pre>http://localhost:8300/EnumParameters/Demo/2682e6d3-5055-4a3b-b9c8-0b723c57512a,9c60db53-5054-44f6-a708-8e3c9b62553f</pre> |
||
+ | Curr = 0, |
||
− | |||
+ | First = 1, |
||
− | *Demo - название схемы |
||
+ | Last = 2, |
||
− | *'''2682e6d3-5055-4a3b-b9c8-0b723c57512a''' и '''9c60db53-5054-44f6-a708-8e3c9b62553f''' - идентификаторы двух приборов из этой схемы. ID приборов указываются через запятую. |
||
+ | Diff = 3 |
||
− | |||
+ | }</pre> |
||
− | Результат: [[Media:AutoGRAPHNET Service EnumParameters.json.txt|скачать файл]] |
||
− | |||
− | {| style="width: 100%;" |
||
− | |- |
||
− | | rowspan="2" style="text-align: left; vertical-align: top;" | http://wiki.tk-chel.ru/images/4/4f/AutoGRAPHNET_Service_EnumParameters.png<br/> |
||
− | | Параметры ТС в AutoGRAPH.NET: |
||
− | |- |
||
− | | [[File:AutoGRAPHNET Service EnumParametersAG.png]]<br/> |
||
− | |} |
Текущая версия на 10:07, 18 июня 2020
Возвращает список параметров по одному или нескольким приборам. Приборы, ID которых не найден – в результате отсутствуют.
JSON
Вызов:
http://localhost/ServiceJSON/EnumParameters?session=B05043B71F4B9C67C910163779FFF06EDBBAEF994B2D6C3A84DD96EB767A0F44&schemaID=b4b68be6-a124-4ca3-ab02-589e7c2ef1022&IDs=2682e6d3-5055-4a3b-b9c8-0b723c57512a,9c60db53-5054-44f6-a708-8e3c9b62553f
- Demo - название схемы
- 2682e6d3-5055-4a3b-b9c8-0b723c57512a и 9c60db53-5054-44f6-a708-8e3c9b62553f - идентификаторы двух приборов из этой схемы. ID приборов указываются через запятую.
Результат: скачать файл
Параметры ТС в AutoGRAPH.NET: | |
WCF
Определение:
Dictionary<Guid,RParameters> EnumParameters(string schemaID, Guid[] IDs)
- IDs – список идентификаторов ТС (их можно получить с помощью EnumDevices – поле ID в классе RGroupItem)
Результат:
public class RParameters { public Guid ID { get; set; } // ID ТС public RParameter[] FinalParams { get; set; } // финальные (итоговые) параметры public RParameter[] OnlineParams { get; set; } // онлайн (табличные) параметры public RParameter[] TripsParams { get; set; } // рейсовые параметры } public class RParameter { public string Name { get; set; } // имя параметра (внутренее название, латиница - например Daylight, Speed, ...) public string Caption { get; set; } // название параметра (например "Дн. освещ", "Скорость", ...) public string Alias { get; set; } // алиас параметра, может быть пустой строкой public ReturnType ReturnType { get; set; } // тип параметра (см. ниже) public AddValueType ValueType { get; set; } // модификатор параметра (см. ниже) public string Unit { get; set; } // ед.измерения параметра (км/ч, км, кг, ...) public string Format { get; set; } // форматирование параметра (dd.MM.yyyy, ...) public RParameterStatus[] Statuses { get; set; } // список статусов параметра. // например для параметра Motion (Движение) возможны три статуса - Стоянка, Движение, Полёт) } public class RParameterStatus { public int Value { get; set; } // численное значение статуса public string Caption { get; set; } // название статуса public Guid ReferenceID { get; set; } // если статус геозона или водитель - здесь хранится GUID этого объекта public Guid[] ReferenceIDs { get; set; } // если геозоны с наложениями - здесь полный список геозон (максимум 4), в которых находится прибор } // тип данных = тип статуса public enum ReturnType : int { Boolean = 0, Byte = 1, Int32 = 2, Int64 = 3, Double = 4, DateTime = 5, TimeSpan = 6, Guid = 7, Guid4 = 8, String = 9, Image = 10, Coordinates = 11, Location = 12 }
public enum AddValueType : int { Curr = 0, First = 1, Last = 2, Diff = 3 }