- Vytvoril D2000 Dev Team na okt 12, 2017
Akcia GETARCHVAL
Funkcia
Čítanie hodnoty archívneho objektu v danom čase.
Deklarácia
GETARCHVAL valueIdent_Real, archIdent, timeExpression_TmA [STATUS [isDataIdent_Bool], [archFlagsIdent_Int], [archivInstance_Int]]
Parametre
| valueIdent_Real | out | Odkaz na jednu archívnu hodnotu,
odkaz na objekt alebo
odkaz na položku objektu typu Štruktúrovaná premenná (poznámka: hodnoty
objektu alebo položky sa musia archivovať). Upozornenie: Ak sa parameter odkazuje na objekt, ktorý je viacnásobne archivovaný, nie je určené, hodnoty ktorého archívneho objektu sa použijú pre akciu. |
| archIdent | in | Odkaz na jednu archívnu hodnotu, odkaz na objekt alebo odkaz na položku objektu typu Štruktúrovaná premenná. |
| timeExpression_TmA | in | Výraz typu Absolútny čas. |
| isDataIdent_Bool | out | Identifikátor typu Bool - príznak úspešnosti čítania z archívu, nepovinný parameter. |
| archFlagsIdent_Int | out | Identifikátor typu Int - archívne príznaky, nepovinný parameter. |
| archivInstance_Int | in | Nepovinný identifikátor typu Int - identifikácia inštancie archívu. Ak nie je uvedený, nahradí sa hodnotou 0. |
Popis
Akcia prečíta hodnotu z archívu pre daný čas. Výsledok čítania (hodnotu) zapíše do premennej valueIdent_Real.
Prečítaná hodnota zodpovedá čítaniu časového intervalu, ktorý má čas
začiatku a konca rovnaký a časový krok je 0.
Ak parameter archIdent obsahuje odkaz na objekt typu Archivovaná hodnota, činnosť akcie je popísaná vyššie. Ak obsahuje odkaz na objekt, ktorý nie je archívny alebo položku štruktúrovanej premennej, ktorá nie je typu Objekt, systém sa snaží nájsť archívny objekt (objekt typu Archivovaná hodnota), ktorý danú hodnotu archivuje.
Ak je parameter archIdent odkaz na položku štruktúrovanej premennej typu Objekt, táto ukazuje na určitý objekt v systéme. Ak je tento objekt archívny, dáta budú načítané z neho. Ak nie je, systém sa snaží nájsť archívny objekt, ktorý danú hodnotu archivuje.
Ak je uvedený identifikátor isDataIdent_Bool, zapíše do neho hodnotu:
Ak parameter archIdent obsahuje odkaz na objekt typu Archivovaná hodnota, činnosť akcie je popísaná vyššie. Ak obsahuje odkaz na objekt, ktorý nie je archívny alebo položku štruktúrovanej premennej, ktorá nie je typu Objekt, systém sa snaží nájsť archívny objekt (objekt typu Archivovaná hodnota), ktorý danú hodnotu archivuje.
Ak je parameter archIdent odkaz na položku štruktúrovanej premennej typu Objekt, táto ukazuje na určitý objekt v systéme. Ak je tento objekt archívny, dáta budú načítané z neho. Ak nie je, systém sa snaží nájsť archívny objekt, ktorý danú hodnotu archivuje.
Ak je uvedený identifikátor isDataIdent_Bool, zapíše do neho hodnotu:
- True - ak sú dáta prečítané,
- False - ak dáta nie sú.
Ak identifikátor isDataIdent_Bool nie je použitý a ak nie sú dáta, akcia nemodifikuje hodnotu identifikátora
valueIdent_Real.
Ak je uvedený identifikátor archFlagsIdent_Int, sú do neho zapísané archívne príznaky pre prečítanú hodnotu (archívny
príznak vzniká súčtom nasledujúcich konštánt):
- 1 (ArcStart) - hodnota zapísaná do archívnej databázy v okamihu štartu procesu D2000 Archiv.
- 2 (ArcStop) - hodnota zapísaná do archívnej databázy v okamihu zastavenia procesu D2000 Archiv
- 4 (ArcBlock) - hodnota zapísaná do archívnej databázy v okamihu blokovania archivácie (prostredníctvom podmienky prerušenia archivácie)
- 8 (ArcUnBlock) - hodnota zapísaná do archívnej databázy v okamihu odblokovania archivácie (prostredníctvom podmienky štartu archivácie)
- 16 (ArcDeleted) - užívateľom zrušená hodnota z archívnej databázy. Zmazanú hodnotu akcia ignoruje (ako keby v archíve nebola)
- 32 (ArcUsermodify) - užívateľom modifikovaná hodnota v archívnej databáze
- 64 (ArcOldVal) - stará hodnota vyčítaná z komunikačnej stanice
- 128 (ArcProcessModify) - hodnota modifikovaná procesom (nie užívateľom: skript ESL, D2000 VBApi, ...)
- 256 (ArcLoadData) - zastarané: hodnota bola získaná z OS/2 databázy SQL Gupta On-line importom archívnej databázy
- 512 (ArcMonoTime) - hodnota je uložená s monotónnym časom
- 1024 (ArcK) - hodnota periodického archívu vygenerovaná pri čítaní ako kópia predchádzajúcej
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.
Poznámka
- Ak nie je spustený príslušný proces archivácie, akcia generuje chybu _ERR_ARCHIV_NOT_RUNNING.
- Ak je Archívny objekt archivovaný:
- periodicky, čítanie hodnoty mimo periódy dopadne vždy neúspešne
- na filter, hodnota pre žiadaný čas bude odvodená z poslednej zapísanej hodnoty v archíve.
Príklad
Čítanie archivovanej hodnoty:
REAL _value TIME _bt BOOL _bIsArchData ; vypočítanie začiatku aktuálnej minúty _bt := SysTime _bt := _bt - %ModTime(_bt, 60) ; prečítanie hodnoty a aktívnej inštancie archívu GETARCHVAL _value, H.Sec, _bt STATUS _bIsArchData,,0 ; bola hodnota prečítaná? IF _bIsArchData THEN ; spracovanie prečítanej hodnoty ENDIF
Súvisiace stránky:
0 komentárov