Efektívnejší prístup k archívnym hodnotám zo systému D2000 umožňuje funkcia D2_ArchArr.
D2_ArchArr
(archObjName, bt, et, step, attribute, bDirectionByRow, refresh) |
archObjName | typ TEXT |
|
bt | typ ABS. ČAS | Počiatočný čas archívneho bloku. |
et | typ ABS. ČAS | Koncový čas archívneho bloku. |
step | typ INT | Časový krok [s] v rámci archívneho bloku. |
attribute | typ TEXT | Požadovaný atribút archívnej hodnoty. |
bDirectionByRow | typ BOOL |
Časové usporiadanie buniek v matici. |
refresh | Nepovinný parameter. |
Týmto sme založili maticu z vyznačených buniek. Výraz vo všetkých bunkách bude rovnaký.
Funkcia vráti pole požadovaných atribútov archivovaných hodnôt (parameter attribut – význam pozri funkciu D2_GetValue) daného archívneho objektu archObjName. Parametre bt, et určujú časový interval archívneho bloku a parameter step definuje prevzorkovanie hodnôt v archíve. Parameter bDirectionByRow určuje časové usporiadanie buniek v matici. Má význam len pri maticiach, ktoré majú viac riadkov a zároveň viac stĺpcov. Pri hodnote TRUE (PRAVDA) sú hodnoty (usporiadané podľa času vzostupne) vkladané do buniek po riadkoch. V opačnom prípade sú hodnoty do buniek vkladané po stĺpcoch.
Parameter refresh má zhodnú úlohu, ako pri funkcii D2_GetValue.
Čas hodnoty z archívu je určený vzájomnou polohou bunky, ktorá obsahuje volanie funkcie a maticou, v ktorej sa nachádza.
budú časy jednotlivých hodnôt v bunkách v závislosti od rozsahu matice a parametra bDirectionByRow nasledovné:
Pre hodnoty, ktoré sú mimo žiadaný interval je návratová hodnota funkcie chyba: #Value (#Hodnota), alebo hodnota bunky s menom SUPP_NO_ARCH_DATA, ak existuje (pozri Preddefinované bunky).