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. |
Pridať komentár