EDA_InsertValuesToVektorRec
Uloženie hodnôt do vektora. V prípade, že hodnota v danom čase existuje, hodnota sa prepíše.
Funkcia kombinuje všetky EDA_InsertValuesToVektor* procedúry zabalením parametrov do jednoriadkovej štruktúry.
V prípade zápisu do verziovaných vektorov sú zmeneným dátam automaticky pridelené časové značky s aktuálnym časom. V prípade potreby je možné časovú značku zadať explicitne - nastavením parametra forceVersionTime na @TRUE a nastavením atribútu parametra version (version\TIM) na požadovaný čas. Existujúce dáta s rovnakou časovou značkou ako nové dáta budú prepísané.
Deklarácia
%EDA_InsertValuesToVektorRec(
INT/TEXT in _vector,
REC in _values,
REC in _params,
INT out _errorCode
);Parametre
| Parameter | Dátový typ | Typ | Popis |
|---|---|---|---|---|
1 | vector | INT/TEXT | IN | ID / kód vektora. |
2 | values | REC | IN | Hodnoty - jednostĺpcová štruktúra REALov s časovou značkou podľa typu vektora. |
3 | params | REC | IN | Štruktúra voliteľných parametrov. |
4 | errorCode | INT | OUT | Návratová hodnota. |
Obsah štruktúry voliteľných parametrov verzie 1:
| Parameter | Dátový typ | Prednastavená hodnota | Popis |
|---|---|---|---|---|
1 | structVersion | INT |
| Verzia štruktúry - 1. |
2 | cacheId | INT | 0 (default read cache) | Identifikátor cache. |
3 | fakeTimeZone | INT | -1 (čas. pásmo procesu) | Emulácia časovej zóny pre vstupné/výstupné časové hodnoty. |
4 | userName | TEXT | "" (nezapisuje logovaciu informáciu) | Login užívateľa, ktorý vykonal zmenu. |
5 | clearFlags | BOOL | FALSE (nenuluje flagy) | Príznak, či pri nastavení flagu vymazať alebo ponechať staré flagy. |
6 | flag | INT | 0 (nenastavuje žiadny flag) | Číslo flagu, ktorý sa má nastaviť 0..3. |
7 | version | INT/TEXT | invalid (nenastavené) | Identifikátor (id/kód) verzie, do ktorej sa má vykonať zápis. |
8 | forceVersionTime | BOOL | @FALSE (časová pečiatka sa generuje - aktuálny čas) | Pre zapisované dáta vynúti použitie časovej pečiatky z parametra version. |
9 | invalidIsNoData | BOOL | @FALSE | Príznak určujúci, že pri vkladaní neplatnej hodnoty do periodického vektora je hodnota braná ako neexistujúca. Zápis takejto hodnoty je interpretovaný ako zmazanie hodnoty. |
10 | envName | TEXT | "" | Názov EDA prostredia, ktoré sa použije pre výpočet. |
11 | archAsync | BOOL | @FALSE | Zápis do archívneho vektora bez čakania na výsledok. Funkcia môže vrátiť ERR_NO_ERROR aj v prípade, že sa zápis do archívu nepodaril. Ignorované v prípade nearchívneho vektora. |
12 | archRecalcStats | BOOL | @TRUE | Pri zápise do archívneho vektora sa vykoná aj prepočet naviazaných štatistických archívov. Ignorované v prípade nearchívneho vektora. |
13 | batchId | INT | 0 | Identifikátor dávky, do ktorej sa má príkaz vložiť. |
14 | skipValidation | BOOL | @FALSE | Preskočí validáciu vkladaných hodnôt validačným predpisom. |
15 | userLog | TEXT |
| Užívateľský popis akcie. |