Funkcia vráti zoznam časov, kedy nastali zmeny alebo kompletné informácie o zmenách v danej verzii vektora. Výsledok sa zapisuje do stĺpca typu
Absolútny čas alebo do šesťstĺpcovej štruktúry nasledovného formátu:
entryTime |
Absolútny čas |
Historický čas, ktorý bol použitý pri modifikovaní vektora (tento údaj je vrátený pri požiadavke len na časy zmien vo verzii). |
changeTime |
Absolútny čas |
Skutočný čas, kedy nastala zmena. |
changeBt |
Absolútny čas |
Počiatočný čas modifikovaného intervalu dát (neplatná hodnota v prípade
úpravy predpisu). |
changeEt |
Absolútny čas |
Koncový čas modifikovaného intervalu dát (neplatná hodnota v prípade
úpravy predpisu). |
changeType |
Celé číslo |
Bitový súčet typov zmien, ktoré nastali v danom historickom čase. |
userName |
Text |
Meno užívateľa, ktorý vykonal zmenu. |
V prípade zadávaných vektorov, funkcia za zmeny vektora považuje zmeny v dátach vektora (zápis, mazanie) a v prípade vypočítaných vektorov zmeny v predpise vektora.
V prípade, že sú u vypočítaného vektora požadované zmeny vo výsledných dátach vektora, je možné použiť režim závislostí (voliteľný parameter
onlySrcDeps),
kedy sú vyhodnocované zmeny v dátach zdrojových vektorov.
Zmeny sa zisťujú len na statických (v predpise zadaných kódom vektora) závislostiach.
Režim závislostí sa automaticky použije pri vypočítanom vektore, ktorý nemá zadanú verziu. Správanie funkcie na základe vstupu znázorňuje nasledovná tabuľka.
Typ vektora |
Požadovaná verzia existuje |
onlySrcDeps |
Výstup |
zadávaný |
áno |
@FALSE |
Zmeny v dátach daného vektora. |
zadávaný |
áno |
@TRUE |
Zmeny v dátach daného vektora. |
zadávaný |
nie |
@FALSE |
Chyba ERR_VERSION_DOESNT_EXIST. |
zadávaný |
nie |
@TRUE |
Chyba ERR_VERSION_DOESNT_EXIST. |
vypočítaný |
áno |
@FALSE |
Zmeny v predpise daného vektora. |
vypočítaný |
áno |
@TRUE |
Zmeny v dátach zdrojových vektorov daného vektora. |
vypočítaný |
nie |
@FALSE |
Zmeny v dátach zdrojových vektorov daného vektora. |
vypočítaný |
nie |
@TRUE |
Zmeny v dátach zdrojových vektorov daného vektora. |
Deklarácia
%EDA_GetVectorVersionChangesRec(
INT/TEXT in _vector,
INT/TEXT in _version,
REC in _params,
REC out _changeTimes,
INT in _col,
INT out _errorCode
);
Parametre
|
Parameter
|
Dátový
typ |
Typ |
Popis |
1 |
vector |
INT/TEXT |
IN |
ID / kód vektora. |
2 |
version |
INT/TEXT |
IN |
ID / kód verzie. |
3 |
params |
REC |
IN |
Štruktúra voliteľných parametrov. |
4 |
changes |
REC |
OUT |
Štruktúra časov alebo informácií o zmene. |
5 |
col |
INT |
IN |
Číslo stĺpca vo výstupnej štruktúre, do ktorého sa majú zapísať časy zmien alebo 0 - budú vrátené kompletné informácie o zmenách. |
6 |
errorCode |
INT |
OUT |
Návratový kód. |
Obsah štruktúry voliteľných parametrov verzie 1:
|
Parameter |
Dátový typ |
Prednastavená hodnota |
Popis |
1 |
structVersion |
INT |
|
Verzia štruktúry - 1. |
2 |
maxValues |
INT |
0 (neobmedzene) |
Maximálny počet vrátených zmien (počíta sa od poslednej zmeny). |
3 |
maxLevel |
INT |
0 (neobmedzene) |
Obmedzenie na počet vnorení v prípade režimu závislostí. |
4 |
onlySrcDeps |
BOOL |
FALSE |
Vynúti použitie režimu závislostí. |
5 |
includePrecalcChanges |
BOOL |
FALSE |
Pri vypočítaných vektoroch zohľadní aj zmeny v predpočtoch. V prípade použitia režimu závislostí je parameter ignorovaný. |
6 |
bt |
TIME |
MIN_DATE |
Dolná hranica intervalu, z ktorého je požadovaný zoznam zmien |
7 |
et |
TIME |
MAX_DATE |
Horná hranica intervalu, z ktorého je požadovaný zoznam zmien. |
Pridať komentár