#

# LogiView

## Command 'insert_ent'

| This command opens a virtual widget in the list mask of the specified entity to which data records are to be copied. See also 'iwf_lis_ent' DataView function.
| This command must not be called in a conditional instruction. If the command is called without a transfer string - i.e. just 'inser_ent()' - all corresponding records in the mask of the currently active widget are copied and saved. Using the 'var' command, the variables to be used (and thus the table fields to be filled in) are defined.
| The nested use of commands may lead to problems. This is the case when exactly the same parameter strinb is used. Example
| ### Syntax:
| insert_ent({STR_EXPR| })
| ### I/O parameters:
| {STR_EXPR} | Name of entity [<space> name of list mask]
| none |
| ### Return value:
| {INT_VAR} | Number of records.
| ### Example:
| Declaration of Variables
     10 insert_ent("EDB-PACKET")
     20 var(EP_FOLD_NAME,EP_FOLD_TYPE,EP_FOLD_CHK_NAME,EP_FOLD_STATUS,
             EP_FOLD_MEMO)
     30 DOCU_INT_1 = execute(1)
| Functions and commands: DB / Mask Interface