Porovnávané verzie
porovnané s
Kľúč
- Tento riadok sa pridal
- Riadok je odstránený.
- Formátovanie sa zmenilo.
Akcia GETARCHSTRUCT
Funkcia
Hromadné čítanie hodnôt z archívu.
Deklarácia
| Blok kódu | ||||
|---|---|---|---|---|
| ||||
GETARCHSTRUCT archIdent, locRecDstIdent, timeIdent_TmA, statusIdent_Int [,archivInstance_Int] |
Parametre
| archIdent | in | Odkaz na:
|
| locRecDstIDent | out | Lokálna premenná typu Record - výsledok čítania. |
| timeIdent_TmA | in | Identifikátor typu Absolútny čas. |
| statusIdent_Int | out | Úspešnosť čítania. |
| archivInstance_Int | in | Nepovinný identifikátor typu Int - identifikácia inštancie archívu. Ak nie je uvedený, nahradí sa hodnotou 0. |
Popis
Parameter archIdent reprezentuje štruktúru, alebo štruktúrovaný archívny objekt. Akcia generuje pre každú položku požiadavku na čítanie jej historickej hodnoty v danom čase (parameter timeIdent_TmA). Výsledok čítania každej položky je uložený do zodpovedajúcej položky výslednej lokálnej premennej _locRecDstIdent. Akcia jej pri vykonávaní podľa potreby zmení rozmer. Typ definície štruktúry pre archIdent aj pre _locRecDstIdent musí byť rovnaký.
Parameter archIdent môže byť zapísaný jedným z nasledujúcich spôsobov:
Parameter archIdent môže byť zapísaný jedným z nasledujúcich spôsobov:
- Lokálna premenná typu „typový ALIAS“
Príklad:
ALIAS (definícia štruktúry) _lAT
SET _lAT AS SV.Struct
GETARCHSTRUCT _lAT, ...
Jednotlivé požiadavky na čítanie budú VŽDY adresované na položky štruktúry SV.Struct (aj v prípade, že položky sú typu Objekt). - Objekt typu Štruktúrovaná premenná
Príklad:
GETARCHSTRUCT SV.Struct, ...
Adresovanie požiadavky prebieha podľa tých istých pravidiel ako v bode 1. - Lokálna premenná typu Record
Príklad:
RECORD (definícia štruktúry) _lRec
REDIM _lRec[1]
SET _lRec[1]^Item1 AS Sec
SET _lRec[1]^Item2 AS SysTime
SET _lRec[1]^Item3 AS M.MeranyBod
.....
GETARCHSTRUCT _lRec, ...
Akcia vyžaduje, aby všetky stĺpce boli typu Objekt. Jednotlivé požiadavky na čítanie budú adresované na objekty, na ktoré smerujú položky.
Ak niektoré políčko nebude smerované na objekt, akcia končí s chybou chybou ERR_NO_ASSIGNED_ALIAS.
Ak niektorá položka štruktúrovanej premennej nie je archivovaná, akcia končí s chybou _ERR_OBJECT_IS_NOT_IN_ARCHIVE. - Štruktúrovaný archívny objekt
- Príklad:
GETARCHSTRUCT H.Struct, ...
Jednotlivé požiadavky na čítanie budú adresované postupne na všetky položky. Objekt H.Struct nemôže byť jedno-stĺpcový archívny objekt.
Hodnota parametra archivInstance_Int udáva inštanciu archívu, ktorá realizuje požiadavku. Ak nie je uvedený (alebo má hodnotu 0) požiadavku realizuje aktívna inštancia archívu.
Príklad
| Info | ||
|---|---|---|
| ||