Enterprise Communication Interface (ECI)

eci_sel_typ

Description

Select records in a type list.

  • Open mask of type.
  • Select records.
  • User can select other records in interactive mode.
  • In interactive mode the selected records are checked by values given in chk_fld_val. If any record is already reserved by another user, the function stops and returns an error code. If selected records do not fulfill check values, return is rejected. User must select other records or cancel function.
  • Reservation flag:
    • "off" -all selected records are loaded.
    • "on" - records are reservered and loaded.
    • "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 number and C_IDs of selected records.
  • If wdg_remain-Flag has values "on" the list is not deleted at the end of function.

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 parametereci_sel_abo

 

Input parameter

ent_nam

string name of entity

typ_nam

string name of type

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 list remains on screen after execution of function {"on","off"}

res_flag

string reservation flag {"on","off", "ask", "noask", "stay"}

sel_fld_nam

stringlist names of fields for selection

sel_fld_val

stringlist values of fields for selection

chk_fld_nam

stringlist names of fields for check (only for "int")

chk_fld_val

stringlist names of fields to check (only if "int"-mode)

ret_check

string

flag to check return {"off", "E", "ET", "T" }

  • T: Return from type widget of the type "typ_nam" successful (Default).
  • E: Return from:
    • each widget with the father entity "ent_nam" (Default),
    • or reference widget with the child entity "ent_nam",
    • or entity widget with the entity "ent_nam" successful.
  • ET: Return from:
    • each type widget of the type "typ_nam",
    • or reference widget with the child entity "ent_nam",
    • or entity widget with the entity "ent_nam" successful.
  • off: no check

CpMasLimit

string

Parameter can have the value {"off"| "on"}.

  • on: The mask limit is considered when defining the selected data records (Default).
  • off:The mask limit is temporarily increased by the number of existing data records. The parameter is only evaluated in the batch mode.

Output parameter

n

string number of records found

ret_typ_cid

stringlist type-C_IDs of selected records

ret_ent_cid

stringlist join-C_IDs of selected records

 

Example

Select document type records (allow only selection of record from system 'EUCLID')

Input parameter:

ent_nam "EDB-DOCUMENT"
typ_nam "DRAWING"
wdg_nam "EDB-DOC-DRW-TLI"
wdg_ext "off"
wdg_mod "list"
act_mod "int"
wdg_remain "off"
res_flag "off"
sel_fld_nam "T_DOC_DAT.DOCUMENT_ID"
sel_fld_val "drw%"
chk_fld_nam "T_DOC_DRW.CRE_SYSTEM"
chk_fld_val "EUCLID"
ret_check "off"