EDA_GetVectorVersionChangesRec

EDA_GetVectorVersionChangesRec

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.