Сборка данных диаграммы
Диаграммы предоставляют несколько стандартных способов получения данных из единой модели данных AggreGate Server и использования этих данных для построения набора данных диаграммы.
В текущем разделе рассматриваются свойства диаграммы, связанные с получением исходных данных и построением набора данных диаграммы.
Тип источника данных
Этот основной параметр определяет, какой тип данных должен использоваться для построения диаграммы. Может быть три варианта:
Переменная. Использование данных из истории изменений переменных и изменений переменных в реальном времени для построения и динамического обновления графика.
Событие. Использование данных из истории событий и новых событий для построения и динамического обновления графика.
Специальные данные. Использование пользовательских табличных данных для построения графика.
Специальные данные поддерживаются всеми типами графиков. Типы источников данных Переменная и Событие доступны только в диаграммах, изначально предназначенных для данных временных рядов (например, линейная диаграмма).
Название Переменной: | sourceType |
Записи: | 1 |
Формат записи:
Поле | Тип поля | Описание поля |
источник | Integer | Тип источника данных |
Переменные
Текущее свойство определяет, какие данные используются для построения графика на основе переменных. Каждая строка в таблице исходных переменных определяет один или несколько рядов данных, которые будут показаны на графике. Таким образом, на одном графике могут отображаться изменения различных значений и даже значения, рассчитанные на основе данных различных переменных.
Название Переменной: | variableData |
Записи: | 1 |
Формат записи:
Поле | Тип поля | Описание поля | |
name | String | Название. Название серии данных, отображаемой на графике. Имя серии может быть выражением или просто строковой константой. | |
context | String | Контекст. Контекст сервера, определяющий местоположение переменной. Для графиков, расположенных в отнесенных друг к другу инструментальных панелях, это значение должно быть установлено в виде одной точки ( | |
variable | String | Переменная. Переменная, из которой берутся данные. | |
expression | String | Выражение расширенного поиска. Выражение расширенного поиска, используемое для вычисления значений данных. В большинстве случаев оно должно включать ссылки на значение переменной. | |
Переменная Серия Выражение расширенного поиска Окружение: | |||
|---|---|---|---|
Определяется серией Контекст. | |||
Значение переменной, указанное серией Переменная настройка. | |||
0 (или динамический, если включено размножение серии) | |||
Только стандартные переменные. | |||
customTimestampExpression | String | Выражение временной метки. Необязательное Выражение расширенного поиска, используемое для вычисления временных меток для каждого образца данных. В большинстве случаев оно должно включать ссылку на ячейку значения исторической переменной, которая содержит дату/время, связанную с исторической выборкой данных. Если это выражение не указано, то временной меткой каждого значения исторической переменной будет дата/время, когда оно было сохранено в базе данных сервера. | |
Выражение временной метки Разрешение среды: | |||
Определяется серией Контекст. | |||
Значение переменной, указанное в настройках серии Переменная. | |||
0 (или динамический, если включено Размножение серии) | |||
Только стандартные переменные. | |||
propagate | Boolean | Размножать. Создать отдельную серию данных для каждой записи исходной переменной. Подробности см. в разделе Размножение серии. | |
aggregation | Integer | Агрегация. Указывает, что делать, если для определенного диапазона времени существует несколько значений данных. Возможные варианты: вычислить среднее, взять минимальное или максимальное значение, вычислить сумму всех значений или взять первое/последнее значение за период. | |
types | Integer | Тип. Тип серии данных. | |
События
Текущее свойство определяет, какие данные используются для построения графика на основе событий. Каждая строка в таблице исходных событий определяет одну серию данных, которая будет отображаться на графике. Таким образом, на одном графике могут отображаться изменения разных значений и даже значения, рассчитанные на основе данных разных событий.
Название Переменной: | eventData |
Записи: | 1 |
Формат записи:
Поле | Тип поля | Описание поля | |
name | String | Название. Название серии данных, отображаемой на графике. Имя серии может быть выражением или просто строковой константой. | |
context | String | Контекст. Контекст сервера, определяющий событие, из которого будут взяты данные. | |
event | String | Событие. Событие, из которого нужно взять данные. | |
expression | String | Выражение расширенного поиска. Выражение, используемое для вычисления значений данных. В большинстве случаев оно должно включать ссылки на ячейки события Data Table. | |
Переменная Серия Выражение расширенного поиска Окружение: | |||
|---|---|---|---|
Определяется серией Контекст. | |||
Таблица данных события, указанного в настройке серии Событие. | |||
0 | |||
Только стандартные переменные. | |||
customTimestampExpression | String | Выражение временной метки. Необязательное Выражение расширенного поиска, используемое для вычисления временных меток для каждого образца данных. В большинстве случаев оно должно включать ссылку на ячейку таблицы Data Table события, содержащую дату/время, когда событие фактически произошло. Если это выражение не указано, то временной меткой каждого исторического события будет дата/время, когда оно было сохранено в базе данных сервера. | |
Выражение временной метки Разрешение среды: | |||
Определяется серией Контекст. | |||
Таблица данных события, указанного в настройках серии Событие. | |||
0 | |||
Только стандартные переменные. | |||
aggregation | Integer | Агрегация. Указывает, что делать, если для определенного диапазона времени существует несколько значений данных. Возможные варианты: вычислить среднее, взять минимальное или максимальное значение, вычислить сумму всех значений или взять первое/последнее значение за период. | |
Включить историю
Это свойство определяет, будет ли график на основе переменных и событий включать исторические данные, то есть события и изменения значений переменных, которые произошли до построения графика. Если включено, диаграмма будет загружать исторические данные в соответствии с выбранной опцией Ограничить диапазон времени (полная история, последние значения или диапазон дат).
 | Оцените расход памяти, который может быть вызван загрузкой исторических данных в соответствии с опциями Ограничить диапазон времени и Диапазон времени. Загрузка огромного количества исторических данных может привести к сбою сервера или снижению производительности. |
Название Переменной: | useHistoricalData |
Записи: | 1 |
Формат записи:
Поле | Тип поля | Описание поля |
useHistoricalData | Boolean | Включить историю |
Включить текущие данные
Это свойство определяет, будет ли график на основе переменных и событий динамически обновляться данными в реальном времени. Если включено, диаграмма будет обновляться в соответствии с выбранной опцией Ограничить диапазон времени (только Вся история или Последние значения). Опция Диапазон дат для Ограничить диапазон времени не поддерживается для обновлений в реальном времени.
Название Переменной: | useRealTimeData |
Записи: | 1 |
Формат записи:
Поле | Тип поля | Описание поля |
useRealTimeData | Boolean | Include Real-time Data |
Период времени для агрегации
Единица времени определяет разрешение для графиков на основе переменных и событий. На графике отображается только одно значение данных в единицу времени. Например, если единицей времени для графика событий является День и в течение определенного дня произошло несколько событий, на графике отображаются данные только одного события за этот день (самого позднего).
Диаграммы используют параметр Агрегация, определенный в разделе Исходные переменные / Исходные события, чтобы определить, как сгруппировать несколько исходных значений в одно значение набора данных для каждой единицы времени.
Единицы времени: Год, Квартал, Месяц, Неделя, День, Час, Минута и Секунда.
Название Переменной: | aggregateTimePeriod |
Записи: | 1 |
Формат записи:
Поле | Тип поля | Описание поля |
aggregateTimePeriod | Integer | Единица времени |
Ограничить диапазон времени
Свойство актуально для графиков на основе переменных и событий. Поддерживаются следующие значения:
Вся история. Будут загружены и отображены все исторические значения.
Последние значения. Данные графика будут включать только те события и изменения значений переменных, которые произошли только в течение определенного времени до построения графика, как указано в свойстве Диапазон времени.
Диапазон дат. Данные графика будут включать только те значения, которые были получены в пределах временного диапазона, указанного свойствами Дата начала и Дата окончания.
 | Заблокировав все временные диапазоны, сервер будет вынужден загрузить всю доступную историю событий/переменных из базы данных в память для подготовки набора данных графика. Текущий процесс может привести к очень высокому потреблению памяти и отказу сервера из-за снижения производительности! |
Название Переменной: | limitTimeRange |
Записи: | 1 |
Формат записи:
Поле | Тип поля | Описание поля |
limitTimeRange | String | Ограничить диапазон времени |
Диапазон времени
Текущий параметр доступен только в том случае, если включена настройка Ограничить диапазон времени. Она задает максимальный возраст исторических данных, которые будут использоваться графиком.
| Установка большого временного диапазона заставит сервер загрузить в память достаточную часть истории событий/переменных из базы данных для подготовки набора данных графика. Текущее значение может привести к очень большому потреблению памяти и отказу сервера из-за снижения производительности! |
Название Переменной: | timeRange |
Записи: | 1 |
Формат записи:
Поле | Тип поля | Описание поля |
диапазон времени | длинный | Диапазон времени |
Начальная дата
Нижняя граница отображения диапазона исторических значений. Доступность, если для параметра Ограничить диапазон времени установлено значение Временной интервал.
Название Переменной: | startDate |
Записи: | 1 |
Формат записи:
Поле | Тип поля | Описание поля |
startDate | Дата | Начальная дата |
Имя свойства: startDate
Тип свойства: Дата
Конечная дата
Верхняя граница отображения диапазона исторических значений. Доступность, если для параметра Ограничить диапазон времени установлено значение Временной интервал.
Название Переменной: | endDate |
Записи: | 1 |
Формат записи:
Поле | Тип поля | Описание поля |
endDate | Дата | Конечная дата |
Исходные данные
Таблица исходных данных, используемая для построения диаграмм на основе исходных данных.
Название Переменной: | sourceData |
Записи: | 1 |
Формат записи: динамический
Привязки исходных данных
Набор выражений, используемых для получения данных из записей Исходных данных и построения результирующего набора данных диаграммы. Текущее свойство также действительно только для диаграмм на основе исходных данных.
Название Переменной: | dataBindings |
Записи: | 1 |
Формат записи: отличается для разных диаграмм
Автоматически подгружать данные
Когда установлено значение True, график будет перерисовываться при изменении любого параметра в группе данных. Если установить значение False, график будет перерисовываться только при вызове функции updateDataset() в контексте графика.
Название Переменной: | autoLoadDataset |
Записи: | 1 |
Формат записи:
Поле | Тип поля | Описание поля |
autoLoadDataset | Boolean | Автоматически подгружать данные |
Was this page helpful?