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"