Расчётные параметры

Расчетные параметры позволяют вычислять значение параметра шаблона отчета при помощи скриптов на языке C#. Подробнее о создании и настройке расчетного параметра см. раздел Расчетный параметр на странице «Параметры».

Ниже приведен справочник встроенных переменных, функций (формул) и структур данных, доступных в скриптах расчетных параметров. Этот же справочник открывается в конструкторе шаблона по кнопке Открыть справку.

• Значения из источников в формулах
• Переменные
• Методы
  • Формулы для чтения данных из модуля 'Справочники'
  • Формулы для преобразования данных
  • Формулы для чтения данных из СУБД
  • Формулы для чтения данных из файла 'Excel'
  • Формулы для чтения данных из веб-ресурса по протоколу 'HTTP'
  • Формулы для чтения данных из СУБД 'InfluxDB'
  • Формулы для чтения данных из КАСКАД 4
  • Математические формулы
  • Формулы для чтения данных из СУБД 'Microsoft SQL Server'
  • Формулы для чтения данных из СУБД 'MySQL'
  • Формулы для чтения данных при помощи интерфейса 'ODBC'
  • Формулы для чтения данных при помощи интерфейса 'OLEDB'
  • Формулы для чтения данных при помощи интерфейса 'OPC'
  • Формулы для чтения данных из модуля 'Наработка оборудования'
  • Формулы для чтения данных из СУБД 'Oracle'
  • Формулы для чтения данных из БД 'Пирамида'
  • Формулы для чтения данных СУБД 'PostgreSQL'
  • Формулы для чтения данных из отчетов
  • Формулы для чтения данных из файлов
  • Формулы для чтения данных из 'WinCC'
  • Формулы для чтения данных из КАСКАД 3 (InfluxDB)
  • Формулы для чтения данных из КАСКАД 3 (XMLRPC)
• Структуры
  • DictionaryAttributeInstance
  • DictionaryClassInstance
  • AggregationValue
  • ChartValue
  • DropDownValue
  • DropDownVariant
  • JsValue
  • ReportKaskadValue
  • LogCell
  • LogRow
  • OpcValue
  • PiramidaDiscret
  • PiramidaDiscretState
  • PiramidaValue
  • ReportChartValue
  • ReportFileValue
  • ReportTable
  • StoredReportValue
  • WinccOaAlarm
  • WinccOaAlarmsTable
  • WinccOaValue
  • WinccValue
  • XmlStandard
  • XmlValue
  • ReportCalculationHistory
  • OperationTimeDeviceInfo
  • OperationTimeDevicePeriodInfo
  • OperationTimeDeviceStateInfo
  • OperationTimeParameterLog
  • OperationTimeRecordInfo
  • OperationTimeStateInfo
  • ReportHtmlTableCompiler
  • AggregationType
  • PiramidaDiscretStatus
  • WinccOaAlarmAcknowledgeState
  • WinccOaAlarmDirection
  • DisplayedType
  • PiramidaParameter

Значения из источников в формулах

Значение из источника, агрегации или из другого отчёта участвует в формуле как обычное число. Приводить его к числу вручную не нужно:

return %Значение из OPC% + %Агрегация%;
return Math.Round(%Значение из OPC% - %Агрегация% / 3, 1);
return ReportGetValueByParameterOnTimestamp("Суточный отчет", StartDate, EndDate, EndDate, "Сумма") * 100;

Значение из другого отчёта приводится к числу по вложенному значению: если в другом отчёте параметр хранит, например, значение агрегации, в расчёт попадёт само число.

Если значения нет или его нельзя привести к числу (текст, пустое значение, агрегация без данных), в расчёт попадает 0. Чтобы отличить отсутствие значения от нуля, проверьте значение до расчёта. В параметре с типом double? верните при отсутствии значения null, тогда ячейка останется пустой:

if (%Значение из OPC%.Value == null)
{
    return null;
}

return %Значение из OPC% * 2;

Дополнительные данные значения доступны через его свойства, например %Значение из OPC%.Timestamp — метка времени значения в источнике.

Переменные

Название	Тип	Описание
History	ReportCalculationHistory	История вычислений параметров
Time	ReportCalculationTime	Контекст времени вычислений отчета
Interval	TimeInterval	Период отчета
StartDate	DateTime	Дата начала отчета
EndDate	DateTime	Дата окончания отчета
Timestamp	DateTime	Метка времени отчета
ReportDay	DateTime	День отчета (без времени)
StepStart	DateTime	Метка времени начала шага
StepEnd	DateTime	Метка времени конца шага
StepInterval	TimeInterval	Интервал текущего шага
Step	TimeDuration	Шаг отчета
ReportWeek	DateTime	Неделя отчета
ReportMonth	DateTime	Месяц отчета
ReportYear	DateTime	Год отчета
ReportCreationDate	DateTime	Дата создания отчета
ReportUpdateDate	DateTime	Дата обновления отчета
Now	DateTime	Дата расчета

Методы

Формулы для чтения данных из модуля 'Справочники'

GetDictionaryClassInstanceAttributeValue

Загрузить значение атрибута класса из справочника

Объявление:

Object GetDictionaryClassInstanceAttributeValue(String attributeInstanceUniqueCode)

Передаваемые параметры:

Название	Тип	Описание	Примечание
attributeInstanceUniqueCode	String	Идентификатор экземпляра атрибута класса

Возвращаемое значение : (Object) Значение атрибута класса

GetDictionaryItemPropertyValueAsString

Загрузить текстовое значение атрибута класса из справочника

Объявление:

String GetDictionaryItemPropertyValueAsString(String attributeInstanceUniqueCode)

Передаваемые параметры:

Название	Тип	Описание	Примечание
attributeInstanceUniqueCode	String	Идентификатор экземпляра атрибута класса

Возвращаемое значение : (String) Текстовое значение атрибута класса

GetDictionaryItemPropertyValueAsDouble

Загрузить числовое значение атрибута класса из справочника

Объявление:

Double GetDictionaryItemPropertyValueAsDouble(String attributeInstanceUniqueCode)

Передаваемые параметры:

Название	Тип	Описание	Примечание
attributeInstanceUniqueCode	String	Идентификатор экземпляра атрибута класса

Возвращаемое значение : (Double) Числовое значение атрибута класса

GetDictionaryItemPropertyValueAsDateTime

Загрузить временное значение атрибута класса из справочника

Объявление:

DateTime GetDictionaryItemPropertyValueAsDateTime(String attributeInstanceUniqueCode)

Передаваемые параметры:

Название	Тип	Описание	Примечание
attributeInstanceUniqueCode	String	Идентификатор экземпляра атрибута класса

Возвращаемое значение : (DateTime) Временное значение атрибута класса

GetDictionaryClassInstancesChildren

Загрузить дочерние экземпляры классов из справочника

Объявление:

DictionaryClassInstance[] GetDictionaryClassInstancesChildren(String parentInstanceUniqueCode)

Передаваемые параметры:

Название	Тип	Описание	Примечание
parentInstanceUniqueCode	String	Идентификатор родительского экземпляра класса

Возвращаемое значение : (DictionaryClassInstance[]) Список экземпляров классов

GetFilterDictionaryClassInstancesByName

Загрузить дочерние экземпляры класса, отфильтрованные по названию экземпляра из справочника

Объявление:

DictionaryClassInstance[] GetFilterDictionaryClassInstancesByName(DictionaryClassInstance[] classInstances, String className)

Передаваемые параметры:

Название	Тип	Описание	Примечание
classInstances	DictionaryClassInstance[]	Исходный список элементов
className	String	Название класса для фильтрации

Возвращаемое значение : (DictionaryClassInstance[]) Экземпляры классов, удовлетворяющие условию

GetFilterDictionaryClassInstancesByAttribute

Загрузить дочерние экземпляры класса, отфильтрованные по названию атрибута и его значению из справочника

Объявление:

DictionaryClassInstance[] GetFilterDictionaryClassInstancesByAttribute(DictionaryClassInstance[] classInstances, String attributeName, Object attributeValue)

Передаваемые параметры:

Название	Тип	Описание	Примечание
classInstances	DictionaryClassInstance[]	Список экземпляров классов
attributeName	String	Название атрибута
attributeValue	Object	Значение атрибута

Возвращаемое значение : (DictionaryClassInstance[]) Экземпляры классов, удовлетворяющие условию

GetDictionaryClassInstanceAttribute

Загрузить значение атрибута из экземпляра класса по названию атрибута из справочника

Объявление:

Object GetDictionaryClassInstanceAttribute(DictionaryClassInstance classInstance, String attributeName)

Передаваемые параметры:

Название	Тип	Описание	Примечание
classInstance	DictionaryClassInstance	Экземпляра класса
attributeName	String	Название атрибута

Возвращаемое значение : (Object) Значение атрибута

GetAttributeInstanceValue

Загрузить значение атрибута по идентификатору экземпляра класса и названию атрибута из справочника

Объявление:

Object GetAttributeInstanceValue(String classInstanceUniqueCode, String attributeName)

Передаваемые параметры:

Название	Тип	Описание	Примечание
classInstanceUniqueCode	String	Идентификатор экземпляра класса
attributeName	String	Название атрибута

Возвращаемое значение : (Object) Значение атрибута

GetDictionaryClassInstance

Загрузить значение экземпляра класса из справочника

Объявление:

DictionaryClassInstance GetDictionaryClassInstance(String classInstanceUniqueCode)

Передаваемые параметры:

Название	Тип	Описание	Примечание
classInstanceUniqueCode	String	Идентификатор экземпляра класса

Возвращаемое значение : (DictionaryClassInstance) Экземпляр класса

GetChildrenClassInstances

Загрузить значения экземпляров класса из справочника

Объявление:

ClassInstanceDtoBase[] GetChildrenClassInstances(String classUniqueCode, String parentInstanceClassUniqueCode)

Передаваемые параметры:

Название	Тип	Описание	Примечание
classUniqueCode	String	Идентификатор класса
parentInstanceClassUniqueCode	String	Идентификатор родительского экземпляра класса	Необязательный

Возвращаемое значение : (ClassInstanceDtoBase[]) Экземпляры класса

Формулы для преобразования данных

Select

Выбрать ячейку из матрицы

Объявление:

