Enterprise Communication Interface (ECI)

eci_upd_typ

Description

Modify record in type list.

  • Open mask of type.
  • Select record if record exists.

    If record does not exist:

    • Cancel function and return errorcode.

    If record exists:

    • Check if record is reserved by user if 'res_check' is "on" or "reset" if no access:

      If no:

      • Cancel function and return errorcode.

      If yes:

      • Update fields 'upd_fld_nam'.
      • User can modify record.
      • Field and list trigger of list are executed.
      • Record is saved.
      • If res_check="reset": reset reservation of record.
    • If interactive mode and Agile e6 default "ECI-UPD-HISTORY="1" is set:

      Corresponding history list is opened and user can insert a record in record-history-list.

    • Return values of return fields.
    • Close mask.

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"}

res_flag

string modify record only if reservation is set {"on","off","reset"}

sel_fld_nam

stringlist names of fields for selection

sel_fld_val

stringlist values of fields for selection

upd_fld_nam

stringlist names of default fields

upd_fld_val

stringlist values of default fields

ret_fld_nam

stringlist names of field to return

optimize

string With this parameter a database update is only done if the old and new values differ (and therefore, the modification date is not changed if the values are the same).
on = before writing the values of input parameter upd_fld_val it is checked whether the old value differs from new value. Only in this case the "new" value is written in field.
off = Value of upd_fld_val is written to field.

Output parameter

ret_fld_val

stringlist values of field to return

 

Example

Modify document type record

Input parameter:

ent_nam "EDB-DOCUMENT"
typ_nam "DRAWFILE"
wdg_nam "EDB-DOC-DFL-TLI"
wdg_ext "off"
wdg_mod "form"
act_mod "int"
res_flag "off"
sel_fld_nam "T_DOC_DAT.DOCUMENT_ID"
sel_fld_val "dfl001"
upd_fld_nam "T_DOC_DAT.DOC_NAME"
upd_fld_val "new name of dfl001"
ret_fld_nam "T_DOC_DFL.C_ID"
 
"T_DOC_DAT.C_ID"