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

Материал из TK
Перейти к: навигация, поиск
(WCF)
 
(не показано 5 промежуточных версий 1 участника)
Строка 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 ==
   
 
Определение:
 
Определение:
  +
<pre>Dictionary<Guid,RParameters> EnumParameters(string schemaID, Guid[] IDs)
<pre>
 
Dictionary<Guid,RParameters> EnumParameters(string schemaName, Guid[] deviceIDs)
 
 
</pre>
 
</pre>
   
deviceGuids – список идентификаторов ТС (их можно получить с помощью [[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: Строка 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 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: Строка 59:
   
 
// тип данных = тип статуса
 
// тип данных = тип статуса
public enum ReturnType : int
+
public enum ReturnType&nbsp;: int
 
{
 
{
 
Boolean = 0,
 
Boolean = 0,
Строка 53: Строка 72:
 
String = 9,
 
String = 9,
 
Image = 10,
 
Image = 10,
Coordinates = 11
+
Coordinates = 11,
  +
&nbsp; Location = 12
 
}
 
}
</pre>
 
   
== JSON ==
 
 
Вызов:
 
<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>
  +
<pre>public enum AddValueType&nbsp;: int
 
  +
{
*Demo - название схемы
 
  +
Curr = 0,
*'''2682e6d3-5055-4a3b-b9c8-0b723c57512a''' и '''9c60db53-5054-44f6-a708-8e3c9b62553f''' - идентификаторы двух приборов из этой схемы. ID приборов указываются через запятую.
 
  +
First = 1,
 
  +
Last = 2,
Результат: [[Media:AutoGRAPHNET Service EnumParameters.json.txt|скачать файл]]
 
  +
Diff = 3
 
  +
}</pre>
{| 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 приборов указываются через запятую.

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

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

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
}