Akcia GETARCHSTRUCT

Funkcia

Hromadné čítanie hodnôt z archívu.

Deklarácia

Parametre

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:

1. 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).
   
   

2. 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.
   
   

3. 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 ERR_NO_ASSIGNED_ALIAS.

4. Š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

Akcie GETARCH* - príklad