ExportDataToCsv

<< Click to Display Table of Contents >>

Navigation:  Проект в MasterSCADA 4D > Дерево библиотек > Библиотека BaseObjects > BaseObjects.ФБ.Системные > Архивы >

ExportDataToCsv

Функциональный блок ExportDataToCsv формирует файл csv, содержащий таблицу со значениями указанных параметров: первый столбец - время, следующие - значения параметров (заголовки столбцов по полным именам параметров).

Важно! ExportDataToCsv является асинхронным ФБ. С особенностями работы с асинхронными ФБ можно ознакомиться в соответствующем топике.

Вид в дереве

Вид в редакторе FBD

ExportDataToCsv_1

ExportDataToCsv_2

Входы и выходы ФБ:

Название

Тип

Назначение

Входы

Run

BOOL

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

OutPath

STRING

Полный путь с именем файла и расширением.

Elements

ARRAY of STRING

Массив строк с полными именами параметров. Формируется файл с архивными значениями этих параметров за заданный период.

GenerateByPeriod

BOOL

Способ формирования файла с архивными данными: по изменению, периодически. FALSE - по изменению (по умолчанию), TRUE - периодически.

По умолчанию значение настройки FALSE.

UseValueFromPreviousInterval

BOOL

Соответствует настройке обработки данных в отчете Использовать значение с предыдущего интервала. TRUE - если значение на левой границе интервала или внутри интервала отсутствует, то будет выбрано значение, ближайшее слева от левой границы FALSE - будет выбрано только значение на левой границе или внутри интервала.

Aggregate

AggregateType

Задается тип выборки. Используется только при периодическом формировании.

Filter

ArchiveFilter

Фильтр для обработки значений с недостоверными признаками качества. При помощи фильтра можно определить, будут ли игнорироваться данные с признаками качества Bad и Uncertain при выборке. Если же данные с недостоверными признаками качества будут учитываться, то можно задать, какой признак качества им будет выставляться. Данный вход имеет структурный тип данных с 4 полями:

IgnoreBadValues - указывает, будут ли значения с признаком качества Bad учитываться при выборке. Если установлен в TRUE, данные с таким признаком качества будут исключены из выборке, в то время как при установке в FALSE (по умолчанию) они будут учтены в выборке.

StatusForBadValues - это поле, которое определяет, какой признак качества присваивается агрегированным значениям с статусом Bad. По умолчанию это значение установлено как Uncertain.

IgnoreUncertainValues - указывает, будут ли значения с признаком качества Uncertain учитываться при выборке. Если установлен в TRUE, данные с таким признаком качества будут исключены из выборке, в то время как при установке в FALSE (по умолчанию) они будут учтены в выборке.

StatusForUncertainValues - это поле, которое определяет, какой признак качества присваивается агрегированным значениям с статусом Uncertain. По умолчанию это значение установлено как Uncertain.

StartTime

DT

Дата и время начала выборки.

EndTime

DT

Дата и время конца выборки.

Interval

TIME

Интервал, используемый для агрегатных функций при периодическом формировании файла. Если установлен 0, то идет обработка за весь интервал выборки.

Выходы

Completed

BOOL

Информирует об окончании формирования файла. Принимает значение FALSE после того, как Run становится TRUE.

Running

BOOL

Информирует о процессе формирования файла. Является TRUE на время сохранения файла.

Error

STRING

Сообщение об ошибке при неуспешном формировании файла.

Рекомендации по работе с ФБ

Формирование файла значений по аналогии с отчетами:

По изменению: таблицы по изменению формируется с настройкой обработки данных- Последнее значение. Атрибут данных - значение. "Использовать значение с предыдущего интервала" принимает значение Да или Нет.Все колонки считать "ведущими".

Периодически: таблицы по периоду строятся по настройкам: Обработка (Aggregate), Атрибут данных - значение, "Использовать значение с предыдущего интервала" принимает значение да или нет.

Смотрите также: