# Enterprise Communication Interface (ECI)

## eci_sel_ent

### Description
Select records in an entity list. Open mask of entity. Select records using selection fields and values. User can continue selection of records. Interactive mode: Check fields and values ('chk_fld_nam') can be defined. If user selects menu 'Selection to CAD' then the selected records are checked with these conditions. If they do not fulfill the conditions then the function is aborted and a message is displayed. The user has to select other records or abort the eci-function. Reservation flag: "off" -all selected records are loaded. "on" - records are reservered and loaded. If any record is already reserved by another user, the functions stops and returns an error code. "noask" - records are reserved (if not already done) and loaded. "ask" - not reserved records are reserved and for reserved records the user is asked, if he wants to load the reserved record. "stay" - not reserved records are reserved. If any already reserved (by another user) records are selected, the selection is refused and the user has to select other records or return without any selection. Return of number of records and their C_IDs. If 'widget-remain'-flag is "on", then the list is not deleted at the end of the ECI-function. If the function eci_sel_ent is called again, then the opened list is referred.
| Before calling this function it is possible to call function eci_set_mas_men in order to put another select and nonselect menu to the list (-> eci_set_mas_men). The corresponding entries in dtv-MENU-Table are: EDB-ECX-SEL-SLS and EDB-ECX-SEL-NOS with the assigned entries of the SELECTION-Table: Selection to CAD: EDB-ECX-SEL with parameter eci_sel_ret Return to CAD: EDB-ECX-BRK with parameter eci_sel_abo
### Input parameter
ent_nam
string | name of entity
wdg_nam
string | name of mask
wdg_ext
string | activate system fields on list {"on", "off"}
wdg_mod
string | mode of widget {"list","form","bvb"}
act_mod
string | mode of interaction {"int","bat"}
wdg_remain
string | flag, if mask remains on screen at the end of function {"on","off"}
res_flag
string | reservation flag {"on","off", "ask", "noask", "stay"} off: All selected data records are loaded on: Data records are reserved and loaded. If the data record is already reserved, the function is cancelled and an error is issued. ask: Data records not reserved are reserved, for data records already reserved by another person a message is issued if you want to load the file anyway. noask: Data records not reserved are reserved and all selected data records are loaded. stay: Data records are reserved. If a selected data record is already reserved by another user, the selection is rejected and the user has to select another data record or the function is cancelled.
sel_fld_nam
stringlist | names of fields for selection
sel_fld_val
stringlist | values of fields for selection
chk_fld_nam
stringlist | names of check fields (only if act_mod is "int")
chk_fld_val
stringlist | values of check fields (only if act_mod ist "int")
ret_check
string | flag, if function allows only return from entity list 'ent_nam' check {"off", "E"}: off: no check E: Check if return from entity list (Default)
CpMasLimit
string | The parameter can have the value {"off"| "on"}. on: The mask limits are considered when selecting the data records (Default) off: The mask limits are increased temporarily by the number of existing data records. The parameter is only used in batch mode.
### Output parameter
n
string | number of records
ret_fld_cid
stringlist | C_IDs of selected records
### Example
Select item records (Select only items with ID art000 bis art009 ) Input parameter:
ent_nam | "EDB-ARTICLE"
wdg_nam | "EDB-ART-SLI"
wdg_ext | "off"
wdg_mod | "list"
act_mod | "int"
wdg_remain | "on"
res_flag | "off"
sel_fld_nam | "T_MASTER_DAT.PART_ID"
sel_fld_val | "art%"
chk_fld_nam | "T_MASTER_DAT.PART_ID"
chk_fld_val | "art?"
ret_check | "off"