:PUT_VAR_PROCESS
Script Statement: Writes the content of a data sequence to a static VARA object.
Syntax
:PUT_VAR_PROCESS VARA object, Data Sequence Reference
|
Syntax |
Description/Format |
|---|---|
|
VARA object |
The name of the static VARA object in which the values should be stored
. |
|
Data Sequence Reference |
The reference of the data sequence whose content should be written to the VARA object.
|
You can use this script element in order to fill a static VARA object with the content of a data sequence. The columns of the data sequence are written to the columns of the VARA object (including the Key column).
Keep the following in mind:
- The script element :PUT_VAR_PROCESS removes all entries of the VARA object before it re-fills it. The result is that the VARA object will include the exact entries of the data sequence once you have successfully run this script element.
- Static VARA objects include 6 columns (the Key column plus five value columns). The script element :PUT_VAR_PROCESS fills these columns with the first 6 columns of the data sequence. This means that when the data sequence includes more than 6 columns, these will be ignored.
- When :PUT_VAR_PROCESS tries to write in variable values which are not accepted because they duplicate a key or there is only one accepted entry, it returns the error number 20683 via sys_last_err_nr() and the location of error via sys_last_err_ins().
Warning! You cannot specify dynamic VARA objects because they retrieve their values dynamically and do not store them statically.
Warning! Note that certain rules and limitations apply to the values of static VARA objects. For more information, see VARA Object Attributes.
See also: