#

# LogiView

## Command 'insert_ref'

| This command opens a virtual widget in the list mask of the specified reference in which data records are to be inserted/copied to. See also the 'iwf_lis_ref' 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. Use the ''where_ent' command to define a different father widget. Using the 'var' command, the variables to be used (and this 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_ref({STR_EXPR| })
| ### I/O parameters:
| {STR_EXPR} | Name of Entity 1 <space> name of Entity 2 <space> name of view
| - |
| ### Return value:
| - |
| ### Example:
| Declaration of Variables
     10 insert_ref("GROUP USER ASSIGNMENT")
     20 var(EP_GRP_USR_ACC,EP_GRP_USR_DEF)
     30 where_ent("T_GROUP.C_NAME" = EP_GROUP_NAME)
     40 where_ent2("T_USER.C_NAME" = EP_USER_NAME)
     50 RES = execute(1)
     60 if (RES == 1)
     70   put_mes("EDB-ASS-USR-GRP-OK",EP_USER_NAME,EP_GROUP_NAME)
     80 else
     90   exit()
    100 endif
| Functions and commands: DB / Mask Interface