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

_archive	Meno 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ý.
_bt	Zač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;

Súvisiace stránky:

Chybové kódy