AutoGRAPH.NET Service EnumParameters — различия между версиями
Admin (обсуждение | вклад) (→WCF) |
Admin (обсуждение | вклад) |
||
Строка 4: | Строка 4: | ||
Определение: |
Определение: |
||
+ | <pre>Dictionary<Guid,RParameters> EnumParameters(string schemaID, Guid[] IDs) |
||
− | <pre> |
||
− | Dictionary<Guid,RParameters> EnumParameters(string schemaName, Guid[] IDs) |
||
</pre> |
</pre> |
||
− | * |
+ | *IDs – список идентификаторов ТС (их можно получить с помощью [[AutoGRAPH.NET_Service_EnumDevices|EnumDevices]] – поле ID в классе RGroupItem) |
Результат: |
Результат: |
||
+ | <pre>public class RParameters |
||
− | <pre> |
||
− | 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: | Строка 22: | ||
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, ...) |
||
Строка 40: | Строка 40: | ||
// тип данных = тип статуса |
// тип данных = тип статуса |
||
− | public enum ReturnType |
+ | public enum ReturnType : int |
{ |
{ |
||
Boolean = 0, |
Boolean = 0, |
||
Строка 53: | Строка 53: | ||
String = 9, |
String = 9, |
||
Image = 10, |
Image = 10, |
||
− | Coordinates = 11 |
+ | Coordinates = 11, |
+ | Location = 12 |
||
} |
} |
||
+ | |||
</pre> |
</pre> |
||
+ | <pre>public enum AddValueType : int |
||
+ | { |
||
+ | Curr = 0, |
||
+ | First = 1, |
||
+ | Last = 2, |
||
+ | Diff = 3 |
||
+ | }</pre> |
||
== JSON == |
== JSON == |
||
Вызов: |
Вызов: |
||
+ | <pre>http://localhost:8300/EnumParameters?schemaID=Demo&IDs=2682e6d3-5055-4a3b-b9c8-0b723c57512a,9c60db53-5054-44f6-a708-8e3c9b62553f |
||
− | <pre> |
||
− | http://localhost:8300/EnumParameters/Demo/2682e6d3-5055-4a3b-b9c8-0b723c57512a,9c60db53-5054-44f6-a708-8e3c9b62553f |
||
− | http://localhost:8300/EnumParameters?schemaID=Demo&IDs=2682e6d3-5055-4a3b-b9c8-0b723c57512a,9c60db53-5054-44f6-a708-8e3c9b62553f |
||
</pre> |
</pre> |
||
Строка 68: | Строка 75: | ||
*'''2682e6d3-5055-4a3b-b9c8-0b723c57512a''' и '''9c60db53-5054-44f6-a708-8e3c9b62553f''' - идентификаторы двух приборов из этой схемы. ID приборов указываются через запятую. |
*'''2682e6d3-5055-4a3b-b9c8-0b723c57512a''' и '''9c60db53-5054-44f6-a708-8e3c9b62553f''' - идентификаторы двух приборов из этой схемы. ID приборов указываются через запятую. |
||
− | Результат: [[Media: |
+ | Результат: [[Media:AutoGRAPHNET_Service_EnumParameters.json.txt|скачать файл]] |
{| style="width: 100%;" |
{| style="width: 100%;" |
||
Строка 75: | Строка 82: | ||
| Параметры ТС в AutoGRAPH.NET: |
| Параметры ТС в AutoGRAPH.NET: |
||
|- |
|- |
||
− | | [[File:AutoGRAPHNET Service EnumParametersAG.png]]<br/> |
+ | | [[File:AutoGRAPHNET Service EnumParametersAG.png|RTENOTITLE]]<br/> |
|} |
|} |
Версия 19:51, 22 марта 2019
Возвращает список параметров по одному или нескольким приборам. Приборы, ID которых не найден – в результате отсутствуют.
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 }
JSON
Вызов:
http://localhost:8300/EnumParameters?schemaID=Demo&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: | |