#

# LogiView

## Command 'delete_ref'

| This command opens a virtual widget in the list mask of the specified reference in which data records are to be deleted (temporarily). See also 'rwf_lis_ref' (DataView function).
| This command must not be called in a conditional instruction. Use the 'where_ent' command to change the parent widget reference. If this command is called without a transfer string - i.e. just 'delete_ref( )' - a database research in the mask of the active widget is executed before the data records to be deleted and are copied into the trash can (i.e. deleted temporarily). In order to delete those records permanently, you need to empty the trash can afterwards. However, this will delete all files in the trash can permanently, including records that have been moved to the trash can interactively. Generally speaking, users can only delete records for which they have write access!
| The nested use of commands may lead to problems. This is the case when exactly the same parameter strinb is used. Example
| ### Syntax:
| delete_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
    130	elseif ( mode () == "T" )
    140	  put ("removing from person - message relation ...")
    150	  EP_WDG     = widget_id ()
    160	  EP_WDG_FAT = widget_id_fat (EP_WDG)
    170	  if (EP_WDG_FAT != 0)
    180	    field_read (EP_WDG_FAT,"T_PRS_DAT.C_ID",0,EIS_PRS_CID)
    190	    delete_ref ("EDB-PERSON SUP-MSG STR")
    200	    where_ent  ("T_PRS_DAT.C_ID" = EIS_PRS_CID)
    210	    where      ("T_SUPPORT.SUP_ID" = SUP_FIS_NR)
    220	    where      (&"T_CUS_SUP.MEMO" = SUP_MEMO)
    230	    RES = execute (0)
    240	  endif
    250	endif
| Functions and commands: DB / Mask Interface