Object Select(Object[][] matrix, Int32 rowIndex, Int32 colIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
matrix	Object[][]	Матрица
rowIndex	Int32	Индекс строки
colIndex	Int32	Индекс столбца

Возвращаемое значение : (Object) Результат выполнения запроса в виде объекта

Select

Выбрать вложенную матрицу

Объявление:

Object[][] Select(Object[][] matrix, Int32 startRowIndex, Int32 startColIndex, Int32 endRowIndex, Int32 endColIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
matrix	Object[][]	Матрица
startRowIndex	Int32	Индекс начальной строки
startColIndex	Int32	Индекс начального столбца
endRowIndex	Int32	Индекс конечной строки
endColIndex	Int32	Индекс конечного столбца

Возвращаемое значение : (Object[][]) Результат выполнения запроса в виде матрицы объектов

SelectRow

Выбрать строку из матрицы

Объявление:

Object[] SelectRow(Object[][] matrix, Int32 rowIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
matrix	Object[][]	Матрица
rowIndex	Int32	Индекс строки

Возвращаемое значение : (Object[]) Результат выполнения запроса в виде строки объектов

SelectColumn

Выбрать столбец из матрицы

Объявление:

Object[] SelectColumn(Object[][] matrix, Int32 colIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
matrix	Object[][]	Матрица
colIndex	Int32	Индекс столбца

Возвращаемое значение : (Object[]) Результат выполнения запроса в виде столбца

ConvertToNumberMatrix

Преобразовать матрицу объектов в матрицу чисел

Объявление:

Double[][] ConvertToNumberMatrix(Object[][] matrix)

Передаваемые параметры:

Название	Тип	Описание	Примечание
matrix	Object[][]	Матрица

Возвращаемое значение : (Double[][]) Результат выполнения запроса в виде матрицы чисел

ConvertToStringMatrix

Преобразовать матрицу объектов в матрицу строк

Объявление:

String[][] ConvertToStringMatrix(Object[][] matrix)

Передаваемые параметры:

Название	Тип	Описание	Примечание
matrix	Object[][]	Матрица

Возвращаемое значение : (String[][]) Результат выполнения запроса в виде матрицы строк

ConvertToDateMatrix

Преобразовать матрицу объектов в матрицу дат

Объявление:

DateTime[][] ConvertToDateMatrix(Object[][] matrix)

Передаваемые параметры:

Название	Тип	Описание	Примечание
matrix	Object[][]	Матрица

Возвращаемое значение : (DateTime[][]) Результат выполнения запроса в виде матрицы дат

ConvertToString

Преобразовать объект к строке

Объявление:

String ConvertToString(Object value)

Передаваемые параметры:

Название	Тип	Описание	Примечание
value	Object	Значение

Возвращаемое значение : (String) Результат выполнения запроса в виде строки

ConvertToNumber

Преобразовать объект к числу

Объявление:

Double ConvertToNumber(Object value)

Передаваемые параметры:

Название	Тип	Описание	Примечание
value	Object	Значение

Возвращаемое значение : (Double) Результат выполнения запроса в виде числа

ConvertToDate

Преобразовать объект к дате

Объявление:

DateTime ConvertToDate(Object value)

Передаваемые параметры:

Название	Тип	Описание	Примечание
value	Object	Значение

Возвращаемое значение : (DateTime) Результат выполнения запроса в виде даты

ConvertToTable

Преобразовать матрицу к таблице

Объявление:

ReportTable ConvertToTable(Object[][] matrix, Boolean includeHeader)

Передаваемые параметры:

Название	Тип	Описание	Примечание
matrix	Object[][]	Матрица
includeHeader	Boolean	Включить заголовки

Возвращаемое значение : (ReportTable) Результат выполнения запроса в виде таблицы

ConvertToStringMatrixArray

Преобразовать массив таблиц в массив матриц строк

Объявление:

String[][][] ConvertToStringMatrixArray(ReportTable[] tables)

Передаваемые параметры:

Название	Тип	Описание	Примечание
tables	ReportTable[]	Таблица

Возвращаемое значение : (String[][][]) Результат выполнения запроса в виде массива матриц строк

ConvertToNumberMatrixArray

Преобразовать массив таблиц в массив матриц чисел

Объявление:

Double[][][] ConvertToNumberMatrixArray(ReportTable[] tables)

Передаваемые параметры:

Название	Тип	Описание	Примечание
tables	ReportTable[]	Таблицы

Возвращаемое значение : (Double[][][]) Результат выполнения запроса в виде массива матриц строк

SelectStringFromMatrix

Выполнить запрос к СУБД 'InfluxDB'

Объявление:

String SelectStringFromMatrix(String[][][] matrix, Int32 measurementIndex, Int32 rowIndex, Int32 colIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
matrix	String[][][]	Массив матриц строк
measurementIndex	Int32	Индекс измерения	Необязательный
rowIndex	Int32	Индекс строки	Необязательный
colIndex	Int32	Индекс столбца	Необязательный

Возвращаемое значение : (String) Значение измерения в числовом виде

Формулы для чтения данных из СУБД

LoadFromDatabase

Выполнить запрос к БД

Объявление:

Object[][] LoadFromDatabase(String connectionGuid, String sql, Boolean loadHeaders)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных
loadHeaders	Boolean	Включить заголовки в результат запроса

Возвращаемое значение : (Object[][]) Результат выполнения запроса в виде матрицы объектов

LoadFromInfluxDatabase

Выполнить запрос к БД Influx

Объявление:

Object[][][] LoadFromInfluxDatabase(String connectionGuid, String sql, Boolean loadHeaders)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных
loadHeaders	Boolean	Включить заголовки в результат запроса

Возвращаемое значение : (Object[][][]) Результат выполнения запроса в виде таблицы

Формулы для чтения данных из файла 'Excel'

ExcelCellAsString

Загрузить значение ячейки в виде строки из файла 'Excel'

Объявление:

String ExcelCellAsString(String filePath, String sheet, String cell)

Передаваемые параметры:

Название	Тип	Описание	Примечание
filePath	String	Путь к файлу
sheet	String	Название листа
cell	String	Адрес ячейки в формате 'A1'

Возвращаемое значение : (String) Значение ячейки в виде строки

ExcelCellAsStringByConnection

Загрузить значение ячейки в виде строки из файла 'Excel'

Объявление:

String ExcelCellAsStringByConnection(String connectionGuid, String sheet, String cell)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sheet	String	Название листа
cell	String	Адрес ячейки в формате 'A1'

Возвращаемое значение : (String) Значение ячейки в виде строки

ExcelCellAsDouble

Загрузить значение ячейки в виде числа из файла 'Excel'

Объявление:

Double ExcelCellAsDouble(String filePath, String sheet, String cell)

Передаваемые параметры:

Название	Тип	Описание	Примечание
filePath	String	Путь к файлу
sheet	String	Название листа
cell	String	Адрес ячейки в формате 'A1'

Возвращаемое значение : (Double) Значение ячейки в виде числа

ExcelCellAsDoubleByConnection

Загрузить значение ячейки в виде числа из файла 'Excel'

Объявление:

Double ExcelCellAsDoubleByConnection(String connectionGuid, String sheet, String cell)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sheet	String	Название листа
cell	String	Адрес ячейки в формате 'A1'

Возвращаемое значение : (Double) Значение ячейки в виде числа

GetExcelTable

Загрузить данные в виде таблицы из файла 'Excel'

Объявление:

ReportTable GetExcelTable(String filePath, String sheet, String startCell, String endCell)

Передаваемые параметры:

Название	Тип	Описание	Примечание
filePath	String	Путь к файлу
sheet	String	Название листа
startCell	String	Адрес начальной ячейки в формате 'A1'
endCell	String	Адрес конечной ячейки в формате 'A1'

Возвращаемое значение : (ReportTable) Значения файла в виде таблицы

GetExcelTableByConnection

Загрузить данные в виде таблицы из файла 'Excel'

Объявление:

ReportTable GetExcelTableByConnection(String connectionGuid, String sheet, String startCell, String endCell)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sheet	String	Название листа
startCell	String	Адрес начальной ячейки в формате 'A1'
endCell	String	Адрес конечной ячейки в формате 'A1'

Возвращаемое значение : (ReportTable) Значения файла в виде таблицы

GetExcelSheetByContent

Загрузить данные в виде таблицы из массива байт файла 'Excel'

Объявление:

ReportTable GetExcelSheetByContent(Byte[] data, String sheet)

Передаваемые параметры:

Название	Тип	Описание	Примечание
data	Byte[]	Данные файла
sheet	String	Название листа

Возвращаемое значение : (ReportTable) Значения файла в виде таблицы

Формулы для чтения данных из веб-ресурса по протоколу 'HTTP'

HttpRequest

Загрузить данные из внешнего ресурса в виде строки по протоколу 'HTTP'

Объявление:

String HttpRequest(String url, String method, String body, IEnumerable<KeyValuePair<String, String>> headers)

Передаваемые параметры:

Название	Тип	Описание	Примечание
url	String	Адрес ресурса
method	String	Метод запроса
body	String	Тело запроса
headers	IEnumerable<KeyValuePair<String, String>>	Заголовки запроса

Возвращаемое значение : (String) Ответ в виде строки

HttpRequestByConnection

Загрузить данные из внешнего ресурса в виде строки по протоколу 'HTTP'

Объявление:

String HttpRequestByConnection(String connectionGuid, String path, String method, String body, IEnumerable<KeyValuePair<String, String>> headers)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
path	String	Путь
method	String	Метод запроса
body	String	Тело запроса
headers	IEnumerable<KeyValuePair<String, String>>	Заголовки запроса

Возвращаемое значение : (String) Ответ в виде строки

Формулы для чтения данных из СУБД 'InfluxDB'

InfluxQueryAsStringArrays

Выполнить запрос к СУБД 'InfluxDB'

Объявление:

String[][][] InfluxQueryAsStringArrays(String protocol, String host, Int32 port, String username, String password, String database, String query)

Передаваемые параметры:

Название	Тип	Описание	Примечание
protocol	String	Сетевой протокол сервера
host	String	Адрес сервера
port	Int32	Порт
username	String	Имя пользователя
password	String	Пароль пользователя
database	String	Название базы данных
query	String	Запрос для выборки данных

Возвращаемое значение : (String[][][]) Значения измерений в виде трехмерного строкового массива

InfluxQueryAsString

Выполнить запрос к СУБД 'InfluxDB'

Объявление:

String InfluxQueryAsString(String protocol, String host, Int32 port, String username, String password, String database, String query, Int32 measurementIndex, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
protocol	String	Сетевой протокол сервера
host	String	Адрес сервера
port	Int32	Порт
username	String	Имя пользователя
password	String	Пароль пользователя
database	String	Название базы данных
query	String	Запрос для выборки данных
measurementIndex	Int32	Индекс измерения	Необязательный
rowIndex	Int32	Индекс строки	Необязательный
columnIndex	Int32	Индекс столбца	Необязательный

Возвращаемое значение : (String) Значение измерения в строковом виде

InfluxQueryAsDoubleArrays

Выполнить запрос к СУБД 'InfluxDB'

Объявление:

Double[][][] InfluxQueryAsDoubleArrays(String protocol, String host, Int32 port, String username, String password, String database, String query)

Передаваемые параметры:

Название	Тип	Описание	Примечание
protocol	String	Сетевой протокол сервера
host	String	Адрес сервера
port	Int32	Порт
username	String	Имя пользователя
password	String	Пароль пользователя
database	String	Название базы данных
query	String	Запрос для выборки данных

Возвращаемое значение : (Double[][][]) Значения измерений в виде трехмерного массива чисел

InfluxQueryAsDouble

Выполнить запрос к СУБД 'InfluxDB'

Объявление:

Double InfluxQueryAsDouble(String protocol, String host, Int32 port, String username, String password, String database, String query, Int32 measurementIndex, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
protocol	String	Сетевой протокол сервера
host	String	Адрес сервера
port	Int32	Порт
username	String	Имя пользователя
password	String	Пароль пользователя
database	String	Название базы данных
query	String	Запрос для выборки данных
measurementIndex	Int32	Индекс измерения	Необязательный
rowIndex	Int32	Индекс строки	Необязательный
columnIndex	Int32	Индекс столбца	Необязательный

Возвращаемое значение : (Double) Значение измерения в числовом виде

InfluxQueryAsHtmlTables

Выполнить запрос к СУБД 'InfluxDB'

Объявление:

ReportTable[] InfluxQueryAsHtmlTables(String protocol, String host, Int32 port, String username, String password, String database, String query, Boolean includeHeader)

Передаваемые параметры:

Название	Тип	Описание	Примечание
protocol	String	Сетевой протокол сервера
host	String	Адрес сервера
port	Int32	Порт
username	String	Имя пользователя
password	String	Пароль пользователя
database	String	Название базы данных
query	String	Запрос для выборки данных
includeHeader	Boolean	Загрузить заголовки (true - да, false - нет)

Возвращаемое значение : (ReportTable[]) Значения измерений в виде массива таблиц

InfluxQueryAsStringArraysByConnection

Выполнить запрос к СУБД 'InfluxDB'

Объявление:

String[][][] InfluxQueryAsStringArraysByConnection(String connectionGuid, String query)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор внешнего соединения
query	String	Запрос для выборки данных

Возвращаемое значение : (String[][][]) Значения измерений в виде трехмерного строкового массива

InfluxQueryAsStringByConnection

Выполнить запрос к СУБД 'InfluxDB'

Объявление:

String InfluxQueryAsStringByConnection(String connectionGuid, String query, Int32 measurementIndex, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
query	String	Запрос для выборки данных
measurementIndex	Int32	Индекс измерения	Необязательный
rowIndex	Int32	Индекс строки	Необязательный
columnIndex	Int32	Индекс столбца	Необязательный

Возвращаемое значение : (String) Значение измерения в строковом виде

InfluxQueryAsDoubleArraysByConnection

Выполнить запрос к СУБД 'InfluxDB'

Объявление:

Double[][][] InfluxQueryAsDoubleArraysByConnection(String connectionGuid, String query)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
query	String	Запрос для выборки данных

Возвращаемое значение : (Double[][][]) Значения измерений в виде трехмерного массива чисел

InfluxQueryAsDoubleByConnection

Выполнить запрос к СУБД 'InfluxDB'

Объявление:

Double InfluxQueryAsDoubleByConnection(String connectionGuid, String query, Int32 measurementIndex, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
query	String	Запрос для выборки данных
measurementIndex	Int32	Индекс измерения	Необязательный
rowIndex	Int32	Индекс строки	Необязательный
columnIndex	Int32	Индекс столбца	Необязательный

Возвращаемое значение : (Double) Значение измерения в числовом виде

InfluxQueryAsHtmlTablesByConnection

Выполнить запрос к СУБД 'InfluxDB'

Объявление:

ReportTable[] InfluxQueryAsHtmlTablesByConnection(String connectionGuid, String query, Boolean includeHeader)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
query	String	Запрос для выборки данных
includeHeader	Boolean	Загрузить заголовки (true - да, false - нет)

Возвращаемое значение : (ReportTable[]) Значения измерений в виде массива таблиц

Формулы для чтения данных из КАСКАД 4

GetKaskadCurrent

Загрузить текущее значение точки данных из 'КАСКАД 4'

Объявление:

ReportKaskadValue GetKaskadCurrent(String connectionGuid, String address)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
address	String	Адрес точки данных

Возвращаемое значение : (ReportKaskadValue) Значение точки данных

GetKaskadOnTimestamp

Загрузить текущее значение точки данных из 'КАСКАД 4'

Объявление:

ReportKaskadValue GetKaskadOnTimestamp(String connectionGuid, String address, DateTime timestamp)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
address	String	Адрес точки данных
timestamp	DateTime	Метка времени

Возвращаемое значение : (ReportKaskadValue) Значение точки данных

GetKaskadOnPeriod

Загрузить массив значений точки данных за период из 'КАСКАД 4'

Объявление:

ReportKaskadValue[] GetKaskadOnPeriod(String connectionGuid, String address, DateTime startTime, DateTime endTime, Int32 bonus)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
address	String	Адрес точки данных
startTime	DateTime	Дата начала периода
endTime	DateTime	Дата окончания периода
bonus	Int32	Количество бонусных значений	Необязательный

Возвращаемое значение : (ReportKaskadValue[]) Массив значений точки данных

Математические формулы

MathInterpolation

Вычислить интерполяцию

Объявление:

Double MathInterpolation(Double x1, Double x2, Double y1, Double y2, Double x)

Передаваемые параметры:

Название	Тип	Описание	Примечание
x1	Double	Аргумент x1
x2	Double	Аргумент x2
y1	Double	Аргумент y1
y2	Double	Аргумент y2
x	Double	Аргумент x

Возвращаемое значение : (Double) Интерполированное значение

IsBitRaised

Проверить поднят ли бит в числе

Объявление:

Boolean IsBitRaised(Int64 value, Byte bitNumber)

Передаваемые параметры:

Название	Тип	Описание	Примечание
value	Int64	Число
bitNumber	Byte	Номер бита

Возвращаемое значение : (Boolean) Если бит поднят - true, иначе - false

MathRandom

Сгенерировать случайное значение

Объявление:

Double MathRandom(Double min, Double max)

Передаваемые параметры:

Название	Тип	Описание	Примечание
min	Double	Левая граница
max	Double	Правая граница

Возвращаемое значение : (Double) Случайное значение

MathAvg

Вычислить среднее значение

Объявление:

AggregationValue MathAvg(String parameter, Object[] values, TimeInterval interval)

Передаваемые параметры:

Название	Тип	Описание	Примечание
parameter	String	Название параметра
values	Object[]	Значения
interval	TimeInterval	Интервал агрегации

Возвращаемое значение : (AggregationValue) Среднее значение

GetParameterValuesAvg

Вычислить среднее значение

Объявление:

AggregationValue GetParameterValuesAvg(String parameterName, Nullable<DateTime> startDate, Nullable<DateTime> endDate, Boolean throwErrorWhenNoData)

Передаваемые параметры:

Название	Тип	Описание	Примечание
parameterName	String	Название параметра
startDate	Nullable<DateTime>	Начало периода	Необязательный
endDate	Nullable<DateTime>	Конец периода	Необязательный
throwErrorWhenNoData	Boolean	Прерывать расчет ошибкой, если нет данных	Необязательный. По умолчанию true. Если false, то при отсутствии данных вместо ошибки отображается значение, заданное в настройках параметра Агрегация

Возвращаемое значение : (AggregationValue) Среднее значение

MathSum

Вычислить суммарное значение

Объявление:

AggregationValue MathSum(String parameter, Object[] values, TimeInterval interval)

Передаваемые параметры:

Название	Тип	Описание	Примечание
parameter	String	Название параметра
values	Object[]	Значения
interval	TimeInterval	Интервал агрегации

Возвращаемое значение : (AggregationValue) Суммарное значение

GetParameterValuesSum

Вычислить суммарное значение параметра

Объявление:

AggregationValue GetParameterValuesSum(String parameterName, Nullable<DateTime> startDate, Nullable<DateTime> endDate, Boolean throwErrorWhenNoData)

Передаваемые параметры:

Название	Тип	Описание	Примечание
parameterName	String	Название параметра
startDate	Nullable<DateTime>	Начало периода	Необязательный
endDate	Nullable<DateTime>	Конец периода	Необязательный
throwErrorWhenNoData	Boolean	Прерывать расчет ошибкой, если нет данных (для суммы пустого набора возвращается ноль)	Необязательный. По умолчанию true. Если false, то при отсутствии данных вместо ошибки отображается значение, заданное в настройках параметра Агрегация

Возвращаемое значение : (AggregationValue) Суммарное значение

MathMax

Вычислить максимальное значение

Объявление:

AggregationValue MathMax(String parameter, Object[] values, TimeInterval interval)

Передаваемые параметры:

Название	Тип	Описание	Примечание
parameter	String	Название параметра
values	Object[]	Значения
interval	TimeInterval	Интервал агрегации

Возвращаемое значение : (AggregationValue) Максимальное значение

GetParameterValuesMax

Вычислить максимальное значение параметра

Объявление:

AggregationValue GetParameterValuesMax(String parameterName, Nullable<DateTime> startDate, Nullable<DateTime> endDate, Boolean throwErrorWhenNoData)

Передаваемые параметры:

Название	Тип	Описание	Примечание
parameterName	String	Название параметра
startDate	Nullable<DateTime>	Начало периода	Необязательный
endDate	Nullable<DateTime>	Конец периода	Необязательный
throwErrorWhenNoData	Boolean	Прерывать расчет ошибкой, если нет данных	Необязательный. По умолчанию true. Если false, то при отсутствии данных вместо ошибки отображается значение, заданное в настройках параметра Агрегация

Возвращаемое значение : (AggregationValue) Максимальное значение

MathMin

Вычислить минимальное значение

Объявление:

AggregationValue MathMin(String parameter, Object[] values, TimeInterval interval)

Передаваемые параметры:

Название	Тип	Описание	Примечание
parameter	String	Название параметра
values	Object[]	Значения
interval	TimeInterval	Интервал агрегации

Возвращаемое значение : (AggregationValue) Минимальное значение

GetParameterValuesMin

Вычислить минимальное значение значение параметра

Объявление:

AggregationValue GetParameterValuesMin(String parameterName, Nullable<DateTime> startDate, Nullable<DateTime> endDate, Boolean throwErrorWhenNoData)

Передаваемые параметры:

Название	Тип	Описание	Примечание
parameterName	String	Название параметра
startDate	Nullable<DateTime>	Начало периода	Необязательный
endDate	Nullable<DateTime>	Конец периода	Необязательный
throwErrorWhenNoData	Boolean	Прерывать расчет ошибкой, если нет данных	Необязательный. По умолчанию true. Если false, то при отсутствии данных вместо ошибки отображается значение, заданное в настройках параметра Агрегация

Возвращаемое значение : (AggregationValue) Минимальное значение

Формулы для чтения данных из СУБД 'Microsoft SQL Server'

SqlQueryAsStringArray

Выполнить запрос к СУБД 'Microsoft SQL Server'

Объявление:

String[][] SqlQueryAsStringArray(String connectionString, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (String[][]) Результат выполнения запроса в виде матрицы строк

SqlQueryAsString

Выполнить запрос к СУБД 'Microsoft SQL Server'

Объявление:

String SqlQueryAsString(String connectionString, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки	Необязательный
columnIndex	Int32	Индекс столбца	Необязательный

Возвращаемое значение : (String) Результат выполнения запроса в виде строки

SqlQueryAsDoubleArray

Выполнить запрос к СУБД 'Microsoft SQL Server'

Объявление:

Double[][] SqlQueryAsDoubleArray(String connectionString, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (Double[][]) Результат выполнения запроса в виде матрицы чисел

SqlQueryAsDouble

Выполнить запрос к СУБД 'Microsoft SQL Server'

Объявление:

Double SqlQueryAsDouble(String connectionString, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки	Необязательный
columnIndex	Int32	Индекс столбца	Необязательный

Возвращаемое значение : (Double) Результат выполнения запроса в виде числа

SqlQueryAsObjectArray

Выполнить запрос к СУБД 'Microsoft SQL Server'

Объявление:

Object[][] SqlQueryAsObjectArray(String connectionString, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (Object[][]) Результат выполнения запроса в виде матрицы значений

SqlQueryAsHtmlTable

Выполнить запрос к СУБД 'Microsoft SQL Server'

Объявление:

ReportTable SqlQueryAsHtmlTable(String connectionString, String sql, Boolean includeHeader)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных
includeHeader	Boolean	Загрузить заголовки (true - да, false - нет)

Возвращаемое значение : (ReportTable) Результат выполнения запроса в виде таблицы

SqlQueryAsStringArrayByConnection

Выполнить запрос к СУБД 'Microsoft SQL Server'

Объявление:

String[][] SqlQueryAsStringArrayByConnection(String connectionGuid, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (String[][]) Результат выполнения запроса в виде матрицы строк

SqlQueryAsStringByConnection

Выполнить запрос к СУБД 'Microsoft SQL Server'

Объявление:

String SqlQueryAsStringByConnection(String connectionGuid, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки	Необязательный
columnIndex	Int32	Индекс столбца	Необязательный

Возвращаемое значение : (String) Результат выполнения запроса в виде строки

SqlQueryAsDoubleArrayByConnection

Выполнить запрос к СУБД 'Microsoft SQL Server'

Объявление:

Double[][] SqlQueryAsDoubleArrayByConnection(String connectionGuid, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (Double[][]) Результат выполнения запроса в виде матрицы чисел

SqlQueryAsDoubleByConnection

Выполнить запрос к СУБД 'Microsoft SQL Server'

Объявление:

Double SqlQueryAsDoubleByConnection(String connectionGuid, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки	Необязательный
columnIndex	Int32	Индекс столбца	Необязательный

Возвращаемое значение : (Double) Результат выполнения запроса в виде числа

SqlQueryAsObjectArrayByConnection

Выполнить запрос к СУБД 'Microsoft SQL Server'

Объявление:

Object[][] SqlQueryAsObjectArrayByConnection(String connectionGuid, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (Object[][]) Результат выполнения запроса в виде матрицы значений

SqlQueryAsHtmlTableByConnection

Выполнить запрос к СУБД 'Microsoft SQL Server'

Объявление:

ReportTable SqlQueryAsHtmlTableByConnection(String connectionGuid, String sql, Boolean includeHeader)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных
includeHeader	Boolean	Загрузить заголовки (true - да, false - нет)

Возвращаемое значение : (ReportTable) Результат выполнения запроса в виде таблицы

Формулы для чтения данных из СУБД 'MySQL'

MySqlQueryAsStringArray

Выполнить запрос к СУБД 'MySQL'

Объявление:

String[][] MySqlQueryAsStringArray(String connectionString, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (String[][]) Результат выполнения запроса в виде матрицы строк

MySqlQueryAsString

Выполнить запрос к СУБД 'MySQL'

Объявление:

String MySqlQueryAsString(String connectionString, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки	Необязательный
columnIndex	Int32	Индекс столбца	Необязательный

Возвращаемое значение : (String) Результат выполнения запроса в виде строки

MySqlQueryAsDoubleArray

Выполнить запрос к СУБД 'MySQL'

Объявление:

Double[][] MySqlQueryAsDoubleArray(String connectionString, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (Double[][]) Результат выполнения запроса в виде матрицы чисел

MySqlQueryAsDouble

Выполнить запрос к СУБД 'MySQL'

Объявление:

Double MySqlQueryAsDouble(String connectionString, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки	Необязательный
columnIndex	Int32	Индекс столбца	Необязательный

Возвращаемое значение : (Double) Результат выполнения запроса в виде числа

MySqlQueryAsObjectArray

Выполнить запрос к СУБД 'MySQL'

Объявление:

Object[][] MySqlQueryAsObjectArray(String connectionString, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (Object[][]) Результат выполнения запроса в виде матрицы значений

MySqlQueryAsHtmlTable

Выполнить запрос к СУБД 'MySQL'

Объявление:

ReportTable MySqlQueryAsHtmlTable(String connectionString, String sql, Boolean includeHeader)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных
includeHeader	Boolean	Загрузить заголовки(true - да, false - нет)

Возвращаемое значение : (ReportTable) Результат выполнения запроса в виде таблицы

MySqlQueryAsStringArrayByConnection

Выполнить запрос к СУБД 'MySQL'

Объявление:

String[][] MySqlQueryAsStringArrayByConnection(String connectionGuid, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (String[][]) Результат выполнения запроса в виде матрицы строк

MySqlQueryAsStringByConnection

Выполнить запрос к СУБД 'MySQL'

Объявление:

String MySqlQueryAsStringByConnection(String connectionGuid, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки	Необязательный
columnIndex	Int32	Индекс столбца	Необязательный

Возвращаемое значение : (String) Результат выполнения запроса в виде строки

MySqlQueryAsDoubleArrayByConnection

Выполнить запрос к СУБД 'MySQL'

Объявление:

Double[][] MySqlQueryAsDoubleArrayByConnection(String connectionGuid, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (Double[][]) Результат выполнения запроса в виде матрицы чисел

MySqlQueryAsDoubleByConnection

Выполнить запрос к СУБД 'MySQL'

Объявление:

Double MySqlQueryAsDoubleByConnection(String connectionGuid, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки	Необязательный
columnIndex	Int32	Индекс столбца	Необязательный

Возвращаемое значение : (Double) Результат выполнения запроса в виде числа

MySqlQueryAsObjectArrayByConnection

Выполнить запрос к СУБД 'MySQL'

Объявление:

Object[][] MySqlQueryAsObjectArrayByConnection(String connectionGuid, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (Object[][]) Результат выполнения запроса в виде матрицы значений

MySqlQueryAsTableByConnection

Выполнить запрос к СУБД 'MySQL'

Объявление:

ReportTable MySqlQueryAsTableByConnection(String connectionGuid, String sql, Boolean includeHeader)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных
includeHeader	Boolean	Загрузить заголовки (true - да, false - нет)

Возвращаемое значение : (ReportTable) Результат выполнения запроса в виде таблицы

Формулы для чтения данных при помощи интерфейса 'ODBC'

OdbcTable

Выполнить запрос при помощи интерфейса 'ODBC'

Объявление:

ReportTable OdbcTable(String connectionString, String sql, Boolean includeHeader)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных
includeHeader	Boolean	Загрузить заголовки (true - да, false - нет)

Возвращаемое значение : (ReportTable) Результат выполнения запроса в виде таблицы

OdbcDoubleArray

Выполнить запрос при помощи интерфейса 'ODBC'

Объявление:

Double[][] OdbcDoubleArray(String connectionString, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (Double[][]) Результат выполнения запроса в виде матрицы чисел

OdbcDouble

Выполнить запрос при помощи интерфейса 'ODBC'

Объявление:

Double OdbcDouble(String connectionString, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки
columnIndex	Int32	Индекс столбца

Возвращаемое значение : (Double) Результат выполнения запроса в виде числа

OdbcStringArray

Выполнить запрос при помощи интерфейса 'ODBC'

Объявление:

String[][] OdbcStringArray(String connectionString, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (String[][]) Результат выполнения запроса в виде матрицы строк

OdbcString

Выполнить запрос при помощи интерфейса 'ODBC'

Объявление:

String OdbcString(String connectionString, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки
columnIndex	Int32	Индекс столбца

Возвращаемое значение : (String) Результат выполнения запроса в виде строки

OdbcAsObjectArray

Выполнить запрос при помощи интерфейса 'ODBC'

Объявление:

Object[][] OdbcAsObjectArray(String connectionString, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (Object[][]) Результат выполнения запроса в виде матрицы значений

OdbcTableByConnection

Выполнить запрос при помощи интерфейса 'ODBC'

Объявление:

ReportTable OdbcTableByConnection(String connectionGuid, String sql, Boolean includeHeader)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных
includeHeader	Boolean	Загрузить заголовки (true - да, false - нет)

Возвращаемое значение : (ReportTable) Результат выполнения запроса в виде таблицы

OdbcDoubleArrayByConnection

Выполнить запрос при помощи интерфейса 'ODBC'

Объявление:

Double[][] OdbcDoubleArrayByConnection(String connectionGuid, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (Double[][]) Результат выполнения запроса в виде матрицы чисел

OdbcStringArrayByConnection

Выполнить запрос при помощи интерфейса 'ODBC'

Объявление:

String[][] OdbcStringArrayByConnection(String connectionGuid, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (String[][]) Результат выполнения запроса в виде матрицы строк

OdbcStringByConnection

Выполнить запрос при помощи интерфейса 'ODBC'

Объявление:

String OdbcStringByConnection(String connectionGuid, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки
columnIndex	Int32	Индекс столбца

Возвращаемое значение : (String) Результат выполнения запроса в виде строки

OdbcAsObjectArrayByConnection

Выполнить запрос при помощи интерфейса 'ODBC'

Объявление:

Object[][] OdbcAsObjectArrayByConnection(String connectionGuid, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (Object[][]) Результат выполнения запроса в виде матрицы значений

OdbcDoubleByConnection

Выполнить запрос при помощи интерфейса 'ODBC'

Объявление:

Double OdbcDoubleByConnection(String connectionGuid, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки
columnIndex	Int32	Индекс столбца

Возвращаемое значение : (Double) Результат выполнения запроса в виде числа

Формулы для чтения данных при помощи интерфейса 'OLEDB'

OleDbTable

Выполнить запрос при помощи интерфейса 'OLEDB'

Объявление:

ReportTable OleDbTable(String connectionString, String sql, Boolean includeHeader)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных
includeHeader	Boolean	Загрузить заголовки (true - да, false - нет)

Возвращаемое значение : (ReportTable) Результат выполнения запроса в виде таблицы

OleDbDoubleArray

Выполнить запрос при помощи интерфейса 'OLEDB'

Объявление:

Double[][] OleDbDoubleArray(String connectionString, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (Double[][]) Результат выполнения запроса в виде матрицы чисел

OleDbDouble

Выполнить запрос при помощи интерфейса 'OLEDB'

Объявление:

Double OleDbDouble(String connectionString, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки
columnIndex	Int32	Индекс столбца

Возвращаемое значение : (Double) Результат выполнения запроса в виде числа

OleDbQueryAsStringArray

Выполнить запрос при помощи интерфейса 'OLEDB'

Объявление:

String[][] OleDbQueryAsStringArray(String connectionString, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (String[][]) Результат выполнения запроса в виде матрицы строк

OleDbString

Выполнить запрос при помощи интерфейса 'OLEDB'

Объявление:

String OleDbString(String connectionString, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки
columnIndex	Int32	Индекс столбца

Возвращаемое значение : (String) Результат выполнения запроса в виде строки

OleDbTableByConnection

Выполнить запрос при помощи интерфейса 'OLEDB'

Объявление:

ReportTable OleDbTableByConnection(String connectionGuid, String sql, Boolean includeHeader)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных
includeHeader	Boolean	Загрузить заголовки (true - да, false - нет)

Возвращаемое значение : (ReportTable) Результат выполнения запроса в виде таблицы

OleDbDoubleArrayByConnection

Выполнить запрос при помощи интерфейса 'OLEDB'

Объявление:

Double[][] OleDbDoubleArrayByConnection(String connectionGuid, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (Double[][]) Результат выполнения запроса в виде матрицы чисел

OleDbQueryAsDoubleByConnection

Выполнить запрос при помощи интерфейса 'OLEDB'

Объявление:

Double OleDbQueryAsDoubleByConnection(String connectionGuid, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки
columnIndex	Int32	Индекс столбца

Возвращаемое значение : (Double) Результат выполнения запроса в виде числа

OleDbQueryAsStringArrayByConnection

Выполнить запрос при помощи интерфейса 'OLEDB'

Объявление:

String[][] OleDbQueryAsStringArrayByConnection(String connectionGuid, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (String[][]) Результат выполнения запроса в виде матрицы строк

OleDbQueryAsStringByConnection

Выполнить запрос при помощи интерфейса 'OLEDB'

Объявление:

String OleDbQueryAsStringByConnection(String connectionGuid, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки
columnIndex	Int32	Индекс столбца

Возвращаемое значение : (String) Результат выполнения запроса в виде строки

Формулы для чтения данных при помощи интерфейса 'OPC'

GetOpcValueByConnection

Загрузить значение тега из OPC сервера

Объявление:

OpcValue GetOpcValueByConnection(String connectionGuid, String tag)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
tag	String	Название тега

Возвращаемое значение : (OpcValue) Значение тега

GetOpcHdaValueByConnection

Загрузить историческое значение тега из OPC сервера

Объявление:

OpcValue GetOpcHdaValueByConnection(String connectionGuid, String tag, DateTime timestamp)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
tag	String	Название тега
timestamp	DateTime	Начало интервала

Возвращаемое значение : (OpcValue) Значение тега

GetOpcHdaValuesByConnection

Загрузить массив исторических значений тега из OPC сервера

Объявление:

OpcValue[] GetOpcHdaValuesByConnection(String connectionGuid, String tag, DateTime start, DateTime end, Boolean includeBounds, Nullable<UInt32> maxRecords)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
tag	String	Название тега
start	DateTime	Начало интервала
end	DateTime	Конец интервала
includeBounds	Boolean	Включать границы	Необязательный
maxRecords	Nullable<UInt32>	Максимальное количество записей	Необязательный

Возвращаемое значение : (OpcValue[]) Массив значений тегов

SetOpcValueByConnection

Установить значение тега OPC

Объявление:

Int32 SetOpcValueByConnection(String connectionGuid, String tag, Object value)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
tag	String	Название тега
value	Object	Значение тега

Возвращаемое значение : (Int32) 0 - если значение успешно установлено

Формулы для чтения данных из модуля 'Наработка оборудования'

OperationTimeGetDurationForPeriod

Загрузить продолжительность пребывания оборудования в определенном состоянии за период

Объявление:

Double OperationTimeGetDurationForPeriod(String deviceName, String parameterName, String stateName, DateTime startDate, DateTime endDate)

Передаваемые параметры:

Название	Тип	Описание	Примечание
deviceName	String	Наименование оборудования
parameterName	String	Наименование параметра наработки
stateName	String	Наименование состояния, в котором оборудование должно было находиться
startDate	DateTime	Дата начала периода
endDate	DateTime	Дата окончания периода

Возвращаемое значение : (Double) Продолжительность пребывания оборудования в состоянии за период (в часах)

OperationTimeGetCountOfEntriesForPeriod

Загрузить количество вхождений оборудования в определенное состояние за период

Объявление:

Int32 OperationTimeGetCountOfEntriesForPeriod(String deviceName, String parameterName, String stateName, DateTime startDate, DateTime endDate)

Передаваемые параметры:

Название	Тип	Описание	Примечание
deviceName	String	Наименование оборудования
parameterName	String	Наименование параметра наработки
stateName	String	Наименование состояния, в котором оборудование должно было находиться
startDate	DateTime	Дата начала периода
endDate	DateTime	Дата окончания периода

Возвращаемое значение : (Int32) Количество вхождений оборудования в определённое состояние

OperationTimeGetPeriodsOfStateForPeriod

Загрузить полный список пребываний всего оборудования в определенном состоянии

Объявление:

OperationTimeDevicePeriodInfo[] OperationTimeGetPeriodsOfStateForPeriod(String parameterName, String stateName, DateTime startDate, DateTime endDate)

Передаваемые параметры:

Название	Тип	Описание	Примечание
parameterName	String	Наименование параметра наработки
stateName	String	Наименование состояния, в котором оборудование должно было находиться
startDate	DateTime	Дата начала периода
endDate	DateTime	Дата окончания периода

Возвращаемое значение : (OperationTimeDevicePeriodInfo[]) Список пребываний оборудований в определенном состоянии

OperationTimeGetInfoForPeriod

Загрузить информацию по наработке за период

Объявление:

OperationTimeDeviceStateInfo[] OperationTimeGetInfoForPeriod(String parameterName, DateTime startDate, DateTime endDate)

Передаваемые параметры:

Название	Тип	Описание	Примечание
parameterName	String	Наименование параметра наработки
startDate	DateTime	Дата начала периода
endDate	DateTime	Дата окончания периода

Возвращаемое значение : (OperationTimeDeviceStateInfo[]) Информация по наработке за период

OperationTimeGetDurationLastStateOnDate

Загрузить информации по последнему пребыванию оборудования в определенном состоянии с начала года

Объявление:

Dictionary<String, Double> OperationTimeGetDurationLastStateOnDate(String parameterName, String stateName, DateTime date)

Передаваемые параметры:

Название	Тип	Описание	Примечание
parameterName	String	Наименование параметра наработки
stateName	String	Наименование состояния, в котором оборудование должно было находиться
date	DateTime	Дата окончания периода

Возвращаемое значение : (Dictionary<String, Double>) Словарь, содержащий ключи - название оборудования и значения - продолжительности (в сутках) последнего пребывания оборудования в определенном состоянии

OperationTimeGetLogForPeriod

Загрузить журнал изменения состояний оборудования за период

Объявление:

OperationTimeParameterLog OperationTimeGetLogForPeriod(String parameterName, DateTime startDate, DateTime endDate)

Передаваемые параметры:

Название	Тип	Описание	Примечание
parameterName	String	Наименование параметра наработки
startDate	DateTime	Дата начала периода
endDate	DateTime	Дата окончания периода

Возвращаемое значение : (OperationTimeParameterLog) Журнал изменения состояний оборудования за период

Формулы для чтения данных из СУБД 'Oracle'

OracleQueryAsStringArray

Выполнить запрос к СУБД 'Oracle'

Объявление:

String[][] OracleQueryAsStringArray(String connectionString, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (String[][]) Результат выполнения запроса в виде матрицы строк

OracleQueryAsString

Выполнить запрос к СУБД 'Oracle'

Объявление:

String OracleQueryAsString(String connectionString, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки	Необязательный
columnIndex	Int32	Индекс столбца	Необязательный

Возвращаемое значение : (String) Результат выполнения запроса в виде строки

OracleQueryAsDoubleArray

Выполнить запрос к СУБД 'Oracle'

Объявление:

Double[][] OracleQueryAsDoubleArray(String connectionString, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (Double[][]) Результат выполнения запроса в виде матрицы чисел

OracleQueryAsDouble

Выполнить запрос к СУБД 'Oracle'

Объявление:

Double OracleQueryAsDouble(String connectionString, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки	Необязательный
columnIndex	Int32	Индекс столбца	Необязательный

Возвращаемое значение : (Double) Результат выполнения запроса в виде числа

OracleQueryAsObjectArray

Выполнить запрос к СУБД 'Oracle'

Объявление:

Object[][] OracleQueryAsObjectArray(String connectionString, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (Object[][]) Результат выполнения запроса в виде матрицы значений

OracleQueryAsHtmlTable

Выполнить запрос к СУБД 'Oracle'

Объявление:

ReportTable OracleQueryAsHtmlTable(String connectionString, String sql, Boolean includeHeader)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных
includeHeader	Boolean	Загрузить заголовки (true - да, false - нет)

Возвращаемое значение : (ReportTable) Результат выполнения запроса в виде таблицы

OracleQueryAsStringArrayByConnection

Выполнить запрос к СУБД 'Oracle'

Объявление:

String[][] OracleQueryAsStringArrayByConnection(String connectionGuid, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (String[][]) Результат выполнения запроса в виде матрицы строк

OracleQueryAsStringByConnection

Выполнить запрос к СУБД 'Oracle'

Объявление:

String OracleQueryAsStringByConnection(String connectionGuid, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки	Необязательный
columnIndex	Int32	Индекс столбца	Необязательный

Возвращаемое значение : (String) Результат выполнения запроса в виде строки

OracleQueryAsDoubleArrayByConnection

Выполнить запрос к СУБД 'Oracle'

Объявление:

Double[][] OracleQueryAsDoubleArrayByConnection(String connectionGuid, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (Double[][]) Результат выполнения запроса в виде матрицы чисел

OracleQueryAsDoubleByConnection

Выполнить запрос к СУБД 'Oracle'

Объявление:

Double OracleQueryAsDoubleByConnection(String connectionGuid, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки	Необязательный
columnIndex	Int32	Индекс столбца	Необязательный

Возвращаемое значение : (Double) Результат выполнения запроса в виде числа

OracleQueryAsObjectArrayByConnection

Выполнить запрос к СУБД 'Oracle'

Объявление:

Object[][] OracleQueryAsObjectArrayByConnection(String connectionGuid, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (Object[][]) Результат выполнения запроса в виде матрицы значений

OracleQueryAsHtmlTableByConnection

Выполнить запрос к СУБД 'Oracle'

Объявление:

ReportTable OracleQueryAsHtmlTableByConnection(String connectionGuid, String sql, Boolean includeHeader)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных
includeHeader	Boolean	Загрузить заголовки (true - да, false - нет)

Возвращаемое значение : (ReportTable) Результат выполнения запроса в виде таблицы

Формулы для чтения данных из БД 'Пирамида'

GetLastPiramidaValueOnPeriod

Загрузить последнее значение точки данных за период из базы данных 'Пирамида'

Объявление:

PiramidaValue GetLastPiramidaValueOnPeriod(String connectionGuid, String objectName, PiramidaParameter parameter, DateTime startTime, DateTime endTime, Int32 defaultValue)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
objectName	String	Имя точки данных
parameter	PiramidaParameter	Параметр измерений
startTime	DateTime	Дата начала периода
endTime	DateTime	Дата окончания периода
defaultValue	Int32	Значение по-умолчанию	Необязательный

Возвращаемое значение : (PiramidaValue) Последнее значение точки данных

GetPiramidaDiscreteStatesOnPeriod

Загрузить массив состояний дискретного канала за период из базы данных 'Пирамида'

Объявление:

PiramidaDiscretState[] GetPiramidaDiscreteStatesOnPeriod(String connectionGuid, String discreteGroupName, String discreteName, TimeInterval interval)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
discreteGroupName	String	Имя дискрета
discreteName	String	Имя дискрета
interval	TimeInterval	Даты начала и окончания периода

Возвращаемое значение : (PiramidaDiscretState[]) Массив состояний дискретного канала

GetLastPiramidaDiscreteStateOnTime

Загрузить состояние дискретного канала на момент времени из базы данных 'Пирамида'

Объявление:

PiramidaDiscretState GetLastPiramidaDiscreteStateOnTime(String connectionGuid, String discreteGroupName, String discreteName, DateTime time, PiramidaDiscretStatus defaultValue)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
discreteGroupName	String	Имя дискрета
discreteName	String	Имя дискрета
time	DateTime	Момент времени
defaultValue	PiramidaDiscretStatus	Значение по умолчанию

Возвращаемое значение : (PiramidaDiscretState) Состояние дискретного канала

PiramidaQuery

Выполнить запрос к базе данных 'Пирамида'

Объявление:

Object[][] PiramidaQuery(String connectionGuid, String query)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
query	String	Текст запроса

Возвращаемое значение : (Object[][]) Результат выполнения запроса в виде матрицы значений

GetLastPiramidaValue

Загрузить последнее значения точки данных за период

Объявление:

PiramidaValue GetLastPiramidaValue(String connectionGuid, Int32 objCode, Int32 objItem, DateTime startTime, DateTime endTime)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения с базой данных 'Пирамида'
objCode	Int32	Код объекта
objItem	Int32	Код элемента объекта
startTime	DateTime	Дата начала периода
endTime	DateTime	Дата окончания периода

Возвращаемое значение : (PiramidaValue) Последнее значение точки данных

Формулы для чтения данных СУБД 'PostgreSQL'

PostgreSqlQueryAsStringArray

Выполнить запрос к СУБД 'PostgreSQL'

Объявление:

String[][] PostgreSqlQueryAsStringArray(String connectionString, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (String[][]) Результат выполнения запроса в виде матрицы строк

PostgreSqlQueryAsString

Выполнить запрос к СУБД 'PostgreSQL'

Объявление:

String PostgreSqlQueryAsString(String connectionString, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки	Необязательный
columnIndex	Int32	Индекс столбца	Необязательный

Возвращаемое значение : (String) Результат выполнения запроса в виде строки

PostgreSqlQueryAsDoubleArray

Выполнить запрос к СУБД 'PostgreSQL'

Объявление:

Double[][] PostgreSqlQueryAsDoubleArray(String connectionString, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (Double[][]) Результат выполнения запроса в виде матрицы чисел

PostgreSqlQueryAsDouble

Выполнить запрос к СУБД 'PostgreSQL'

Объявление:

Double PostgreSqlQueryAsDouble(String connectionString, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки	Необязательный
columnIndex	Int32	Индекс столбца	Необязательный

Возвращаемое значение : (Double) Результат выполнения запроса в виде числа

PostgreSqlQueryAsObjectArray

Выполнить запрос к СУБД 'PostgreSQL'

Объявление:

Object[][] PostgreSqlQueryAsObjectArray(String connectionString, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (Object[][]) Результат выполнения запроса в виде матрицы значений

PostgreSqlQueryAsTable

Выполнить запрос к СУБД 'PostgreSQL'

Объявление:

ReportTable PostgreSqlQueryAsTable(String connectionString, String sql, Boolean includeHeader)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionString	String	Строка соединения
sql	String	Запрос для выборки данных
includeHeader	Boolean	Загрузить заголовки (true - да, false - нет)

Возвращаемое значение : (ReportTable) Результат выполнения запроса в виде таблицы

PostgreSqlQueryAsStringArrayByConnection

Выполнить запрос к СУБД 'PostgreSQL'

Объявление:

String[][] PostgreSqlQueryAsStringArrayByConnection(String connectionGuid, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (String[][]) Результат выполнения запроса в виде матрицы строк

PostgreSqlQueryAsStringByConnection

Выполнить запрос к СУБД 'PostgreSQL'

Объявление:

String PostgreSqlQueryAsStringByConnection(String connectionGuid, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки	Необязательный
columnIndex	Int32	Индекс столбца	Необязательный

Возвращаемое значение : (String) Результат выполнения запроса в виде строки

PostgreSqlQueryAsDoubleArrayByConnection

Выполнить запрос к СУБД 'PostgreSQL'

Объявление:

Double[][] PostgreSqlQueryAsDoubleArrayByConnection(String connectionGuid, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (Double[][]) Результат выполнения запроса в виде матрицы чисел

PostgreSqlQueryAsDoubleByConnection

Выполнить запрос к СУБД 'PostgreSQL'

Объявление:

Double PostgreSqlQueryAsDoubleByConnection(String connectionGuid, String sql, Int32 rowIndex, Int32 columnIndex)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных
rowIndex	Int32	Индекс строки	Необязательный
columnIndex	Int32	Индекс столбца	Необязательный

Возвращаемое значение : (Double) Результат выполнения запроса в виде числа

PostgreSqlQueryAsObjectArrayByConnection

Выполнить запрос к СУБД 'PostgreSQL'

Объявление:

Object[][] PostgreSqlQueryAsObjectArrayByConnection(String connectionGuid, String sql)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных

Возвращаемое значение : (Object[][]) Результат выполнения запроса в виде матрицы значений

PostgreSqlQueryAsTableByConnection

Выполнить запрос к СУБД 'PostgreSQL'

Объявление:

ReportTable PostgreSqlQueryAsTableByConnection(String connectionGuid, String sql, Boolean includeHeader)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных
includeHeader	Boolean	Загрузить заголовки (true - да, false - нет)

Возвращаемое значение : (ReportTable) Результат выполнения запроса в виде таблицы

Формулы для чтения данных из отчетов

ReportGetAllValues

Загрузить все значения отчета

Объявление:

StoredReportValue[] ReportGetAllValues(String reportName, DateTime reportStartDate, DateTime reportEndDate, String[] ignoredParameters, Dictionary<String, Object> predefinedValues)

Передаваемые параметры:

Название	Тип	Описание	Примечание
reportName	String	Название отчета
reportStartDate	DateTime	Дата начала отчета
reportEndDate	DateTime	Дата окончания отчета
ignoredParameters	String[]	Игнорируемые параметры
predefinedValues	Dictionary<String, Object>	Значения предопределяемых параметров	Необязательный

Возвращаемое значение : (StoredReportValue[]) Массив значений отчета

ReportGetParametersValuesOnTimestamp

Загрузить массив значений параметров отчета за метку времени

Объявление:

StoredReportValue[] ReportGetParametersValuesOnTimestamp(String reportName, DateTime reportStartDate, DateTime reportEndDate, DateTime timestamp, String[] parameters, Dictionary<String, Object> predefinedValues)

Передаваемые параметры:

Название	Тип	Описание	Примечание
reportName	String	Название отчета
reportStartDate	DateTime	Дата начала отчета
reportEndDate	DateTime	Дата окончания отчета
timestamp	DateTime	Метка времени
parameters	String[]	Запрашиваемые параметры в виде 'Параметр'
predefinedValues	Dictionary<String, Object>	Значения предопределяемых параметров	Необязательный

Возвращаемое значение : (StoredReportValue[]) Массив значений отчета

ReportGetParameterValuesByParameter

Загрузить массив значений параметра отчета

Объявление:

StoredReportValue[] ReportGetParameterValuesByParameter(String reportName, DateTime reportStartDate, DateTime reportEndDate, String parameter, Dictionary<String, Object> predefinedValues)

Передаваемые параметры:

Название	Тип	Описание	Примечание
reportName	String	Название отчета
reportStartDate	DateTime	Дата начала отчета
reportEndDate	DateTime	Дата окончания отчета
parameter	String	Запрашиваемый параметр в виде 'Параметр'
predefinedValues	Dictionary<String, Object>	Значения предопределяемых параметров	Необязательный

Возвращаемое значение : (StoredReportValue[]) Массив значений отчета

ReportGetParametersValues

Загрузить массив значений параметров отчета

Объявление:

StoredReportValue[] ReportGetParametersValues(String reportName, DateTime reportStartDate, DateTime reportEndDate, String[] parameters, Dictionary<String, Object> predefinedValues)

Передаваемые параметры:

Название	Тип	Описание	Примечание
reportName	String	Название отчета
reportStartDate	DateTime	Дата начала отчета
reportEndDate	DateTime	Дата окончания отчета
parameters	String[]	Запрашиваемые параметры в виде 'Параметр'
predefinedValues	Dictionary<String, Object>	Значения предопределяемых параметров	Необязательный

Возвращаемое значение : (StoredReportValue[]) Массив значений отчета

ReportGetPreviousParameterValue

Загрузить предыдущее значение параметра отчета

Объявление:

StoredReportValue ReportGetPreviousParameterValue(String reportName, String parameterIdent, Dictionary<String, Object> predefinedValues)

Передаваемые параметры:

Название	Тип	Описание	Примечание
reportName	String	Название отчета
parameterIdent	String	Запрашиваемый параметр в виде 'Параметр'
predefinedValues	Dictionary<String, Object>	Значения предопределяемых параметров	Необязательный

Возвращаемое значение : (StoredReportValue) Значение отчета

ReportGetValueByParameterOnTimestamp

Загрузить значения параметра отчета за метку времени

Объявление:

StoredReportValue ReportGetValueByParameterOnTimestamp(String reportName, DateTime reportStartDate, DateTime reportEndDate, DateTime timestamp, String parameterName, Dictionary<String, Object> predefinedValues)

Передаваемые параметры:

Название	Тип	Описание	Примечание
reportName	String	Название отчета
reportStartDate	DateTime	Дата начала отчета
reportEndDate	DateTime	Дата окончания отчета
timestamp	DateTime	Метка времени значения
parameterName	String	Запрашиваемый параметр в виде 'Параметр'
predefinedValues	Dictionary<String, Object>	Значения предопределяемых параметров	Необязательный

Возвращаемое значение : (StoredReportValue) Значение отчета

GetParameterValuesByTimestamps

Загрузить массив значений параметра текущего отчета за заданные метки времени

Объявление:

IEnumerable<StoredReportValue> GetParameterValuesByTimestamps(String parameterIdent, IEnumerable<DateTime> timestamps)

Передаваемые параметры:

Название	Тип	Описание	Примечание
parameterIdent	String	Идентификатор параметра
timestamps	IEnumerable<DateTime>	Метки времени

Возвращаемое значение : (IEnumerable<StoredReportValue>) Массив значений отчета

ReportExists

Проверить существует ли отчет с указанными данными

Объявление:

Boolean ReportExists(String reportName, DateTime reportStartDate, DateTime reportEndDate, Dictionary<String, Object> predefinedValues)

Передаваемые параметры:

Название	Тип	Описание	Примечание
reportName	String	Название отчета
reportStartDate	DateTime	Дата начала отчета
reportEndDate	DateTime	Дата окончания отчета
predefinedValues	Dictionary<String, Object>	Значения предопределяемых параметров	Необязательный

Возвращаемое значение : (Boolean) Если отчет существует - true, иначе - false

ReportGetParameterSafeIdent

Преобразовать идентификатор параметра к безопасному виду, который используется в значениях отчетов

Объявление:

String ReportGetParameterSafeIdent(String parameterIdent)

Передаваемые параметры:

Название	Тип	Описание	Примечание
parameterIdent	String	Идентификатор параметра

Возвращаемое значение : (String) Безопасный идентификатор параметра

Формулы для чтения данных из файлов

ReadAllTextByConnection

Загрузить содержимое файла

Объявление:

String ReadAllTextByConnection(String connectionGuid, Encoding encoding)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
encoding	Encoding	Кодировка файла	Необязательный

Возвращаемое значение : (String) Содержимое файла в виде строки

ReadAllText

Загрузить содержимое файла

Объявление:

String ReadAllText(String filePath, Encoding encoding)

Передаваемые параметры:

Название	Тип	Описание	Примечание
filePath	String	Путь к файлу
encoding	Encoding	Кодировка файла	Необязательный

Возвращаемое значение : (String) Содержимое файла в виде строки

ReadCsvFile

Загрузить содержимое файла в формате 'CSV'

Объявление:

String[][] ReadCsvFile(String filePath, CsvFileOptions options)

Передаваемые параметры:

Название	Тип	Описание	Примечание
filePath	String	Путь к файлу
options	CsvFileOptions	Настройки чтения данных	Необязательный

Возвращаемое значение : (String[][]) Содержимое файла в виде матрицы строк

ReadCsvFileByConnection

Загрузить содержимое файла в формате 'CSV'

Объявление:

String[][] ReadCsvFileByConnection(String connectionGuid, CsvFileOptions options)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
options	CsvFileOptions	Настройки чтения данных	Необязательный

Возвращаемое значение : (String[][]) Содержимое файла в виде матрицы строк

ReadCsvFile

Загрузить содержимое файла в формате 'CSV'

Объявление:

String[][] ReadCsvFile(Byte[] data, CsvFileOptions options)

Передаваемые параметры:

Название	Тип	Описание	Примечание
data	Byte[]	Данные файла
options	CsvFileOptions	Настройки чтения данных	Необязательный

Возвращаемое значение : (String[][]) Содержимое файла в виде матрицы строк

ReadCsvFile

Загрузить содержимое файла в формате 'CSV'

Объявление:

String[][] ReadCsvFile(Stream data, CsvFileOptions options)

Передаваемые параметры:

Название	Тип	Описание	Примечание
data	Stream	Данные файла
options	CsvFileOptions	Настройки чтения данных	Необязательный

Возвращаемое значение : (String[][]) Содержимое файла в виде матрицы строк

Формулы для чтения данных из 'WinCC'

WinccTableByConnection

Выполнить запрос к базе данных 'WinCC'

Объявление:

ReportTable WinccTableByConnection(String connectionGuid, String sql, String dbName, Boolean includeHeader)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных
dbName	String	Название базы данных
includeHeader	Boolean	Загрузить заголовки (true - да, false - нет)

Возвращаемое значение : (ReportTable) Результат выполнения запроса в виде таблицы

WinccDoubleArrayByConnection

Выполнить запрос к базе данных 'WinCC'

Объявление:

Double[][] WinccDoubleArrayByConnection(String connectionGuid, String sql, String dbName)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных
dbName	String	Название базы данных

Возвращаемое значение : (Double[][]) Результат выполнения запроса в виде матрицы чисел

WinccQueryAsStringArrayByConnection

Выполнить запрос к базе данных 'WinCC'

Объявление:

String[][] WinccQueryAsStringArrayByConnection(String connectionGuid, String sql, String dbName)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
sql	String	Запрос для выборки данных
dbName	String	Название базы данных

Возвращаемое значение : (String[][]) Результат выполнения запроса в виде матрицы строк

Формулы для чтения данных из КАСКАД 3 (InfluxDB)

WinccOaInfluxGet

Загрузить значение точки данных за указанную метку времени из 'КАСКАД 3 (InfluxDB)'

Объявление:

WinccOaValue WinccOaInfluxGet(String connectionGuid, String dpAddress, DateTime timestamp)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
dpAddress	String	Адрес точки данных
timestamp	DateTime	Метка времени

Возвращаемое значение : (WinccOaValue) Значение точки данных

WinccOaInfluxGetPeriod

Загрузить массив значений точки данных за период из 'КАСКАД 3 (InfluxDB)'

Объявление:

WinccOaValue[] WinccOaInfluxGetPeriod(String connectionGuid, String dpAddress, DateTime startTime, DateTime endTime)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
dpAddress	String	Адрес точки данных
startTime	DateTime	Дата начала периода
endTime	DateTime	Дата окончания периода

Возвращаемое значение : (WinccOaValue[]) Массив значений точки данных

Формулы для чтения данных из КАСКАД 3 (XMLRPC)

GetCurrent

Загрузить текущее значение точки данных из 'КАСКАД 3'

Объявление:

WinccOaValue GetCurrent(String connectionGuid, String address)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
address	String	Адрес точки данных

Возвращаемое значение : (WinccOaValue) Значение точки данных

Get

Загрузить значение точки данных за метку времени из 'КАСКАД 3'

Объявление:

WinccOaValue Get(String connectionGuid, String address, DateTime timestamp, Nullable<Int32> archiveNumber)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
address	String	Адрес точки данных
timestamp	DateTime	Метка времени
archiveNumber	Nullable<Int32>	Номер архивной группы (необязательный параметр)	Необязательный

Возвращаемое значение : (WinccOaValue) Значение точки данных

GetUserbit

Загрузить значение бита точки данных за метку времени из 'КАСКАД 3'

Объявление:

WinccOaValue GetUserbit(String connectionGuid, String address, DateTime timestamp, Int32 bitNumber, Nullable<Int32> archiveNumber)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
address	String	Адрес точки данных
timestamp	DateTime	Метка времени
bitNumber	Int32	Номер запрашиваемого бита
archiveNumber	Nullable<Int32>	Номер архивной группы (необязательный параметр)	Необязательный

Возвращаемое значение : (WinccOaValue) Значение бита точки данных

GetPeriod

Загрузить массив значений точки данных за период из 'КАСКАД 3'

Объявление:

WinccOaValue[] GetPeriod(String connectionGuid, String address, DateTime startTime, DateTime endTime, Nullable<Int32> archiveNumber, Int32 bonus)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
address	String	Адрес точки данных
startTime	DateTime	Дата начала периода
endTime	DateTime	Дата окончания периода
archiveNumber	Nullable<Int32>	Номер архивной группы (необязательный параметр)	Необязательный
bonus	Int32	Количество бонусных значений для запроса	Необязательный

Возвращаемое значение : (WinccOaValue[]) Массив значений точки данных

GetLast

Загрузить последнее значение точки данных перед меткой времени из 'КАСКАД 3'

Объявление:

WinccOaValue GetLast(String connectionGuid, String address, DateTime timestamp, Nullable<Int32> archiveNumber)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
address	String	Адрес точки данных
timestamp	DateTime	Метка времени
archiveNumber	Nullable<Int32>	Номер архивной группы (необязательный параметр)	Необязательный

Возвращаемое значение : (WinccOaValue) Последнее значение точки данных

LastOnPeriod

Загрузить последнее значение точки данных за период из 'КАСКАД 3'

Объявление:

WinccOaValue LastOnPeriod(String connectionGuid, String address, DateTime startTime, DateTime endTime, Nullable<Int32> archiveNumber)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
address	String	Адрес точки данных
startTime	DateTime	Дата начала периода
endTime	DateTime	Дата окончания периода
archiveNumber	Nullable<Int32>	Номер архивной группы (необязательный параметр)	Необязательный

Возвращаемое значение : (WinccOaValue) Последнее значение точки данных

Max

Загрузить максимальное значение точки данных за период из 'КАСКАД 3'

Объявление:

WinccOaValue Max(String connectionGuid, String address, DateTime startTime, DateTime endTime, Nullable<Int32> archiveNumber)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
address	String	Адрес точки данных
startTime	DateTime	Дата начала периода
endTime	DateTime	Дата окончания периода
archiveNumber	Nullable<Int32>	Номер архивной группы (необязательный параметр)	Необязательный

Возвращаемое значение : (WinccOaValue) Максимальное значение точки данных

Min

Загрузить минимальное значение точки данных за период из 'КАСКАД 3'

Объявление:

WinccOaValue Min(String connectionGuid, String address, DateTime startTime, DateTime endTime, Nullable<Int32> archiveNumber)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
address	String	Адрес точки данных
startTime	DateTime	Дата начала периода
endTime	DateTime	Дата окончания периода
archiveNumber	Nullable<Int32>	Номер архивной группы (необязательный параметр)	Необязательный

Возвращаемое значение : (WinccOaValue) Минимальное значение точки данных

Avg

Загрузить среднее значение точки данных за период из 'КАСКАД 3'

Объявление:

Double Avg(String connectionGuid, String address, DateTime startTime, DateTime endTime, Nullable<Int32> archiveNumber)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
address	String	Адрес точки данных
startTime	DateTime	Дата начала периода
endTime	DateTime	Дата окончания периода
archiveNumber	Nullable<Int32>	Номер архивной группы (необязательный параметр)	Необязательный

Возвращаемое значение : (Double) Среднее значение точки данных за период

ContinuousMax

Загрузить максимальное значение точки данных за период из 'КАСКАД 3'

Объявление:

WinccOaValue ContinuousMax(String connectionGuid, String address, DateTime startTime, DateTime endTime, Nullable<Int32> archiveNumber)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
address	String	Адрес точки данных
startTime	DateTime	Дата начала периода
endTime	DateTime	Дата окончания периода
archiveNumber	Nullable<Int32>	Номер архивной группы (необязательный параметр)	Необязательный

Возвращаемое значение : (WinccOaValue) Максимальное значение точки данных

ContinuousMin

Загрузить минимальное значение точки данных за период из 'КАСКАД 3'

Объявление:

WinccOaValue ContinuousMin(String connectionGuid, String address, DateTime startTime, DateTime endTime, Nullable<Int32> archiveNumber)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
address	String	Адрес точки данных
startTime	DateTime	Дата начала периода
endTime	DateTime	Дата окончания периода
archiveNumber	Nullable<Int32>	Номер архивной группы (необязательный параметр)	Необязательный

Возвращаемое значение : (WinccOaValue) Минимальное значение точки данных

ContinuousAvg

Загрузить среднее значение точки данных за период из 'КАСКАД 3'

Объявление:

Double ContinuousAvg(String connectionGuid, String address, DateTime startTime, DateTime endTime, Nullable<Int32> archiveNumber)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
address	String	Адрес точки данных
startTime	DateTime	Дата начала периода
endTime	DateTime	Дата окончания периода
archiveNumber	Nullable<Int32>	Номер архивной группы (необязательный параметр)	Необязательный

Возвращаемое значение : (Double) Среднее значение точки данных

WAvg

Загрузить средневзвешенное значение точки данных за период из 'КАСКАД 3'

Объявление:

Double WAvg(String connectionGuid, String address, DateTime startTime, DateTime endTime, Nullable<Int32> archiveNumber)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
address	String	Адрес точки данных
startTime	DateTime	Дата начала периода
endTime	DateTime	Дата окончания периода
archiveNumber	Nullable<Int32>	Номер архивной группы (необязательный параметр)	Необязательный

Возвращаемое значение : (Double) Средневзвешенное значение точки данных

Sum

Загрузить сумму значений точки данных за период из 'КАСКАД 3'

Объявление:

Double Sum(String connectionGuid, String address, DateTime startTime, DateTime endTime, Nullable<Int32> archiveNumber)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
address	String	Адрес точки данных
startTime	DateTime	Дата начала периода
endTime	DateTime	Дата окончания периода
archiveNumber	Nullable<Int32>	Номер архивной группы (необязательный параметр)	Необязательный

Возвращаемое значение : (Double) Сумма значений точки данных

GetAlarmsOnPeriod

Загрузить массив алармов точки данных за период из 'КАСКАД 3'

Объявление:

WinccOaAlarm[] GetAlarmsOnPeriod(String connectionGuid, String address, DateTime startTime, DateTime endTime)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
address	String	Адрес точки данных
startTime	DateTime	Дата начала периода
endTime	DateTime	Дата окончания периода

Возвращаемое значение : (WinccOaAlarm[]) Массив алармов точки данных

GetWinccoaAlarms

Загрузить таблицу алармов по указанным фильтрам из 'КАСКАД 3'

Объявление:

WinccOaAlarmsTable GetWinccoaAlarms(String connectionGuid, String tagsFilter, DateTime startDate, DateTime endDate, WinccOaAlarmField[] tableFields, String[] classFilter, Int32 directionFilterInt, Int32 bonus)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
tagsFilter	String	Фильтр по параметрам
startDate	DateTime	Стартовая дата
endDate	DateTime	Конечная дата
tableFields	WinccOaAlarmField[]	Поля таблицы
classFilter	String[]	Фильтр по классам сообщений
directionFilterInt	Int32	Фильтр по направлению
bonus	Int32	Количество значений до и после периода запроса, которое будет возвращено дополнительно	Необязательный

Возвращаемое значение : (WinccOaAlarmsTable) Таблица алармов

Count

Загрузить количество изменений точки данных за период из 'КАСКАД 3'

Объявление:

Int32 Count(String connectionGuid, String address, DateTime startTime, DateTime endTime, Nullable<Int32> archiveNumber)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
address	String	Адрес точки данных
startTime	DateTime	Дата начала периода
endTime	DateTime	Дата окончания периода
archiveNumber	Nullable<Int32>	Номер архивной группы (необязательный параметр)	Необязательный

Возвращаемое значение : (Int32) Количество изменений точки данных

QueryAsHtmlTable

Выполнить запрос к 'КАСКАД 3'

Объявление:

ReportTable QueryAsHtmlTable(String connectionGuid, String query, Boolean includeHeader)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
query	String	Запрос для выборки данных
includeHeader	Boolean	Загрузить заголовки (true - да, false - нет)

Возвращаемое значение : (ReportTable) Результат выполнения запроса в виде таблицы значений

GetDescription

Загрузить описание точки данных из 'КАСКАД 3'

Объявление:

String GetDescription(String connectionGuid, String address)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
address	String	Адрес точки данных

Возвращаемое значение : (String) Описание точки данных

GetUnit

Загрузить единицу измерения точки данных из 'КАСКАД 3'

Объявление:

String GetUnit(String connectionGuid, String address)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
address	String	Адрес точки данных

Возвращаемое значение : (String) Единица измерения точки данных

GetFormat

Загрузить формат точки данных из 'КАСКАД 3'

Объявление:

String GetFormat(String connectionGuid, String address)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
address	String	Адрес точки данных

Возвращаемое значение : (String) Формат точки данных

GetCatStr

Загрузить запись из каталога сообщений из 'КАСКАД 3'

Объявление:

String GetCatStr(String connectionGuid, String catalog, String messageKey, Int32 languageIdx)

Передаваемые параметры:

Название	Тип	Описание	Примечание
connectionGuid	String	Идентификатор соединения
catalog	String	Имя каталога сообщений
messageKey	String	Ключ сообщения
languageIdx	Int32	Индекс языка в проекте

Возвращаемое значение : (String) Запись из каталога сообщений

Структуры данных

DictionaryAttributeInstance

Атрибут экземпляра класса справочника

Свойства:

Название	Тип	Описание
Name	String	Название атрибута
Value	Object	Значение атрибута

DictionaryClassInstance

Экземпляр класса справочника

Свойства:

Название	Тип	Описание
Name	String	Название экземпляр класса
Code	String	Уникальный идентификатор
Attributes	IEnumerable<DictionaryAttributeInstance>	Атрибуты класса

AggregationValue

Значение агрегации параметра

Свойства:

Название	Тип	Описание
SourceParameter	String	Исходный параметр
Value	Nullable<Double>	Значение
Type	AggregationType	Тип агрегации
Interval	TimeInterval	Интервал за который расчитано значение агрегации
SourceParameters	String[]	Массив исходных параметров
HasNoData	Boolean	Признак отсутствия данных для расчета агрегации

ChartValue

Значение, отображаемое на графике

Свойства:

Название	Тип	Описание
Value	Nullable<Double>	Значение
Label	Object	Подпись, отображаемая на графике

DropDownValue

Выпадающий список

Свойства:

Название	Тип	Описание
Variants	DropDownVariant[]	Список вариантов
SelectedVariants	DropDownVariant[]	Список выбранных вариантов
CanMultipleSelect	Boolean	Разрешен ли множественный выбор
Value	String	Выбранный элемент списка
Values	List<String>	Выбранные элементы списка

DropDownVariant

Вариант выпадающего списка

Свойства:

Название	Тип	Описание
Ident	String	Идентификатор варианта
Name	String	Наименование варианта
IsSelected	Boolean	Выбран ли данный вариант

JsValue

Значение JavaScript

Свойства:

Название	Тип	Описание
Value	String	Значение

ReportKaskadValue

Значение из КАСКАД 4

Свойства:

Название	Тип	Описание
Address	String	Адрес тега
Value	Object	Значение
Timestamp	DateTime	Метка времени
Status	Int32	Статус

LogCell

Значение, отображаемое поле журнала

Свойства:

Название	Тип	Описание
Value	Object	Значение
Parameter	String	Название параметра

LogRow

Строка значений, отображаемых в журнале

Свойства:

Название	Тип	Описание
Cells	List<LogCell>	Значения
IsDeleted	Boolean	Была ли удалена строка

OpcValue

Значение тега OPC-сервера

Свойства:

Название	Тип	Описание
Address	String	Адрес тега
Value	Object	Значение
Timestamp	DateTime	Метка времени
Status	String	Статус

PiramidaDiscret

Описание дискретного канала из базы данных Piramida

Свойства:

Название	Тип	Описание

PiramidaDiscretState

Состояние дискретного канала из базы данных Piramida

Свойства:

Название	Тип	Описание
Discret	PiramidaDiscret	Дискретный канал
Active	PiramidaDiscretStatus	Состояние дискрета
Timestamp	DateTime	Метка времени перехода к состоянию

PiramidaValue

Значение параметра из базы данных Piramida

Свойства:

Название	Тип	Описание
RawValue	Double	Фактическое значение измерения
Value	Double	Значение
RoundedValue	Int32	Значение округленное по алгебраическим правилам
Timestamp	DateTime	Метка времени значения
RawTimestamp	DateTime	Метка времени записи в базу данных Piramida
RawStatus	String	Исходный статус источника

ReportChartValue

График отчета

Свойства:

Название	Тип	Описание
Width	Int32	Ширина
Height	Int32	Высота
Value	String	Значение

ReportFileValue

Значение пользовательского файла

Свойства:

Название	Тип	Описание
Name	String	Наименование файла
Type	String	Тип файла
Data	Byte[]	Данные файла

ReportTable

Таблица с заголовками и ячейками

Свойства:

Название	Тип	Описание
Headers	String[]	Заголовки
Cells	String[][]	Ячейки

StoredReportValue

Значение отчета

Свойства:

Название	Тип	Описание
Parameter	String	Идентификатор параметра
Timestamp	String	Идентификатор метки времени
Value	Object	Значение

WinccOaAlarm

Алармы из КАСКАД 3

Свойства:

Название	Тип	Описание
Time	DateTime	Метка времени
Tag	String	Тэг
Value	Double	Значение
Class	String	Класс аларма
Text	String	Сообщение
Direction	WinccOaAlarmDirection	Направление аларма
AcknowledgeState	WinccOaAlarmAcknowledgeState	Статус квитирования аларма
AcknowledgeTime	DateTime	Метка времени квитирования аларма

WinccOaAlarmsTable

Таблица отображения алармов КАСКАД 3

Свойства:

Название	Тип	Описание
Fields	WinccOaAlarmField[]	Отображаемые поля
Alarms	WinccOaAlarm[]	Алармы

WinccOaValue

Значение из КАСКАД 3

Свойства:

Название	Тип	Описание
Address	String	Адрес тега в КАСКАД 3
Value	Object	Значение
Timestamp	DateTime	Метка времени
Type	WinccOaType	Тип
RawStatus	String	Статус

WinccValue

Значение из WinCC Classic

Свойства:

Название	Тип	Описание
Address	String	Адрес тега в WinCC Classic
Value	Nullable<Double>	Значение
Timestamp	DateTime	Метка времени

XmlStandard

Стандарт Xml документа. Содержит строковое описание версии стандарта и кодировки. Например: '1.0' и 'windows-1251'

Свойства:

Название	Тип	Описание

XmlValue

Xml документ

Свойства:

Название	Тип	Описание

ReportCalculationHistory

История вычислений параметров отчета

Свойства:

Название	Тип	Описание
Value	Dictionary<String, Dictionary<String, Object>>	История вычислений параметров в виде словаря [Метка времени; [Идентификатор параметра; Значение]]
Values	Dictionary<String, Dictionary<DateTime, ReportValue>>	История вычислений параметров в виде словаря [Идентификатор параметра; [Метка времени; Значение отчета]]
Item	IDictionary<DateTime, Object>	История вычислений параметра в виде словаря [Метка времени; Значение]

OperationTimeDeviceInfo

Описание оборудования

Свойства:

Название	Тип	Описание
Id	Guid	Идентификатор
Name	String	Наименование оборудования
Order	Int32	Порядковый номер

OperationTimeDevicePeriodInfo

Период пребывания оборудования в определенном состоянии

Свойства:

Название	Тип	Описание
DeviceName	String	Название оборудования
Period	TimeInterval	Период пребывания оборудования в определенном состоянии

OperationTimeDeviceStateInfo

Информация по наработке оборудования

Свойства:

Название	Тип	Описание
StateName	String	Наименование состояния
DeviceName	String	Наименование оборудования
Days	Double	Время наработки (в днях)
EntriesNumber	Int32	Количетсво вхождений

OperationTimeParameterLog

Журнал истории состояний оборудования параметра наработки

Свойства:

Название	Тип	Описание
States	OperationTimeStateInfo[]	Состояния
Devices	OperationTimeDeviceInfo[]	Оборудования
Records	OperationTimeRecordInfo[]	История изменения состояния единиц оборудования
Interval	TimeInterval	Временной срез

OperationTimeRecordInfo

Запись об изменении состояния оборудования

Свойства:

Название	Тип	Описание
Id	Guid	Идентификатор
StateId	Guid	Идентификатор нового состояния оборудования
DeviceId	Guid	Идентификатор оборудования
CreatedTimeStamp	DateTime	Время создания записи
CreatedUserId	Guid	Идентификатор пользователя, добавившего запись
CreatedUserName	String	Имя пользователя, добавившего запись
TimeStamp	DateTime	Время смены состояния

OperationTimeStateInfo

Состояние оборудования

Свойства:

Название	Тип	Описание
Id	Guid	Идентификатор
Name	String	Наименование состояния
BackgroundColor	String	Цвет отображения состояния
LineType	OperationTimeParameterStateLineStyle	Тип отображения состояния

ReportHtmlTableCompiler

Таблица с заголовками и ячейками

Свойства:

Название	Тип	Описание

AggregationType

Тип агрегации

Свойства:

Название	Тип	Описание
Sum	AggregationType	Сумма
Avg	AggregationType	Среднее
Max	AggregationType	Максимальное
Min	AggregationType	Минимальное

PiramidaDiscretStatus

Статус дискретного канала из базы данных Piramida

Свойства:

Название	Тип	Описание
On	PiramidaDiscretStatus	Канал включен
Off	PiramidaDiscretStatus	Канал выключен

WinccOaAlarmAcknowledgeState

Статус квитирования аларма из КАСКАД 3

Свойства:

Название	Тип	Описание
Not	WinccOaAlarmAcknowledgeState	Не квитировано
Multiple	WinccOaAlarmAcknowledgeState	Квитированы все
Single	WinccOaAlarmAcknowledgeState	Квитировано одно

WinccOaAlarmDirection

Направление аларма из КАСКАД 3

Свойства:

Название	Тип	Описание
Went	WinccOaAlarmDirection	Ушло
Came	WinccOaAlarmDirection	Пришло
None	WinccOaAlarmDirection	Все

DisplayedType

Параметры обрабатываемые в Navigation

Свойства:

Название	Тип	Описание
Button	DisplayedType	Кнопка
Hyperlink	DisplayedType	Гиперссылка

PiramidaParameter

Параметры обрабатываемые в Piramida

Свойства:

Название	Тип	Описание
PowerInPrevious3Minutes	PiramidaParameter	Мощность за предыдущие 3 минуты
PowerInPrevious1Minute	PiramidaParameter	Мощность за предыдущую 1 минуту
PowerInPrevious2Minutes	PiramidaParameter	Мощность за предыдущие 2 минуты
PowerInPrevious4Minutes	PiramidaParameter	Мощность за предыдущие 4 минуты
PowerInPrevious5Minutes	PiramidaParameter	Мощность за предыдущие 5 минут
PowerInPrevious6Minutes	PiramidaParameter	Мощность за предыдущие 6 минут
PowerInPrevious10Minutes	PiramidaParameter	Мощность за предыдущие 10 минут
PowerInCurrent30Minutes	PiramidaParameter	Мощность за текущие 30 минут
PowerInPrevious15Minutes	PiramidaParameter	Мощность за предыдущие 15 минут
PowerInPrevious30Minutes	PiramidaParameter	Мощность за предыдущие 30 минут
IntEnergyInPrevious30MinutesWithTransfer	PiramidaParameter	Целочисленная энергия за предыдущие 30 минут
EnergyInCurrent30Minutes	PiramidaParameter	Энергия за текущие 30 минут
EnergyInPrevious30Minutes	PiramidaParameter	Энергия за предыдущие 30 минут
EnergyInCurrent1Hour	PiramidaParameter	Мощность за текущий час
PowerEnergyInPrevious1Hour	PiramidaParameter	Мощность/энергия за предыдущий час
IntEnergyInPrevious1Hour	PiramidaParameter	Энергия за предыдущий час
MaxPowerInCurrentDay	PiramidaParameter	Мощность за текущие сутки (максимальная)
MaxPowerInPreviousDay	PiramidaParameter	Мощность за предыдущие сутки (максимальная)
EnergyInCurrentDay	PiramidaParameter	Энергия за текущие сутки
EnergyInPreviousDay	PiramidaParameter	Энергия за предыдущие сутки
IntEnergyInPreviousDayWithTransfer	PiramidaParameter	Энергия за предыдущие сутки с учётом переноса