Akcia GETARCHSTRUCT


Funkcia
Hromadné čítanie hodnôt z archívu.
Deklarácia
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:
  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.



Súvisiace stránky:

0 komentárov

Nie ste prihlásený. Akékoľvek zmeny, ktoré vykonáte, sa označia ako anonymné. Ak už máte svoj účet, pravdepodobne sa budete chcieť prihlásiť .