#

# LogiView

## Command 'select_ref'

| This command is used to open a virtual widget with the list mask for the specified refine relationship, that is used to select records. See also DataView function 'iwf_lis_ref'. If this command is called without transfer string - i.e. 'select_ref( )' only -, the database search is performed in the mask of the currently activated widget. If necessary, the command 'where_ent' is used to set another "parent" for the relational widget. Calling the 'var' command specifies the variables to be assigned. Without this command only the number of matching records is returned (to the function 'execute').
| This command must not be called with a conditional instruction.
| The nested use of commands may lead to problems. This is the case when exactly the same parameter strinb is used. Example
| ### Syntax:
| select_ref({STR_EXPR| })
| ### I/O parameters:
| {STR_EXPR} | Name of entity-1 <space> Name of entity-2 <space> Name of view <space> Name of list mask
| - |
| ### Return value:
| - |
| ### Example:
| Declaration of Variables
     20 C -- Let user select the file to be viewed if there is

               more than one

     30 select_ref("EDB-DOCUMENT EDB-FILE STR EDB-DOC-FIL-RLI-APP")

     40 var(EP_FIL_CID,EP_FILE_ORGNAM,EP_FILE_TYPE)

     50 where_ent("T_DOC_DAT.C_ID" = EP_DOC_CID)

     60 where("T_FILE_DAT.ORG_NAME" = "%DOC")

    100 DOCU_INT_1 = execute(1,"choose /MESSAGE=EDB-FIL-SEL-VIE")
| Functions and commands: DB/Mask Interface