Сборка данных диаграммы

Диаграммы предоставляют несколько стандартных способов получения данных из унифицированной модели данных AggreGate Server и использования этих данных для построения набора данных диаграммы.

В текущем разделе рассматриваются свойства диаграммы, связанные с получением исходных данных и построением набора данных диаграммы.

Тип источника данных

Этот основной параметр определяет, какой тип данных должен использоваться для построения диаграммы. Может быть три варианта:

Type or paste something here to turn it into an excerpt.

Специальные данные поддерживаются всеми типами графиков. Типы источников данных " Переменная" и " Событие" доступны только в диаграммах, изначально предназначенных для данных временных рядов (например, линейная диаграмма).


Название Переменной:

sourceType

Записи:

1

Формат записи:

Поле

Тип поля

Описание поля

источник

Integer

Тип источника данных

Переменные источника

Текущее свойство определяет, какие данные используются для построения графика на основе переменных [Missing Цель]. Каждая строка в таблице исходных переменных определяет один или несколько рядов данных, которые будут показаны на графике. Таким образом, на одном графике могут отображаться изменения различных значений и даже значения, рассчитанные на основе данных различных переменных.

Название Переменной:

variableData

Записи:

1

Формат записи:

Поле Имя

Тип поля

Описание поля

имя

String

Название. Название серии данных, отображаемой на графике. Имя серии может быть выражением или просто строковой константой.

контекст

String

Контекст. Контекст сервера, определяющий местоположение переменной. Для графиков, расположенных в отнесенных друг к другу инструментальных панелях, это значение должно быть установлено в виде одной точки (.), чтобы указать, что переменная находится в контексте, для которого была открыта инструментальная панель.

переменная

String

Переменная. Переменная, из которой берутся данные.

выражение

String

Выражение расширенного поиска. Выражение расширенного поиска, используемое для вычисления значений данных. В большинстве случаев оно должно включать ссылки на значение переменной.

Переменная Серия Выражение расширенного поиска Окружение:

Контекст по умолчанию

Определяется серией Контекст.

Таблица данных по умолчанию

Значение переменной, указанное серией Переменная настройка.

Строка по умолчанию

0 (или динамический, если включено размножение серии [Missing Цель] )

Переменные окружения

Только стандартные переменные.

customTimestampExpression

String

Выражение временной метки. Необязательное Выражение расширенного поиска, используемое для вычисления временных меток для каждого образца данных. В большинстве случаев оно должно включать ссылку на ячейку значения исторической переменной, которая содержит дату/время, связанную с исторической выборкой данных. Если это выражение не указано, то временной меткой каждого значения исторической переменной будет дата/время, когда оно было сохранено в базе данных сервера.

Выражение временной метки Разрешение среды:

Контекст по умолчанию

Определяется серией Контекст.

Таблица данных по умолчанию

Значение переменной, указанное в настройках серии Переменная.

Строка по умолчанию

0 (или динамический, если включено размножение серии [Missing Цель] )

Переменные окружения

Только стандартные переменные.

распространять

Boolean

Размножать. Создать отдельную серию данных для каждой записи исходной переменной. Подробности см. в разделе [Распространение серии данных по отсутствующей цели].

агрегирование

Integer

Агрегация. Указывает, что делать, если для определенного диапазона времени существует несколько значений данных. Возможные варианты: вычислить среднее, взять минимальное или максимальное значение, вычислить сумму всех значений или взять первое/последнее значение за период.

типы

Integer

Тип. Тип серии данных [Отсутствующая цель].


События источника

Текущее свойство определяет, какие данные используются для построения графика на основе событий [Нет данных]. Каждая строка в таблице исходных событий определяет одну серию данных, которая будет отображаться на графике. Таким образом, на одном графике могут отображаться изменения разных значений и даже значения, рассчитанные на основе данных разных событий.


Название Переменной:

eventData

Записи:

1

Формат записи:

Поле Имя

Тип поля

Описание поля

имя

String

Название. Название серии данных, отображаемой на графике. Имя серии может быть выражением или просто строковой константой.

контекст

String

Контекст. Контекст сервера, определяющий событие, из которого будут взяты данные.

событие

String

Событие. Событие, из которого нужно взять данные.

выражение

String

Выражение расширенного поиска. Выражение, используемое для вычисления значений данных. В большинстве случаев оно должно включать ссылки на ячейки события Data Table.

Переменная Серия Выражение расширенного поиска Окружение:

Контекст по умолчанию

Определяется серией Контекст.

Таблица данных по умолчанию

Таблица данных события, указанного в настройке серии Событие.

Строка по умолчанию

0

Переменные окружения

Только стандартные переменные.

customTimestampExpression

String

Выражение временной метки. Необязательное Выражение расширенного поиска, используемое для вычисления временных меток для каждого образца данных. В большинстве случаев оно должно включать ссылку на ячейку таблицы Data Table события, содержащую дату/время, когда событие фактически произошло. Если это выражение не указано, то временной меткой каждого исторического события будет дата/время, когда оно было сохранено в базе данных сервера.

