# Enterprise Communication Interface (ECI)

## eci_cko_typ_fil

### Description
Open mask of type. Search for type data record with the specified search criteria. Open referenced mask for FILE entity. Select file allocation with search criteria. Checkout of file allocation depending on checkout flag. Close masks. If entry does not exist, issue message via return code. By entering the key "#SERVER" the file is checked out on DTV-Server side. If the key is not specified, the file is checked out on DTV Client side.
| This ECI functions can be protected by role concept, too. These functions call userexits which are menu selection userexits. If you protect these menu userexits by replacing the standard userexit with TASK-userexit, the assigned tasks are checked. But as the ECI functions called the userexits directly, the modifications do not have any consequences to the ECI functions. Now you can define configuration parameters to determine which task should be checked by these ECI functions: New configuration parameters (grouped under rubric EDB-ECI): <name of task> EDB-ECI-CKO-TYP-FIL
Name | Value | which ECI functions use this parameter
EDB-ECI-CKO-TYP-FIL | <name of task> | eci_cko_typ_fil
### Input parameter
ent_nam
string | Name of entity
typ_nam
string | Name of type
wdg_nam
string | Name of type mask
wdg_ext
string | Select system fields for type mask {"on", "off"}
wdg_mod
string | Mask type {"list","form","bvb"}
act_mod
string | Type of interaction {"int","bat"}
sel_typ_fld
stringlist | Field names for selecting the type data record
sel_typ_val
stringlist | Field values for selecting the type data record
rel_wdg_nam
string | Name of referenced mask for entity 'EDB-FILE'
rel_wdg_ext
string | Select system fields of referenced mask {"on", "off"}
rel_wdg_mod
string | Type of referenced mask {"list","form","bvb"}
sel_rel_fld
stringlist | Field values for selecting the referenced record
sel_rel_val
stringlist | Field values for selecting the referenced record
cko_flag
string | Checkout flag {"one", "all", "max"} 'one': check-out of file if file allocation has been found 'all': All file allocations found are checked-out 'max': The file with the highest position number is checked out.
node_target
string | Target node for file check-out
disc_target
string | Target disc for file check-out
path_target
string | Target path for file check-out
new_fil_nam
string | New file name (for cko_flag='one' or 'max' only)
glb_sec_are
string | Defines the name of the global vault (File replikation). This parameter is usually empty.
### Example
Checkout of file with highest position number Input parameter:
ent_nam | „EDB-DOCUMENT"
typ_nam | „DRAWING"
wdg_nam | „EDB-DOC-DRW-TLI"
wdg_ext | „off"
wdg_mod | „list"
act_mod | „bat"
sel_typ_fld | „T_DOC_DAT.DOCUMENT_ID"
sel_typ_val | „drw001"
rel_wdg_nam | „EDB-DOC-FIL-RLI-C"
rel_wdg_ext | „off"
rel_wdg_mod | „list"
sel_rel_fld | „T_FILE_DAT.FILE_TYPE"
sel_rel_val | „CATIA"
cko_flag | „max"
node_target | „hp9801"
disc_target | „/"
path_target | „tmp"
new_fil_nam | „new.dat"