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

Материал из TK
Перейти к: навигация, поиск
 
(не показано 10 промежуточных версий 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 ==
   
Определение:&nbsp;<syntaxhighlight lang="csharp">
+
Определение:
Dictionary<Guid,RParameters> EnumParameters(string schemaName, Guid[] deviceIDs)
+
<pre>Dictionary<Guid,RParameters> EnumParameters(string schemaID, Guid[] IDs)
  +
</pre>
</syntaxhighlight>
 
   
deviceGuids - список идентификаторов ТС (их можно получить с помощью [[AutoGRAPH.NET Service EnumDevices|EnumDevices]]&nbsp;- поле ID в классе&nbsp;RGroupItem)
+
*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 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, ...)
Строка 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 : int
+
public enum ReturnType&nbsp;: int
 
{
 
{
 
Boolean = 0,
 
Boolean = 0,
Строка 51: Строка 72:
 
String = 9,
 
String = 9,
 
Image = 10,
 
Image = 10,
Coordinates = 11
+
Coordinates = 11,
  +
&nbsp; Location = 12
 
}
 
}
</syntaxhighlight>
 
   
  +
</pre>
== JSON ==
 
  +
<pre>public enum AddValueType&nbsp;: int
 
  +
{
Вызов:&nbsp;<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 приборов указываются через запятую.

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

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
}