Funkcia %LoadArchive

Popis

Funkcia načíta dáta z archívneho objektu z daného intervalu a voliteľne dáta prevzorkuje. V prípade štruktúrovaného archívu je potrebné zadať riadok a stĺpec v štruktúre. Pre neštruktúrovaný archív treba zadať nuly.
Časové značky hodnôt z archívu sú zarovnané na sekundovú presnosť orezaním desatinnej časti a v prípade, že v jednej sekunde je viacero zaarchivovaných hodnôt, je vrátená posledná z nich.
Ak daný archívny objekt (alebo daný riadok a stĺpec v ňom) neexistuje, je generovaná výnimka ERR_NOT_ARCHIVED.
Ak archívny proces, ktorý spracováva daný archívny objekt nebeží, je generovaná výnimka ERR_ARCHIVE_ERROR.

Deklarácia


VECTOR %LoadArchive(
	TEXT		_archive,
	INT			_row,
	INT			_column,
	TIME		_bt,
	TIME		_et
	[, [INT|TEXT	_period := 0]
	[, [INT|TEXT	_timeZone]]]
)


Parametre


_archiveMeno archívneho objektu.
_rowČíslo riadku štruktúrovaného archívneho objektu. 0 pre neštruktúrovaný.
_columnČíslo stĺpca štruktúrovaného archívneho objektu. 0 pre neštruktúrovaný.
_btZačiatok časového intervalu.
_et

Koniec časového intervalu.

_period

Perióda na prekrokovanie. Je možné použiť jeden z preddefinovaných krokov, kód alebo id užívateľsky alebo lokálne definovanej periódy.

Predvolene načíta dáta neprekrokované. 

_timeZone

Identifikátor časového pásma. Použiteľné len v kombinácii s preddefinovanými krokmi.

Predvolene použije rovnaké časové pásmo ako nadradený vypočítaný vektor.


Príklad


-- Príklad predpisu vypočítaného hodinového vektora,
-- ktorý načítava priebeh teploty v hodinových priemeroch
-- z neštruktúrovaného archívu H.Temperature.

VECTOR _v;
_v := %LoadArchive("H.Temperature", 0, 0, _BT, _ET, _STEP);
RETURN _v;


-- Príklad predpisu vypočítaného zmenového vektora,
-- ktorý načítava priebeh alokovanej pamäte (stĺpec 13)
-- procesu na riadku 2 zo štruktúrovaného archívu H._System_Proces.

VECTOR _v;
_v := %LoadArchive("H._System_Proces", 2, 13, _BT, _ET);
RETURN _v;


Chybové kódy