Выражение временной метки Разрешение среды:

Контекст по умолчанию

Определяется серией Контекст.

Таблица данных по умолчанию

Таблица данных события, указанного в настройках серии Событие.

Строка по умолчанию

0

Переменные окружения

Только стандартные переменные.

агрегация

Integer

Агрегация. Указывает, что делать, если для определенного диапазона времени существует несколько значений данных. Возможные варианты: вычислить среднее, взять минимальное или максимальное значение, вычислить сумму всех значений или взять первое/последнее значение за период.

Включить историю

Это свойство определяет, будет ли график на основе переменных [Пропущенная цель] и событий [Пропущенная цель] включать исторические данные, то есть события и изменения значений переменных, которые произошли до построения графика.

Оцените расход памяти, который может быть вызван загрузкой исторических данных в соответствии с опциями Ограничить диапазон времени и Диапазон времени. Загрузка огромного количества исторических данных может привести к сбою сервера или снижению производительности.


Название Переменной:

useHistoricalData

Записи:

1


Формат записи:

Поле

Тип поля

Описание поля

useHistoricalData

Boolean

Включить историю


Период времени для агрегации

Единица времени определяет разрешение для графиков [Пропущенная цель] на основе переменных и [Пропущено событие входа] на основе событий. На графике отображается только одно значение данных в единицу времени. Например, если единицей времени для графика событий является День и в течение определенного дня произошло несколько событий, на графике отображаются данные только одного события за этот день (самого позднего).

Диаграммы используют параметр Агрегация, определенный в разделе Исходные переменные / Исходные события, чтобы определить, как сгруппировать несколько исходных значений в одно значение набора данных для каждой единицы времени.

Единицы времени: Год, Квартал, Месяц, Неделя, День, Час, Минута и Секунда.

Название Переменной:

aggregateTimePeriod

Записи:

1

Формат записи:

Поле

Тип поля

Описание поля

aggregateTimePeriod

Integer

Единица времени


Ограничить диапазон времени

Свойство актуально для графиков [Пропущенная цель] на основе переменных и [Пропущено событие входа] на основе событий. Поддерживаются следующие значения:

  • Вся история. Будут загружены и отображены все исторические значения.

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

  • Временной интервал. Данные графика будут включать только те значения, которые были получены в пределах временного диапазона, указанного свойствами Дата начала и Дата окончания .

Заблокировав все временные диапазоны, сервер будет вынужден загрузить всю доступную историю событий/переменных из базы данных в память для подготовки набора данных графика. Текущий процесс может привести к очень высокому потреблению памяти и отказу сервера из-за снижения производительности!

Название Переменной:

limitTimeRange

Записи:

1


Формат записи:

Поле

Тип поля

Описание поля

limitTimeRange

String

Ограничить диапазон времени


Диапазон времени

Текущий параметр доступен только в том случае, если включена настройка Ограничить диапазон времени. Она задает максимальный возраст исторических данных, которые будут использоваться графиком.

Установка большого временного диапазона заставит сервер загрузить в память достаточную часть истории событий/переменных из базы данных для подготовки набора данных графика. Текущее значение может привести к очень большому потреблению памяти и отказу сервера из-за снижения производительности!

Название Переменной:

timeRange

Записи:

1

Формат записи:

Поле

Тип поля

Описание поля

диапазон времени

длинный

Диапазон времени

Начальная дата

Нижняя граница отображения диапазона исторических значений. Доступность, если для параметра Ограничить диапазон времени установлено значение Временной интервал.

Название Переменной:

startDate

Записи:

1

Формат записи:

Поле

Тип поля

Описание поля

startDate

Дата

Начальная дата


Имя свойства: startDate

Тип свойства: Дата

Конечная дата

Верхняя граница отображения диапазона исторических значений. Доступность, если для параметра Ограничить диапазон времени установлено значение Временной интервал.

Название Переменной:

endDate

Записи:

1

Формат записи:

Поле

Тип поля

Описание поля

endDate

Дата

Конечная дата

Исходные данные

Таблица исходных данных, используемая для построения диаграмм [Отсутствующая цель] на основе пользовательских данных.

Название Переменной:

sourceData

Записи:

1


Формат записи: динамический

Привязки исходных данных

Набор выражений, используемых для получения данных из записей Исходных данных и построения результирующего набора данных диаграммы. Текущее свойство также действительно только для диаграмм, основанных на пользовательских данных [Missing Цель].

Название Переменной:

dataBindings

Записи:

1

Формат записи: отличается для разных диаграмм

Автоматически подгружать данные

Когда установлено значение True, график будет перерисовываться при изменении любого параметра в группе данных. Если установить значение False, график будет перерисовываться только при вызове функции updateDataset() в контексте графика.

Название Переменной:

autoLoadDataset

Записи:

1


Формат записи:

Поле

Тип поля

Описание поля

autoLoadDataset

Boolean

Автоматически подгружать данные