# Userexits

Functions

## Edit-Action userexits
[Action userexits]

### Functions
int | sig_cfg_edt ()
| Writes field values into the config parameters, if "store" was choosen.
int | tol_edit_act ()
| Edit-action userexit to calculate fields of the current mask.
int | xartic_action ()
| Edit-action userexit for item masks.
int | xartst_action (const char *param1, const char *param2)
int | xatt_eda (const char *param1, const char *param2)
int | xchg_cre_eav_men (const char *param1, const char *param2)
int | xchg_ins_new_wdg (const char *param1, const char *param2)
int | xcnf_app_r11_eda (const char *param1, const char *param2)
int | xcnf_cps_elm_eda (const char *param1, const char *param2)
int | xcnf_cps_elm_str_eda (const char *param1, const char *param2)
int | xcnf_cps_hie_sol_edt (const char *param, const char *ignore)
int | xcnf_cps_sol_eda (const char *param1, const char *param2)
int | xcnf_ord_eda (const char *param1, const char *param2)
int | xcnf_ord_spc_eda (const char *param1, const char *param2)
int | xcnf_prd_cla_eda (const char *param1, const char *param2)
int | xcnf_spc_str_agg_eda (const char *param1, const char *param2)
int | xcnf_spc_str_ref_eda (const char *param1, const char *param2)
int | xcnf_spc_var_fin_edt (const char *param1, const char *param2)
int | xcpa_ali_eda ()
| Edit-action userexit for the Alias IDs constraint lists, e.g. EDB-CPA-ART-CNS-SLI.
int | xcpa_eda ()
| Edit-action userexit on cooperation partner and organization forms and lists.
int | xcpa_obj_eda (const char *param1, const char *param2)
int | xcps_alt_eda (const char *param1, const char *param2)
int | xcps_clr_spc_rul_eda (const char *param1, const char *param2)
int | xcps_cmp_eda (const char *param1, const char *param2)
int | xcps_elm_eda (const char *param1, const char *param2)
int | xcps_flt_eda (const char *param1, const char *param2)
int | xcps_fnc_cmp_eda (const char *param1, const char *param2)
int | xcps_prl_elm_eda (const char *param1, const char *param2)
int | xcps_prl_set_vie_eda (const char *param1, const char *param2)
int | xcps_sol_eda (const char *param1, const char *param2)
int | xcps_sol_mul_eda (const char *param1, const char *param2)
int | xcps_sol_upd_ctl_lev (const char *param1, const char *param2)
int | xctx_ctx_eda (const char *param1, const char *param2)
int | xctx_eda (const char *param1, const char *param2)
int | xdfv_get_val_eda (const char *param1, const char *param2)
int | xdir_nop_ins ()
| Calls the standard userexit "dal_cch_nop_ins" if widget is not filled by the system.
int | xdocfi_eda ()
| Edit-action userexit for document-file relation masks.
int | xdocst_action ()
| Edit-action userexit for document structures.
int | xdocty_action ()
| Edit-action userexit for document type widget.
int | xdocum_action ()
| Edit-action userexit for document master masks.
int | xedb_eda ()
| Basic edit-action userexit.
int | xedb_max_pnr (const char *param1, const char *param2)
int | xedb_nop_ins_eda ()
| Basic edit-action userexit.
int | xedb_put_dfv_eda ()
| Edit-action userexit to set the default values of some fields.
int | xedb_rel_eda (const char *param1, const char *param2)
int | xedb_rpl_eda ()
| Replace a position in the structure (edit action).
int | xedb_ulk_fat_eda ()
| Basic edit-action userexit for refine widgets.
int | xeer_edb_CheckRecord ()
| Checks whether the current record is a read-only copy (ROC).
int | xgroup_action ()
| Edit-action-USX for class form or list (e.g.
int | xgrpst_action ()
| Edit-action userexit for classification group structure.
int | xhisto_action ()
| Edit-action userexit for object history relation widgets.
int | xntm_eda ()
| Edit-action userexit for notes administration widgets.
int | xord_action ()
| Edit-action userexit for list of the order specific bill of material.
int | xpac_edit_act ()
| Edit-action userexit at the master and type list of the element packet.
int | xpac_multyp_edit_act ()
| Edit-action userexit at the relation mask of the element packet In insert mode all fields with corresponding type fields in the element packet are pre-set with the values of the master entity.
int | xpdw_obj_chk_cur_pro (const char *param1, const char *param2)
int | xpdw_obj_eda (const char *param1, const char *param2)
int | xpdw_pro_eda (const char *param1, const char *param2)
int | xpdw_rel_eda (const char *param1, const char *param2)
int | xprm_chk_task_a (const char *param1, const char *param2)
int | xproje_action ()
| Edit-action userexit for project masks.
int | xprost_action ()
| Edit-action userexit for project structures.
int | xrel_edt_act ()
| Sets the field access (or post-field userexit).
int | xsml_edt_action ()
| Edit-action userexit for type classification lists and forms (e.g.
int | xsmldf_action ()
| Edit-action userexit for class definition mask.
int | xstare_eda ()
| Edit-action userexit for the vault definition mask.
int | xstate_set_ini_lev (const char *param1, const char *param2)
int | xstate_set_lev_men (const char *param1, const char *param2)
int | xtrf_eda ()
| Clears the reference number field of transformation record in copy mode.
int | xtxt_ins_eda (const char *param1, const char *param2)
int | xtxt_ins_sel_pre_edt (const char *param1, const char *param2)
int | xtxt_tpl_eda (const char *param1, const char *param2)
int | xtyp_eda ()
| Edit-action userexit for type widget.
int | xunit_action ()
| Deletes the active menu from the screen when it is in insert mode (parameter[0] = I).
int | xutil_cch_upd_mas_joi (const char *param1, const char *param2)
int | xutil_chk_ins (const char *param1, const char *param2)
int | xutil_exec_sto_proc (const char *param1, const char *param2)
int | xutil_set_wdg_buf (const char *param1, const char *param2)
int | xvar_edt_action ()
| Edit-action userexit to check the user access to the variant list.
int | xvardf_vfl_act ()
| Edit-action userexit for variants (e.g.
int | zag_fld_put_dfv_eda ()
| Edit-action-USX to set the default values of some fields.

### Function Documentation

int sig_cfg_edt | ( | ) |

Writes field values into the config parameters, if "store" was choosen.

Parameters:

  cpPar | standard parameters
  cpIgn | not used

Returns:

  0 | ok
  1 | error

int tol_edit_act | ( | ) |

Edit-action userexit to calculate fields of the current mask.

Parameters:

  cp_par | Standard parameter defining working mode and current row

Returns:

  0 | OK
  Else | Error

int xartic_action | ( | ) |

Edit-action userexit for item masks.

If working mode is 'C'opy or 'U'pdate:

- Check if the current item is a variant item. By default, variant items cannot be updated. To allow updating of variant items, set the configuration parameter `EDB-ART-VAR-UPD` to 1.
- Call the standard edit-action userexit `xedb_eda` with the parameter string passed to this userexit. If no parameter string was passed, then call `xedb_eda` with the parameter `/FIELD_TYPE=ENTITY`.

Parameters:

  CpPar | Standard parameter with working mode and current row.
  CpArgument | Defines for which field(s) the default value shall be set. Please refer to the userexits `xedb_put_dfv_eda` and `xedb_eda`.

Returns:

  0 | OK
  1 | Variants must not be updated in the current mask
  2 | Error in `xedb_eda`

int xartst_action | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for the item structure.

- Calls the userexit `xtrf_eda` to clear the reference number field for transformation.
- Calls the generic relation edit-action userexit `xedb_rel_eda`.

Parameters:

  ctx | The action userexit context.
  param | The parameters passed to the userexit. This parameter is passed to both `xtrf_eda` and `xedb_rel_eda`. Please refer to these userexits for possible parameters.

Returns:

  0 | OK
  <> 0 | Error in either `xtrf_eda` or `xedb_rel_eda`.

int xatt_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit action userexit for classification lists.

The userexit prevents insert, copy, update and delete operations in the classification lists of conatiner classes (abstract classes which have only sub-classes but no directly assigned objects. In this case, the parameter /SUB is given.

Parameters:

  context | Userexit context.
  cp_UserPar | Parameter for the edit-action userexit, syntax like: "/TABLE=table_name /SUB /VAR" where: table_name Name of the table used to find the attribute field definitions (e.g. T_MASTER_FLD, T_GRP_FLD). As the same userexit is used for classification and variant lists, this option is needed to identify where the userexit is called from.

- /SUB - usrexit is called for classification lists of container classes.
- /VAR - specific for variant lists, the table name is usually T_MASTER_ATT but another customer relation table can also be used.

Returns:

  0 | OK
  1 | insert, update, copy and delete operations are not allowed

Remarks:
  : For parameter /SUB: the delete operation is checked in xatt_pra.

int xchg_cre_eav_men | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Creates menus for all entities and views under the Change Management control and adds it to the corresponding fields.

Edit action userexit to create the menus for entity and view names, avoiding double entries and adding this menu to the EDB_EN1_NAM/EDB_VIE_NAM field of the change operation form. This menu is used only in query mode to see all possible entities under the Change Management control.

Parameters:

  context | The context of the userexit
  param | /ENT1_MEN=MenuName /VIEW_MEN=AnotherMenuName (Menu names should be unknown in the db/repository)

Returns:

  0 | OK
  Else | Error

int xchg_ins_new_wdg | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit action usx to insert the entry(s) into the edited new widget of the so called monster form.

The insert is made in several steps to have a definite start condition:

1. Initially a record is copied to the widget. All fields set to "unchanged" (not "dirty").
2. During "specify" operation: Fields, which do not belong to the main table nor to the join table are cleaned out (this does not happen during "re-specify" operation).
3. Field defaults are set if defined (the corresponding field will be set "dirty"!).
4. Parameter /NODEF defines a list of fields for which the default value will be deleted. The cleaned-out fields will be set to unchanged (not "dirty").
5. Invisible relation fields which are still unchanged (not "dirty") are set to '***' .
6. Dependent on the filter entry, the values of visible relation fields are set. In case the filter field is empty, the value '***' is set. Otherwise the value used as filter criteria will be set. Setting field value to '***' will not set the field to "dirty" (fields remain unchanged). Visible relation fields which are not in the filter and still unchanged (not dirty) are set to '***' .
7. Relation field access is set corresponding to the settings in the configuration which might be writable (w), mandatory (m), filter dependend (f) or read only (r)
8. Additional lines (replace 1:n [all]) will be handled like new entries in the corresponding relation lists. The position number is always set to '***', the real value of the position number is calculated for each operation depending on the highest existing position number. The defaults will be set, the /NODEF parameter has no influence.
9. During "re-specify" only the first row is handled like described above. Additionally the previously changed values (during "specify") are written into the corresponding fields.
   Additional rows (replace 1:n [all]) are inserted in the same state as they were executed during previoous operation ("specify"). Defaults are set only in the first row. The /NODEF parameter influence only the first row.

The steps are done in this order to have a definite and reproducible state after opening the monster form and to avoid side effects to other regular operations (specially the setting of defaults and afterwards deleting some of them is due to this: simply removing defaults from the mask/field could have effects on other operations)

Parameters:

  context | The userexit context.
  param | Parameter to control the behaviour of this function. Syntax like: "[/NODEF=<list of field names>]" with possible arguments:
  NODEF | QUANTITY_BOM,EDB_UNIT | If the option is passed, the defaults of the listed relation fields will be removed and the field is set unchanged (not "dirty"). Only relation field names without table name are allowed

Returns:
  0 = Success, otherwise error

int xcnf_app_r11_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for Replace 1-1 list.

In 'I'nsert, 'C'opy mode:

Copies the position id from the origin widget into the new widget.

private edit-action

Parameters:

  cpAction | Standard action userexit parameter
  cpArguments | Not used yet

Returns:
  - 0 = o.k.

int xcnf_cps_elm_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for order specific product structure element widgets.

Checks if it is allowed to update the order element. Only order specific elements can be updated.

Parameters:

  context | Standard parameter defining working mode and current row.
  param | Standard userexit parameter, (reserved).

Returns:

  0 | OK
  1 | Error

int xcnf_cps_elm_str_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for order specific product structure element structure widgets.

'U'pdate | Checks if it is allowed to update the structure element. Only order specific elements can be updated.
'I'insert | Sets the reference to the product component.

Parameters:

  context | Standard parameter defining working mode and current row.
  param | Standard userexit parameter (reserved).

Returns:

  0 | OK
  1 | Error

int xcnf_cps_hie_sol_edt | ( | const char * | param,
|  | const char * | ignore
| ) |  |

Select-Menu userexit for product structure element for add and update positions.

Parameters:

  param | Standard userexit parameter (reserved).

Returns:

  0 | OK
  1 | Error

int xcnf_cps_sol_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for product structure element structure.

Parameters:

  context | Standard parameter defining working mode and current row.
  param | Standard userexit parameter (reserved).

Returns:

  0 | OK
  1 | Error

int xcnf_ord_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for configuration order widgets.

The userexit covers the following actions:

'C'opy | The userexit clears the following fields "T_ORD_DAT.EDB_SPEC_CHECK", "T_ORD_DAT.EDB_DERIVED", "T_ORD_DAT.EDB_LAST_CHANGE"

Parameters:

  context | Standard parameter defining working mode and current row.
  param | Standard userexit parameter (reserved).

Returns:

  0 | OK
  1 | Error

int xcnf_ord_spc_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for order specification aggragate list.

Checks if it is allowed to change the assignment of the specifications in current state of the related order. It is not allowed to change the Order specification assignment if the the State of the order has the approved/releases or the inactive flag set.

Parameters:

  context | Standard parameter defining working mode and current row.
  param | Standard userexit parameter (reserved).

Returns:

  0 | OK
  Else | Error

int xcnf_prd_cla_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for product variant widgets.

'C'opy | Clears T_PRD_VAR_DAT.C_ID
'I'nsert | Mode the cooperation partner code from the product family is copied to the current product variant record.
'U'pdate | Mode the access could be checked and restricted if the parameter PRDVARSTATE is set.

Parameters:

  context | Standard parameter defining working mode and current row.
  param | /PRDVARSTATE string of product state abbreviations where the update of the product variant is allowed. Valid characters are: 'W' in work 'A' approved 'R' released 'V' versionized 'I' inactive If parameter /S for strict mode is passed, also manager users are forced to limited update possibilities.

Returns:

  0 | OK
  1 | Error

int xcnf_spc_str_agg_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for specification structure aggregate list.

'I'nsert | Checks if the current specification (field T_AVL_DAT.INTERN) is external (value = "n"), otherwise a message is displayed.

Parameters:

  context | Standard action userexit parameter
  param | (reserved)

Returns:

  0 | OK
  1 | Current specification is not an external

int xcnf_spc_str_ref_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for specification structure refine widget.

This userexit covers the following actions:

'I'nsert | Checks if the current specification (field T_AVL_DAT.INTERN) is internal (value = "y"), otherwise a message is displayed.

Parameters:

  context | Standard action userexit parameter
  param | (reserved)

Returns:

  0 | OK
  1 | Current specification is not internal

int xcnf_spc_var_fin_edt | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Pre-field userexit for specification product variant select widget.

Parameters:

  param |

Returns:

  0 | OK
  1 | Error

int xcpa_ali_eda | ( | ) |

Edit-action userexit for the Alias IDs constraint lists, e.g. EDB-CPA-ART-CNS-SLI.

'C'opy | Deletes the old value of the field <aliasid tablename>="">.C_DEFAULT of the new Alias ID record.

Parameters:

  param | Additional argument string (reserved).

Returns:

  0 | OK
  1 | Field not found
  2 | No record in edit mode
  3 | No widget is active

Edit-action userexit on masks which support Alias IDs.

int xcpa_eda | ( | ) |

Edit-action userexit on cooperation partner and organization forms and lists.

'C'opy | Deletes the current value of the field T_ORG_DAT.STEP_INT_ID (Code).

Parameters:

  cpPar | Standard parameter with working mode and current row.
  cpArg | Additional argument string.

Returns:

  0 | OK
  1 | Field not found
  2 | No record in edit mode
  3 | No widget is active

See also:
  xcpa_pra

int xcpa_obj_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for objects that support Alias ID (for example item or document).

'C'opy | Clears the view fields of the Alias Id view of the current record.

Note:
  This userexit should be used together with the pre-action userexit xcpa_obj_pra and the post-action userexit xcpa_obj_poa

Parameters:

  context | Standard parameter defining working mode and current row.
  param | Additional argument string. Syntax is: "ARG /TABLE=<view table> /ENTITY=<entity name>" With possible arguments:
  | ARG | Main argument.
  /TABLE | <view table>=""> | Name of the view table (e.g. V_CPA_ART_DAT).
  /ENTITY | <entity name>=""> | Name of the Alias ID entity (e.g. EDB-CPA-ARTICLE).

Returns:

  0 | OK
  1 | No parameters set.
  2 | No record in edit mode.
  3 | Key TABLE not set.
  4 | No widget is active.

Example:
  xcpa_obj_eda(/TABLE=V_CPA_ART_DAT /ENTITY=EDB-CPA-ARTICLE)

See also:
  xcpa_obj_pra xcpa_obj_poa

int xcps_alt_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for variant mask (modular BOM solutions).

This userexit deals with the following actions:

'I'nsert | Gets the component EDB_ID from the parent widget and stores it in the buffer of the current widget(sublist), which is needed later by the pre-mask userexit of the select widget for item solutions. Sets the field access by using the userexit (xutil_acc_fld ).
'U'pdate | Gets the component EDB_ID from the parent widget and stores it in the buffer of the current widget(sublist), which is needed later by the pre-mask userexit of the select widget for item solutions. Sets the field access by using the userexit (xutil_acc_fld ).
'C'opy | Clears the specification rule fields. Gets the component EDB_ID from the parent widget and stores it in the buffer of the current widget(sublist), which is needed later by the pre-mask userexit of the select widget for item solutions. Sets the field access by using the userexit (xutil_acc_fld ).

Parameters:

  context | Action userexit context
  param | Reserved

Returns:

  0 | OK
  Else | Error

int xcps_clr_spc_rul_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Clears specification rule reference fields.

This userexit deals with the following actions:

'C'opy | Creates a specification rule and assigns the specification rule to the variant.

Parameters:

  context | Action userexit context
  param | Reserved

Returns:

  0 | OK
  Else | Error

See also:
  xcps_cre_spc_rul_pra

int xcps_cmp_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for product components.

This userexit deals with the following actions:

'I'nsert | Checks if the combined widget is displayed as main form.
'C'opy | Checks if the combined widget is displayed as main form, clears the constraint fields and resets the field defaults.

Parameters:

  context | Action userexit context
  param | Reserved

Returns:

  0 | OK
  Else | Error

int xcps_elm_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for product structure elements.

This userexit deals with the following actions:

'I'nsert | Sets a reference to the parent record (EDB_STR_REF) if called in combined form and sets the field access.
'U'pdate | Sets a reference to the parent record (EDB_STR_REF) if called in combined form and sets the field access.
'C'opy | Clears constraint fields.

Parameters:

  context | Action userexit context
  param | Reserved

Returns:

  0 | Ok
  Else | Error

int xcps_flt_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for filters.

This userexit deals with the following actions:

'I'nsert | Copies the value of the EDB_ID field of the product structure element of the parent mask into the EDB_ELM_REF field.

Parameters:

  context | Action userexit context
  param | Reserved

Returns:

  0 | OK
  Else | Error

int xcps_fnc_cmp_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for function - product component aggregate form.

The standard behavior is to suppress insert and copy operations in the aggregate form. If for any reason an insert or copy operation should be allowed (this is not recommended), then set the flags /INSERT or /COPY.

The userexit supports the following modes:

'I'nsert | Returns 1 to prevent insert (if flag /INSERT is not set).
'C'opy | Returns 1 to prevent copy (if flag /COPY is not set).

Parameters:

  context | Action userexit context
  param | Parameter to control the behavior of this function. Syntax like: "[/INSERT][/COPY]" with possible arguments:
  INSERT | Allow insert.
  COPY | Allow copy.

Returns:

  0 | OK
  1 | Insert/Copy not allowed

int xcps_prl_elm_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit action userexit for parallel structure - product component widgets.

This userexit deals with the following actions:

'I'nsert | Set top level parallel structure element.
'C'opy | Set top level parallel structure element.

Note:
  Field T_CPS_PRL_ELM.EDB_PRL_REF contains EDB_ID of top level parallel structure element.

Parameters:

  context | Action userexit context
  param | Reserved

Returns:

  0 | OK

int xcps_prl_set_vie_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit action userexit for parallel structure (node) widgets.

This userexit deals with the following actions:

'I'nsert | Write value of T_CPS_PRL_DAT.EDB_VIEW of record in parent widget to current record.
'C'opy | Write value of T_CPS_PRL_DAT.EDB_VIEW of record in parent widget to current record.
'++' (double click) | Write value of T_CPS_PRL_DAT.EDB_VIEW of record in parent widget to current record.

Parameters:

  context | Action userexit context
  param | Reserved

Returns:

  0 | OK

int xcps_sol_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for solutions list of neutral product structure elements.

This userexit deals with the following actions:

'I'nsert, 'U'pdate, 'C'opy | Reads the default EDB-CPS-SOL-PRD and writes value to V_CPS_PRD_SOL.PART_ID. Prepares widget to work with select widgets assigned to mask fields.

Parameters:

  context | Action userexit context
  param | Parameter to control the behavior of this function. Syntax is: "[/DEF]" With possible arguments:
  DEF | Writes default for product field (V_CPS_PRD_SOL.PART_ID).

Returns:

  0 | OK
  Else | Error

int xcps_sol_mul_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for multi-edit solution list.

This userexit deals with the following actions:

'U'pdate | Sets the field access which is defined by using the information of the field userexit 'xutil_acc_fld'.

Parameters:

  context | Action userexit context
  param | Reserved

Returns:

  0 | OK
  Else | Error

See also:
  xutil_acc_fld

int xcps_sol_upd_ctl_lev | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for solution list.

This userexit deals with the following actions:

'I'nsert, 'U'pdate, 'C'opy | Updates the control level attribute of the current object. Checks if the effective object is a work order and sets the control level to OFF.

Parameters:

  context | Action userexit context
  param | Reserved

Returns:

  0 | OK
  Else | Error

int xctx_ctx_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for the list of contexts.

This userexit deals with the following actions:

'I'nsert, 'C'opy | Creates a new slot ID and writes the slot ID into the field `EDB_SLOT`.

Parameters:

  ctx | Action userexit context.
  param | Reserved.

Returns:

  0 | OK
  Else | Error

int xctx_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for all relation lists that use the context.

This userexit deals with the following actions:

'I'nsert, 'C'opy | Initializes the context assignment of the new record to determine in which contexts the record is initially visible.

Algorithm to determine in which contexts the record is visible:

- If a context id is passed as a parameter, the record is only visible in this specific context.
- If no context id is passed as a parameter, but a global context is currently set, the record is only visible in this context.
- If the current context has been set using xctx_set_nxt the context is taken from the widget buffer.
- Otherwise, the record will be visible in all contexts.

Parameters:

  ctx | Action userexit context.
  param | Parameter to control the behavior of this function. Syntax is: "[/CTX=context]" With possible arguments:
  CTX | contextId | ID of the context to be used.

Returns:

  0 | OK
  Else | Error

See also:
  xctx_set_nxt, xctx_prm, xctx_pra, xctx_poa

int xdfv_get_val_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for setup forms.

For all (calculatory and visible) fields of the current form on which the post-field userexit `xdfv_set_val_pof()`' is called, the existing default values are written into the field.

Parameters:

  ctx | Action userexit context.
  param | Reserved.

Returns:

  0 | Ok

See also:
  xdfv_set_val_pof

int xdir_nop_ins | ( | ) |

Calls the standard userexit "dal_cch_nop_ins" if widget is not filled by the system.

Parameters:

  cp_par | Standard parameter with working mode and current row.

Returns:

  0 | OK
  1 | Error from dal_cch_nop_ins

See also:
  dal_cch_nop_ins

int xdocfi_eda | ( | ) |

Edit-action userexit for document-file relation masks.

The userexit supports the following modes:

'I'nsert | Executed tasks: Checks the reservation state of document. The userexit reports an error if the document is reserved by another user. Checks if the user has the necessay access rights to insert a document - file relation record. The userexit reports an error if the if the user has the necessay access rights. If a global vault is set, the vault name will be written into the field STORAGE_AREA.
'U'pdate | Executed tasks: Checks the reservation state of document. The userexit reports an error if the document is reserved by another user. Checks if the user has the necessay access rights to update the document - file relation record. The userexit reports an error if the if the user has the necessay access rights. If a global vault is set, the vault name will be written into the field STORAGE_AREA.
'C'opy | Executed tasks: Checks the reservation state of document. The userexit reports an error if the document is reserved by another user. Checks if the user has the necessay access rights to copy the document - file relation record. The userexit reports an error if the if the user has the necessay access rights. Sets the default values for fields STEP_ID (to call the number server), CREATE_DATE and MODIFY_DATE.
'D'elete | Executed tasks: Checks if the user has the necessay access rights to delete the document - file relation record. The userexit reports an error if the if the user has the necessay access rights.

Parameters:

  cp_Parameter | standard action parameter
  cp_Arguments | not used

Returns:

  0 | OK
  Else | Error

int xdocst_action | ( | ) |

Edit-action userexit for document structures.

Calls the userexit `xtrf_eda` to clear the reference number field for transformations. If the working mode is 'C'opy, 'I'insert or 'U'pdate, call the usrexit `xedb_rel_eda` to check if the document is reserved and if write access on the parent is granted.

Parameters:

  par | Standard parameter defining working mode and current row.
  cp_Arguments | String with (optional) arguments to control this userexit, e.g.: `/XEDB_NO_CHK_RES` to avoid reservation check. The userexit itself does not evaluate any parameters, but the parameter string is passed to `xedb_rel_eda`.

Returns:

  0 | OK
  1 | Document reserved or no write access on parent element
  else | Other error

See also:
  `xedb_rel_eda`

int xdocty_action | ( | ) |

Edit-action userexit for document type widget.

Calls the standard edit-action userexit `xedb_eda` with the parameter `/FIELD_TYPE=ENTITY` or the given argument string.

This userexit covers the following actions:

'I'nsert | Writes the current document type into the field `DOC_TYPE` by calling `zag_fld_put_typ`. Then sets the query buffer of the field `DOC_TYPE` to the document type of the widget.
'C'opy | Writes the current document type into the field `DOC_TYPE` by calling `zag_fld_put_typ`.
'U'pdate | Locks the parent record.

Parameters:

  cp_Par | Standard parameter with working mode and current row.
  cp_Argument | Argument string to define for which field(s) the default value shall be set. Please refer to the userexit `xedb_put_dfv_eda`'.

Returns:

  0 | OK
  1 | Document is reserved.

See also:
  xedb_eda

int xdocum_action | ( | ) |

Edit-action userexit for document master masks.

Prevents from inserting or copying a document master record. Documents must be created in one of the type specific lists or forms.

Parameters:

  par | Standard parameter with working mode and current row

Returns:

  0 | OK
  1 | Insert / copy not permitted

int xedb_eda | ( | ) |

Basic edit-action userexit.

This userexit deals with the following actions:

'I'nsert | Check if current widget is displayed in main form if it is a combined form and the widget is not a virtual widget (see 'bvb_usx_chk_mfr').
'C'opy | Check if element is reserved. This check can be disabled by inserting the key NO_CHK_RES into the widget buffer. Check if current widget is displayed in main form, if it is a combined form and the widget is not a virtual widget (see 'bvb_usx_chk_mfr'). Field default values are set according to given argument string. The widget buffer will be set to "STA_COP" = 1.
'U'pdate | Check if element is reserved.

Note:
  To check for the current widget, if the working mode is 'C', you may use the function 'zag_get_buf_elm'.

Parameters:

  cp_Parameter | Standard parameter with working mode and current row.
  cp_Arguments | Argument string to define for which field(s) the default value shall be set. Please refer to documentation of the userexit 'xedb_put_dfv_eda'.

Returns:

  0 | Ok.
  1 | Element is reserved.
  2 | Current widget is a combined widget and not displayed as main form.

Example:

         if (zag_get_buf_elm(dal_wdg_ret_buf(NULL, wdg),"STA_COP",ca_value)==0)
                 --> Copy mode is set.

See also:
  zag_get_buf_elm, xedb_put_dfv_eda

int xedb_max_pnr | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Sets the position number for the current relation record.

The default value EDB-POS-INCREMENT is used to increment the current highest value. The userexit needs the constraint name if the relation is a constraint.

This userexit deals with the following actions:

'I'nsert | Calculates the next position number and writes it into the field POS_NO.
'C'opy | Calculates the next position number and writes it into the field POS_NO.

Parameters:

  context | Action userexit context.
  param | Parameter to control the behavior of this function. Syntax is: "/CNS=<name>" With possible arguments:
  CNS | name | Name of constraint.

Returns:

  0 | OK
  1 | Error

int xedb_nop_ins_eda | ( | ) |

Basic edit-action userexit.

This userexit deals with the following action:

'I'nsert | Prevent insert operation if current widget is an interactive one but allow it for virtual widgets.
'C'opy | Prevent copy operation if current widget is an interactive one but allow it for virtual widgets.

Parameters:

  cp_Parameter | Standard parameter with working mode and current row.
  cp_Arguments | Reserved.

Returns:

  0 | OK
  1 | No insert allowed.

int xedb_put_dfv_eda | ( | ) |

Edit-action userexit to set the default values of some fields.

Deprecated:
  Use zag_fld_put_dfv_eda instead.

This userexit deals with the following actions:

'C'opy | Copies the defaults values for fields.

Parameters:

  cp_Par | Standard parameter with working mode and current row.
  cpArguments | Parameter to control the behavior of this function. Syntax is: "{/NAME=<fieldlist> | /FIELD_TYPE={ALL_JOIN|ALL|ENTITY}}" With possible arguments:
  NAME | fieldlist | Comma-separated list of field names.
  FIELD_TYPE | ALL_JOIN | Sets the default for join fields.
  | ALL | Sets default for all fields.
  | ENTITY | Sets default for entity fields.

Returns:

  0 | OK
  1 | Error

See also:
  zag_fld_put_dfv_eda

int xedb_rel_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Basic edit-action userexit for relation widgets.

This function checks if the user may insert (or update resp. copy) a record in a relation list.

This userexit deals with the following actions:

'I'nsert | Checks the reservation state of the element if the Change Management is not active.
'C'opy | Checks the reservation state of the element and resets the reservation state of the newly created element.
'U'pdate | Checks the reservation state and access of the element if it is not controlled by the Change Management.

Parameters:

  ctx | Action userexit context.
  param | Parameter to control the behavior of this function. Syntax is: "[/XEDB_NO_CHK_RES]" With possible arguments:
  XEDB_NO_CHK_RES | Omit the check of the element's reservation.

Returns:

  0 | OK
  1 | Error
  2 | Virtual mode active.

int xedb_rpl_eda | ( | ) |

Replace a position in the structure (edit action).

This userexit deals with the following action:

'U'pdate | Write the master c_id in the widget buffer under the key RPLyyyPOS, where yyy is the current row. Set the record as 'm'odified in order to call the pre-action userexit in 'Q'uery mode (abort mode is 'Qrow') if the user cancels the action.

Note:
  Works only for refine widgets in 'U'pdate mode. Replace position must be activated ( the configuration parameter Entity-RPL must be set to REPLACE_POS).

Parameters:

  cpParameter | Standard parameter with working mode and current row.
  cpArguments | Reserved.

Returns:

  0 | OK
  1 | Error

int xedb_ulk_fat_eda | ( | ) |

Basic edit-action userexit for refine widgets.

This userexit deals with the following actions:

'I'nsert | Unlock parent of the current record. When you unlock the parent record, more than one user can insert a record in the structure list at the same time.

Note:
  If two users enter the same position number in the structure and save the record at the same time, the two position numbers are identical.

Parameters:

  cp_Parameter | Standard parameter with working mode and current row.

Returns:

  0 | Ok.
  1 | No records locked.
  2 | Lock-release is switched off.
  3 | No active widget.
  -1 | Database error during unlock of the records.

int xeer_edb_CheckRecord | ( | ) |

Checks whether the current record is a read-only copy (ROC).

If this is true, updating the current record is prohibited.

Note:
  This userexit is called by the internal system edit action trigger xeer_edb_Internal_eda() in 'U'pdate mode only. It does not check the working mode itself!

Parameters:

  cp_Parameter | Default action trigger parameter
  cp_Arguments | Default action trigger argument (reserved)

Returns:

  EER_EDB_NO_ERROR | OK
  EER_EDB_NO_WIDGET_OPEN | No mask is open
  EER_EDB_RECORD_IS_ROC | Record is a read-only copy (ROC)

int xgroup_action | ( | ) |

Edit-action-USX for class form or list (e.g.

EDB-GRP-CFR, EDB-GRP-SLI). Calls the userexit xedb_eda with the argument /FIELD_TYPE=ENTITY or current argument string. In 'C'opy mode, copies the container flag settings of the copied class.

Parameters:

  context | Userexit context.
  cp_Argument | Argument string for yedb_eda (e.g. to define for which fields the default value will be set. Please refer to documentation of the userexits 'xedb_eda' and 'xedb_put_dfv_eda'.

Returns:

  0 | OK
  otherwise | Error code of xedb_eda

See also:
  xedb_eda, xgroup_pre_action

int xgrpst_action | ( | ) |

Edit-action userexit for classification group structure.

Checks that class is not assigned to a product component.

Parameters:

  cp_Par | Standard parameter defining working mode and current row.

Returns:

  0 | OK
  2 | The parent class cannot become a container class as it is assigned to a product component.

See also:
  xgrpst_pre_action xgrpst_post_action

int xhisto_action | ( | ) |

Edit-action userexit for object history relation widgets.

This userexit performs the following actions:

'I'nsert | Check for write access to parent record, set field defaults, and set work order reference to `ECO_REF`.
'U'pdate | Allow update only for "MEMO" entries and check for write access to parent record.
'C'opy | Check for write access to parent record and set field defaults.

Parameters:

  cpParameter | Standard parameter with working mode and current row.
  cpArguments | Parameter to control the behavior of this function. Syntax is: "{/NAME=fieldlist] | /FIELD_TYPE={ALL_JOIN|ALL|ENTITY}}" With possible arguments:
  NAME | fieldlist | Comma separated field name list.
  FIELD_TYPE | ALL_JOIN | Set default for join fields.
  | ALL | Set default for all fields.
  | ENTITY | Set default for entity fields.

Returns:

  0 | OK
  1 | Error

See also:
  zag_fld_put_dfv_eda

int xntm_eda | ( | ) |

Edit-action userexit for notes administration widgets.

Allows only inserts if parent relation to this note is known.

This userexit deals with the following actions:

'I'nsert | Create new note id number and check for number conflict.
'C'opy | Create new note id number and check for number conflict.

Parameters:

  par | Standard parameter with working mode and current row.

Returns:

  0 | OK
  1 | Error

int xord_action | ( | ) |

Edit-action userexit for list of the order specific bill of material.

This userexit deals with the following actions:

'C'opy | Sets default values.

Parameters:

  cp_Parameter | Standard parameter defining working mode and current row.
  cp_Arguments | Parameter to control the behavior of this function. Syntax like: "{/NAME=<fieldlist>] | /FIELD_TYPE={ALL_JOIN|ALL|ENTITY}}" With possible arguments:
  NAME | fieldlist | Comma separated field name list.
  FIELD_TYPE | ALL_JOIN | Set default for join fields.
  | ALL | Set default for all fields.
  | ENTITY | Set default for entity fields.

Returns:

  0 | OK
  1 | Error

See also:
  zag_fld_put_dfv_eda

int xpac_edit_act | ( | ) |

Edit-action userexit at the master and type list of the element packet.

The flag STA_COP is attached to the widget buffer during copying. If the flag already exists in the widget buffer it will be deleted at the beginning of this function.
Since this flag is needed in the PRE-ACTION as well as in the POST-ACTION userexit and the POST-ACTION userexit is not necessarily called, the widget buffer cannot be reset at the end of this function.

Insert: Fills the field T_PAC_DAT.ELM_TYPE with the appropriate type name. Fills the fields T_PAC_DAT.EDB_ID and T_PAC_DAT.PAC_ID. Field value for T_PAC_DAT.EDB_ID is created via number server, afterwards the value is copied into the field T_PAC_DAT.PAC_ID<p>

Copy : If the mask is a type mask, the C_ID of the master and join table is deleted, and a new record is created while saving. (Only when copying within a widget.) The field T_PAC_DAT.ELM_TYPE is filled with the appropriate type name. The original CIDs are temporarily saved in the field buffer when copying with content in the Post-Act-Trigger. Fills the fields T_PAC_DAT.EDB_ID and T_PAC_DAT.PAC_ID. Field value for T_PAC_DAT.EDB_ID is created via number server, afterwards the value is copied into the field T_PAC_DAT.PAC_ID<p>

Parameters:

  par | Default parameter from DTV with working mode and row

Returns:

  0 | OK
  1 | Error

int xpac_multyp_edit_act | ( | ) |

Edit-action userexit at the relation mask of the element packet In insert mode all fields with corresponding type fields in the element packet are pre-set with the values of the master entity.

Parameters:

  par | Default parameter from DTV with working mode and current row

Returns:

  0 | OK
  1 | Error

int xpdw_obj_chk_cur_pro | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit to check if a current project or organizational unit is set.

The check is performed in 'C'opy and 'I'nsert mode only. This userexit is similar to `xpdw_obj_eda` but can be used for widgets where, when creating a new record, an object under control of Multi Access Rights is created in the background. The user is informed immediately that it is not possible to create the record and before the background creation is performed.

Remarks:
  Should be the first edit-action userexit in the object widget.

Parameters:

  ctx | The userexit context.
  param | Additional userexit parameters. Currently none.

Returns:

  0 | OK
  PDW_NO_ACCESS (730) | Access denied
  Else | Error

See also:
  xpdw_obj_eda

int xpdw_obj_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for object widgets.

If no current principal is selected, then the insertion of a new object is not allowed. Before the update of a record it is checked that you have PDW access to the record.

PDW access: Check if the origin principal of the record is visible from the current selected principal.

The entity specific configuration parameters are grouped under configuration rubric EDB-PDW-ENT-n with n representing a sequence number for the entities under PDW control (e.g. EDB-PDW-ENT-2 / EDB-PDW-CHK-OBJ-ACC-ENT-2 represent the settings for entity EDB-ARTICLE).

If configuration parameter EDB-PDW-CHK-OBJ-ACC-ENT-n for the parent entity has value "no" the PDW access check is skipped.

This userexit deals with the following actions:

'I'nsert | Checks that a current principal is set.
'C'opy | Checks that a current principal is set.
'U'pdate | Checks for PDW access.

Note:
  This userexit has to be the first edit-action userexit in the object widget.

Parameters:

  cpParameter | Standard parameter defining working mode and current row.
  cpArguments | Additional userexit parameters. Currently none.

Returns:

  0 | OK
  PDW_NO_ACCESS (730) | Access denied
  Else | Error

See also:
  xpdw_obj_pre, xpdw_obj_poa

public edit-action

int xpdw_pro_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

PDW edit-action userexit for project widgets.

- 'U'pdate: Checks if the project can be modified. If the project is the current project, the edit operation is denied. Otherwise, the project id of the project is stored in the widget buffer with the key `OLD_PRO`.

Note:
  Has to be the last edit-action userexit in project widget.

Parameters:

  usxContext | The userexit context.
  param | Additional userexit parameters. Currently none.

Returns:

  0 | OK
  1 | Error

See also:
  xpdw_pro_pre, xpdw_pro_poa

int xpdw_rel_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for object relation widgets.

PDW access: Check if the origin principal of the parent record is visible from the current selected principal.

The entity specific configuration parameters are grouped under configuration rubric EDB-PDW-ENT-n with n representing a sequence number for the entities under PDW control (e.g. EDB-PDW-ENT-2 / EDB-PDW-CHK-OBJ-ACC-ENT-2 represent the settings for entity EDB-ARTICLE).

If configuration parameter EDB-PDW-CHK-OBJ-ACC-ENT-n for the parent entity has value "no" the PDW access check is skipped.

If configuration parameter EDB-PDW-CHK-OBJ-BY-EDB has value "yes" the PDW access is skipped here but done by xedb_rel_eda. Depending on the value of default EDB_REL_ACT_INS the following access checks are done: Check for access by LogiView decision table EP/Insert_Str. If access is denied then check for "w"rite access to parent record. If access is still denied then check for PDW access to parent record (when EDB-PDW-CHK-OBJ-ACC-ENT-n for parent entity has value "yes").

This userexit deals with the following actions:

'I'nsert | Checks for PDW access to parent record.
'C'opy | Checks for PDW access to parent record.
'U'pdate | Checks for PDW access to parent record.

Note:
  This userexit has to be the first edit-action userexit in the object relation widget.

Parameters:

  cpParameter | Standard parameter defining working mode and current row.
  cpArguments | Additional userexit parameters. Currently none.

Returns:

  0 | OK
  Else | Error

See also:
  xpdw_rel_pre, xpdw_rel_poa

public edit-action

int xprm_chk_task_a | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Action userexit to check if the current user has the privilege to execute the given task.

Parameters:

  usxCtx | The userexit context.
  param | Parameter to control the behavior of this userexit. Syntax is: "taskName" With possible arguments:
  taskName |  | Name of the task to check.

Returns:

  0 | The user has the right to execute the given task.
  1 | The user does not have the right to execute the given task.
  <0 | Error while accessing the permission manager service.

int xproje_action | ( | ) |

Edit-action userexit for project masks.

Calls `xedb_eda` with the given argument string, or with `/FIELD_TYPE=ENTITY`, when no argument string is provided.

Parameters:

  cp_Par | Standard parameter defining working mode and current row.
  cp_Arguments | Any parameters to pass to `xedb_eda`. If an empty string is provided, the parameter for `xedb_eda` defaults to `/FIELD_TYPE=ENTITY`.

Returns:

  0 | OK
  Else | Return code of `xedb_eda`.

int xprost_action | ( | ) |

Edit-action userexit for project structures.

This userexit covers the following actions:

- 'C'opy, 'I'insert, or 'U'pdate: Checks for write access on parent element by calling `xedb_chk_ide_acc`. If access is granted, the field access for the field `T_PRO_DAT.PROJ_ID` is set to "w" in 'I'nsert mode and to "r" in 'U'pdate mode.
- 'Q'uery: The field access for the field `T_PRO_DAT.PROJ_ID` is set to 'w'.

Parameters:

  par | Standard parameter defining working mode and current row.

Returns:

  0 | OK
  1 | No write access on parent element or other error

int xrel_edt_act | ( | ) |

Sets the field access (or post-field userexit).

Parameters:

  cp_Parameter | Parameter of the calling function.

Returns:

  0 | OK
  <>0 | Error from edit-action userexit
  -1 | Repeated reference not defined
  -2 | Only records with the same reference could work
  -3 | OK from query

int xsml_edt_action | ( | ) |

Edit-action userexit for type classification lists and forms (e.g.

SML1-L or SML1-F).

This userexit covers the following actions:

'I'nsert | Forbids the insert operation in classification forms.
'C'opy | Activates the field default values.

Parameters:

  par | Userexit context.
  cp_Arguments | Defines the fields for which the default value has to be set. Please see also xedb_put_dfv_eda.

Returns:

  0 | OK
  Else | Error

int xsmldf_action | ( | ) |

Edit-action userexit for class definition mask.

This userexit covers the following actions:

'I'nsert
'U'pdate
'C'opy | Checks if the user has 'w'rite access for the current class. If the user has no 'w'rite access, then an error message is displayed and the record cannot be edited.

Parameters:

  par | Userexit context.

Returns:

  0 | OK
  Else | Error, the current user has no 'w'rite access for the class.

int xstare_eda | ( | ) |

Edit-action userexit for the vault definition mask.

Deletes the current menu from the screen, in insert mode.

Parameters:

  cp_Parameter | standard parameter with working mode and current row
  cp_Arguments | none

Returns:

  0 | OK
  Else | Error

int xstate_set_ini_lev | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit that sets the initial progress indicator for new and versionized objects.

In insert and copy mode, sets the progress indicator to the initial progress indicator defined for the lifecycle of the current object. First, the default initial progress indicator is looked up. If no default initial progress indicator is found, the lowest initial progress indicator which is defined for new or versionized objects is taken. If no initial progress indicators are defined at all, the lowest progress indicator of the lifecycle is taken. Additionally, in this case, if the configuration parameter `Entity-VER-LEV` (e.g. `EDB-ARTICLE-VER-LEV`) is set to "RetainPhase", the lowest progress indicator within the current phase of the object is taken. Otherwise, the lowest progress indicator of the whole lifecycle is used.

The userexit uses the fully qualified fieldnames with the origin table to access the fields LEV_IND and CHK_NAME. This is necessary to ensure that the correct fields are used when the userexit is attached to a relation widget. For example, on the item BOM list, the userexit uses the fields T_MASTER_STR.LEV_IND and T_MASTER_STR.CHK_NAME, even if the corresponding fields of the child (T_MASTER_DAT.LEV_IND and T_MASTER_DAT.CHK_NAME) exist in the mask. If one of these fields is missing, the userexit silently returns and remains inactive.

Parameters:

  usxContext | The userexit context.
  param | Reserved.

Returns:

  0 | OK
  Else | Error occurred.

int xstate_set_lev_men | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Creates a menu containing all defined progress indicators and attaches it to any number of fields.

The edit mode in which the menu is attached to the fields can be defined by an additional parameter. The default behavior is to attach the menu to the field LEV_IND in all edit modes.

Parameters:

  usxContext | The userexit context.
  param | Parameter to control the behavior of this userexit. Syntax like: "/FIELDS=field1[,field2[,...]][/UPDATE][/INSERT][/QUERY]" with possible arguments:
  FIELDS | field1[,field2[...]]
  of the fields to which the menu will be attached. If this parameter is not given, the menu is attached to the field "LEV_IND"

int xtrf_eda | ( | ) |

Clears the reference number field of transformation record in copy mode.

This userexit deals with the following actions:

'C'opy | Clears reference number field of transformation record.

Parameters:

  cp_Parameter | Standard parameter with working mode and current row.

Returns:

  0 | OK
  1 | Error

int xtxt_ins_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit checks if the main form is open.

Parameters:

  cpParameter | Standard parameter with working mode and current row.
  cpArguments | Parameter to control the behavior of this function. Not currently used.

Returns:

  0 | OK
  Else | Error

int xtxt_ins_sel_pre_edt | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit for Text-Instance-Editor which hides the fields, which do not matche to the selected Text-Template.

Parameters:

  ctx | Field userexit context.
  param | Reserved parameter for the pre-field userexit.

Returns:

  0 | Ok.
  Else | Error

int xtxt_tpl_eda | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Checks if the main form is open.

Parameters:

  cpParameter | Standard parameter with working mode and current row.
  cpArguments | Parameter to control the behavior of this function. Not currently used.

Returns:

  0 | OK
  Else | Error

int xtyp_eda | ( | ) |

Edit-action userexit for type widget.

Calls the standard edit-action userexit `xedb_eda` with the parameter `/FIELD_TYPE=ENTITY` or the given argument string.

This userexit covers the following actions: || 'C'opy | Clear DataView's id attributes. ]

Using this trigger as edit-action trigger on a type widget ensures a 1:1 relation of master record and type record. Hence copying a type record doesn't assign the newly created type record to the same master record.

Parameters:

  cp_Par | Standard parameter with working mode and current row.
  cp_Argument | Argument string to define for which field(s) the default value shall be set. Please refer to the userexit `xedb_put_dfv_eda`'.

Returns:

  0 | OK
  Else | return code of xedb_eda

See also:
  xedb_eda, xtyp_del_mst

int xunit_action | ( | ) |

Deletes the active menu from the screen when it is in insert mode (parameter[0] = I).

Parameters:

  cp_Parameter | action parameter

Returns:

  0 | OK
  Else | Error

int xutil_cch_upd_mas_joi | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit action userexit, updates fields which depend on the mask join of the current mask.

This userexit deals with the following actions:

'I'nsert | Updates mask join dependent fields.
'C'opy | Updates mask join dependent fields.
'U'pdate | Updates mask join dependent fields.

Parameters:

  context | Action userexit context.
  param | Reserved.

Returns:

  0 | OK
  1 | Error

int xutil_chk_ins | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit-action userexit to limit the parallel inserts into a mask.

The userexit could be used to limit the parallelly inserted (copied) rows within the mask.

Note:
  Action mode is not checked, so be aware to call it only in insert/copy mode.

Parameters:

  ctx | Action userexit context.
  param | Parameter to control the behavior of this function. Syntax is: "/COUNT=<count> [/MSG=<msg>]" With possible arguments:
  COUNT | count | Maximum parallel insert count.
  MSG | msg | Message which should be displayed if the count is reached.

Returns:

  0 | Insert allowed.
  1 | No further insert is allowed at this time.

int xutil_exec_sto_proc | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Edit action userexit, executes a database stored procedure.

This trigger deals with the following actions:

'I'nsert | Executes stored procedure.
'C'opy | Executes stored procedure.
'U'pdate | Executes stored procedure.
'T'emporary delete | Executes stored procedure.
'D'elete | Executes stored procedure.

Parameters:

  context | Userexit context
  param | Parameter to control the behavior of this function. Syntax like: "Name_of_stored_procedure"

Returns:

  0 | Success
  Else | Error

int xutil_set_wdg_buf | ( | const char * | param1,
|  | const char * | param2
| ) |  |

Sets a key value pair into the widget buffer.

This userexit deals with all edit action types.

Note:
  String "key_name=key_value" will be added to the widget buffer.

Parameters:

  cpParameter | Action userexit context.
  cpArguments | Parameter to control the behavior of this function. Syntax is: "/NAME=<key_name> /VALUE=<key_value>" With possible arguments:
  NAME | key_name | Widget buffer key name.
  VALUE | key_value | Widget buffer key value.

Returns:

  0 | OK

int xvar_edt_action | ( | ) |

Edit-action userexit to check the user access to the variant list.

This userexit covers the following actions:

'I'nsert | If the user does not have manager rights, then check 'w'rite access for the join table fields.
'C'opy | Check user manager right and the access to join fields. Set field default values.

Parameters:

  par | Userexit context.
  cp_Arguments | Userexit parameter to define field(s) in which the default value must be set.

Returns:

  0 | OK
  Else | Error

See also:
  xedb_put_dfv_eda

int xvardf_vfl_act | ( | ) |

Edit-action userexit for variants (e.g.

mask EDB-ART-VAR-SLI or EDB-ART-VAR-SFR).

This userexit covers the following actions:

'I'nsert
'U'pdate
'C'opy | Checks the user access to the variant record.

Parameters:

  cp_Parameter | Userexit context.
  cp_Arguments | Userexit parameter, reserved.

Returns:

  0 | OK
  Else | Error

int zag_fld_put_dfv_eda | ( | ) |

Edit-action-USX to set the default values of some fields.

This userexit deals with the following actions:

'C'opy | Copy the defaults values for fields (depending on userexit parameter).

Parameters:

  cp_Par | Standard parameter with working mode and current row.
  cpArguments | Parameter to control the behavior of this function. Syntax like: "{/NAME=<fieldlist>] | /FIELD_TYPE={ALL_JOIN|ALL|ENTITY}}" With possible arguments:
  NAME | fieldlist | Comma separated field name list.
  FIELD_TYPE | ALL_JOIN | Set default for join fields.
  | ALL | Set default for all fields.
  | ENTITY | Set default for entity fields.

Returns:

  0 | OK
  1 | Error

Copyright © 2007-2012, Oracle and/or its affiliates.