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

Материал из TK
Перейти к: навигация, поиск
(WCF)
Строка 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)
+
*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 GroupName { get; set; } // группа параметров (параметры могут объединяться в группы с одним названием)
+
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 : int
+
public enum ReturnType&nbsp;: int
 
{
 
{
 
Boolean = 0,
 
Boolean = 0,
Строка 53: Строка 53:
 
String = 9,
 
String = 9,
 
Image = 10,
 
Image = 10,
Coordinates = 11
+
Coordinates = 11,
  +
&nbsp; 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:AutoGRAPHNET Service EnumParameters.json.txt|скачать файл]]
+
Результат: [[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 приборов указываются через запятую.

Результат: скачать файл

AutoGRAPHNET_Service_EnumParameters.png
Параметры ТС в AutoGRAPH.NET:
RTENOTITLE