# Userexits

Functions

## Post-Field userexits
[Field userexits]

### Functions
int | edb_ief_calc_pos_pof ()
| Calculates the end position of the field from the start position and the EDB field position.
int | tol_post_fld ()
| Post-field userexit to calculate fields of the current mask.
int | tpr_lpad_pof ()
| Post-field userexit for fields of type string (character) that right-justifies char fields by inserting leading blanks.
int | xatt_calc_formula ()
| calculates a formula within within the classification list.
int | xatt_wid_pof ()
int | xchg_set_def_ewo (const char *param, const char *ignore)
int | xchg_set_def_ews (const char *param, const char *ignore)
int | xcls_chk_set_pof (const char *param, const char *ignore)
int | xcls_chk_typ_pof (const char *param, const char *ignore)
int | xcls_clr_set_pof (const char *param, const char *ignore)
int | xcnf_cps_rul_srt_pof (const char *param, const char *ignore)
int | xcnf_ord_cmp_pof (const char *param, const char *ignore)
int | xcnf_ord_edb_prd_dat_pof (const char *param, const char *ignore)
int | xcnf_ord_edb_vie_pof (const char *param, const char *ignore)
int | xcnf_ord_fam_id_pof (const char *param, const char *ignore)
int | xcnf_ord_mod_id_pof (const char *param, const char *ignore)
int | xcnf_ord_org_code_pof (const char *param, const char *ignore)
int | xcnf_ord_spc_rst_vie_pof (const char *param, const char *ignore)
int | xcnf_ord_var_id_pof (const char *param, const char *ignore)
int | xcnf_spc_chk_chr (const char *param, const char *ignore)
int | xcpa_step_int_id_pof (const char *param, const char *ignore)
int | xcps_alt_grp_pof (const char *param, const char *ignore)
int | xcps_alt_typ_pof (const char *param, const char *ignore)
int | xcps_elm_fnc_pof (const char *param, const char *ignore)
int | xcps_elm_pos_typ_pof (const char *param, const char *ignore)
int | xcps_flt_nam_pof (const char *param, const char *ignore)
int | xcps_flt_val_pof (const char *param, const char *ignore)
int | xcps_prd_sel_rec_pof (const char *param, const char *ignore)
int | xcps_prl_chk_fld_pof (const char *param, const char *ignore)
int | xcps_sol_prd_pof (const char *param, const char *ignore)
int | xcps_sol_upd_id (const char *param, const char *ignore)
int | xctx_set_ctx (const char *param, const char *ignore)
int | xdalobj_dlg_sel_rec_pof (const char *param, const char *ignore)
int | xdfv_lng_pof (const char *param, const char *ignore)
int | xdfv_set_val_pof (const char *param, const char *ignore)
int | xedb_agg_max_pnr ()
| Determines a new position number for the current relation in aggregate widgets.
int | xedb_cch_get_rec ()
| Post-field userexit.
int | xedb_get_rec ()
| Post-field userexit to search all master records for the current field content when creating a new record in a relation list.
int | xedb_rpl_id_pof ()
| Post-field userexit for the ID field in structure widgets.
int | xedb_vie_set_prd ()
| Sets internal CRM variables.
int | xewm_pac_pst_fld ()
| Postfield userexit at the field T_PAC_DAT.PAC_ID.
int | xknl_bom_uni_ich (const char *param, const char *ignore)
int | xknl_chk_itr_uni_chg (const char *param, const char *ignore)
int | xknl_set_def_uni (const char *param, const char *ignore)
int | xknl_set_qua_cal (const char *param, const char *ignore)
int | xknl_set_uni_des (const char *param, const char *ignore)
int | xpac_mul_pst_fld ()
| Post-field userexit at the field C_PAC_LEVEL Checks if the first character of the field entry is valid for menu EDB-PAC-MUL-CHO-ENT.
int | xsmlc_fld ()
| Post-field userexit for the class code field in ATC classification lists.
int | xstate_chk_usr_grp ()
| Checks if user or group entry is correct (transition definition).
int | xstr_post_chk_fld (const char *param, const char *ignore)
int | xtask_chk_abs ()
| Checks if inserted role is an abstract role.
int | xtxt_cpy_gls_ter (const char *param, const char *ignore)
int | xtxt_ctg_men_pof (const char *param, const char *ignore)
int | xtxt_ine_plh_chk_pof (const char *param, const char *ignore)
int | xtxt_ins_fin_pof (const char *param, const char *ignore)
int | xtxt_ins_plh_chk_pof (const char *param, const char *ignore)
int | xtxt_ins_plh_pof (const char *param, const char *ignore)
int | xtxt_ins_tmp_nam_pof (const char *param, const char *ignore)
int | xtxt_pos_typ_pof (const char *param, const char *ignore)
int | xtxt_set_fld_acc_pof (const char *param, const char *ignore)
int | xtxt_tpl_plh_pof (const char *param, const char *ignore)
int | xutil_chk_typ_pof (const char *param, const char *ignore)
int | xutil_upd_cns_fld (const char *param, const char *ignore)
int | zag_dat_cpl_dat_pof ()
| Completes data value in current field based on passed MIN/MAX arguments.
int | zag_dat_cpl_tim_pof ()
| Completes time value in current field.
int | zag_fld_cch_get_rec ()
| Post-field userexit to search all master records for the current field content when creating a new record in a relation list.
int | zag_fld_clr_cns ()
| Deletes reference field values from constraint if user clears field manually.

### Function Documentation

int edb_ief_calc_pos_pof | ( | ) |

Calculates the end position of the field from the start position and the EDB field position.

Returns:

  0 | OK

int tol_post_fld | ( | ) |

Post-field userexit to calculate fields of the current mask.

This userexit might be used to realize functions similar to that of a simple spread sheet system.

int tpr_lpad_pof | ( | ) |

Post-field userexit for fields of type string (character) that right-justifies char fields by inserting leading blanks.

Returns:

  0 | OK
  Else | Error

int xatt_calc_formula | ( | ) |

calculates a formula within within the classification list.

This function calculates the value of an attribute with a formula within the classification list. The formula is composed of operands and operators. Operand can be any integer or float number or an attribute id (EDB_ID column) put between {}, for example {324} Operator:

- add '+'
- subtract '-'
- multiply '*'
- divide '/'

Parameters:

  cpPar | Attribute id and formula separated by blank

string)

Example:

         Define formula for an attribute value in attribute pool. Then
         you can choose the formula from attribute menu for this
         attribute in classification list, the result is calculated
         and writen in the attribute field.
         e.g. {23}*200 means attribute with EDB_ID=23 will be
         multiplied by 200
         e.g. {1}+{2} means attribute with id 1 (field name is C_1)
         plus attribute with id

Returns:

  0 | Ok.
  -1 | Error

int xatt_wid_pof | ( | ) |

This userexit deals with the following actions:

'I'nsert 'C'opy or 'U'pdate | Checks if the visible width is greater than the maximal width of the attribute

E.g. if the attribute is defined with the field type S20 then the attribute width is not allowed to be greater than 20.

Parameters:

  param | - Reserved parameter, not used yet.

Returns:

  0 | OK
  1 | visible attribute width is greater than absolute attribute width

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

Post-field userexit to set the default Work Order for subsequent change operations.

This userexit reads the value of the Work Order's EDB_ID attribute from the currently active mask. It then sets the default EDB-CHG-CUR-EWO to this value and the default EDB-CHG-CUR-EWO-ELEMID to the Work Order's ELEM_ID attribute value (the ELEM_ID is visible in the GUI).

Setting the default Work Order resets the default change operation automatically if the default Work Order does not match the current one.

If a single non-released Work Set is assigned to the Work Order, this Work Set will be used as default Work Set as well. Otherwise the default Work Set will be reset.

Parameters:

  context | The field context of the userexit
  param | Reserved

Returns:

  0 | OK
  Else | Error

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

Post-field userexit to set the default Work Set for subsequent change operations.

This userexit reads the value of the Work Set's POS_NO attribute and the value of the Work Order's EDB_ID attribute from the currently active mask. It then determines the corresponding EDB_ID of the Work Set via EPQ and updates the Work Set's EBD_ID mask field accordingly. Finally the default EDB-CHG-CUR-SET is set to the Work Set's EDB_ID value and the default EDB-CHG-CUR-SET-POSNO is set to the Work Set's POS_NO value (the POS_NO is visible in the GUI).

If the Work Set's POS_NO field has no write access, the userexits does neither write to any field nor does it set the default Work Set.

Parameters:

  context | The field context of the userexit
  param | Reserved

Returns:

  0 | OK
  Else | Error

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

Post-field userexit for attribute set field in class attributes mask.

Checks if the given primary attribute set is valid and if the attribute is assigned to this set. It also writes the corespondent set id into the set reference field.

Parameters:

  cpArguments | userexit parameter, not yet used.

Returns:

  0 | Success |  | Else | Error

  Post field userexit to check valid set and attribute assignment Post field userexit for attribute set field in class attributes mask. Checks if the given primary attribute set is valid and if the attribute is assigned to this set. It also writes the coresponding set id into the set reference field.

Parameters:

  cpArguments | Reserved userexit parameter, not used yet.

Returns:

  0 | Success |  | Else | Error

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

Post -field userexit for T_GRP_CLA.C_CHK_TYP in the class attribute refine list.

It prohibits the 'M' type for logic attributes.

Parameters:

  cpArguments | Reserved userexit parameter, not used yet.

Returns:

  0 | Success |  | Else | Error

  public field

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

Post-field userexit for the field T_CLA_DAT.C_TITLE in the class attribute refine list to clear the attribute set reference.

Parameters:

  cpArguments | Reserved userexit parameter, not yet used.

Returns:

  0 | Success |  | Else | Error

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

Post-field userexit for rule field EDB_RULE_SHORT.

This userexit is used on the field T_CPS_RUL_DAT.EDB_RULE_SHORT to check the syntax of the rule when the field is modified. When the syntax is wrong, a message is displayed.

Parameters:

  param | Post-field userexit parameter ,(reserved).

Returns:

  0 | OK
  1 | Rule syntax error

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

Post-field userexit for selecting component.

Parameters:

  param | Standard parameter (reserved).

Returns:

  0 | OK
  1 | Error

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

Post-field userexit for order field T_ORD_DAT.EDB_PROD_DATE in configuration order widgets.

This userexit is used on the field T_ORD_DAT.EDB_PROD_DATE to set the access of the field to "write" if the field T_ORD_DAT.EDB_VIEW was set to production view.

Parameters:

  param | Post-field userexit parameter, (reserved).

Returns:

  0 | OK
  1 | Error

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

Post-field userexit for the field T_ORD_DAT.EDB_VIEW in configuration order widgets.

This userexit is used on the field T_ORD_DAT.EDB_VIEW to clear the content of the field T_ORD_DAT.EDB_PROD_DATE when the version view is development or set the current date when the version view is production.

Parameters:

  param | Standard userexit parameter (reserved).

Returns:

  0 | OK
  1 | Error

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

Post-field userexit for field V_CNF_GRP_VAR.EDB_FAMILY_ID in configuration order widgets.

This userexit is used on the field V_CNF_GRP_VAR.EDB_FAMILY_ID to clear the content of the next field(s) when changing the content of the current field.
When changing the content of V_CNF_GRP_VAR.EDB_FAMILY_ID the content of the fields V_CNF_GRP_VAR.EDB_VARIANT_ID and V_CNF_VAR_MOD.EDB_MODEL_ID will be cleared.

Parameters:

  param | Post-field userexit parameter (reserved).

Returns:

  0 | OK
  1 | Error

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

Post-field userexit for field V_CNF_VAR_MOD.EDB_MODEL_ID in configuration order widgets.

This userexit is used on the field V_CNF_VAR_MOD.EDB_MODEL_ID to call the function xlut_set_men_pof().

Parameters:

  param | Post-field userexit parameter (reserved).

Returns:

  0 | OK
  1 | Error

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

Post-field userexit for order field V_CNF_GRP_VAR.EDB_ORG_CODE in configuration order widgets.

This userexit is used on the field V_CNF_GRP_VAR.EDB_ORG_CODE to clear the content of the next field(s) when changing the content of the current field. When changing the content of V_CNF_GRP_VAR.EDB_ORG_CODE the content of the fields V_CNF_GRP_VAR.EDB_FAMILY_ID, V_CNF_GRP_VAR.EDB_VARIANT_ID and V_CNF_VAR_MOD.EDB_MODEL_ID will be cleared.

Parameters:

  param | Post-field userexit parameter, (reserved)

Returns:

  0 | OK
  1 | Error

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

Reset the view in the specification postfield usx the view which was set in the prefield usx setOrderViewPrf.

Resets the view in the specification post-field userexit which was set in the pre-field userexit xcnf_ord_spc_set_vie_prf.

Parameters:

  param | Standard userexit parameter (reserved).

Returns:

  0 | OK
  1 | Error

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

Post-field userexit for field V_CNF_GRP_VAR.EDB_VARIANT_ID in configuration order widgets.

This userexit is used on the field V_CNF_GRP_VAR.EDB_VARIANT_ID to clear the contents of the next field(s) when changing the contents of the current field.
When changing the contents of V_CNF_GRP_VAR.EDB_VARIANT_ID the contents of the field V_CNF_VAR_MOD.EDB_MODEL_ID will be cleared.

Parameters:

  param | Post-field userexit parameter (reserved).

Returns:

  0 | OK
  1 | Error

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

This function is a listener for requests sent by the axalant process.

The following requests are defined so far:

Mod_REQUEST_START - axalant wants to start the module Mod_REQUEST_STOP - axalant wants to stop the module Mod_REQUEST_EXIT - axalant wants to terminate the module Mod_REQUEST_SHUTDOWN - axalant wants to terminate

If the module does not support on-demand termination, it may reject the EXIT requests (for example to keep its userexits alive).

If the function receives an unknown request, it should return Mod_ACCEPT_REQUEST to be compatible with future requests.

Parameters:

  eRequest | request sent by the axalant process

Returns:
  Mod_ACCEPT_REQUEST - Request accepted Mod_REJECT_REQUEST - Request rejected

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

Post-field userexit for field T_ORG_DAT.STEP_INT_ID in Cooperation Partner widgets.

This Post-field userexit can only be called on the field T_ORG_DAT.STEP_INT_ID in the widgets for Cooperation Partner otherwise you get an error message. This userexit checks the current field value if exist already in the database after leaving the field. When inserting more than one field at the same time with the same value this will be checked in the Pre-action userexit xcpa_pra() before the record is stored in the database.

'I'nsert | Checks if the current value already exists in the database.
'U'pdate | Sets write access on the field T_ORG_DAT.STEP_INT_ID.

Parameters:

  param | Additional argument string (reserved).

Returns:

  0 | OK
  1 | Record with value already exist.

public post-action

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

Post-field userexit for product variant field in variant mask (modular BOM solutions).

Sets the correct SML_NUM for the selected product variant (T_GROUP_DAT.CLASS_CODE).

Parameters:

  context | Field userexit context
  param | Reserved

Returns:

  0 | OK
  Else | Error

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

Post-field userexit for variant masks (modular BOM solutions).

Assigns the "EDB-NULL-ITEM" item to the variant if the EDB_POS_TYPE field value marks the variant as a text position.

Parameters:

  context | Field userexit context
  param | Reserved

Returns:

  0 | OK
  Else | Error

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

Post-field userexit to check if field value is one of the menu values.

Parameters:

  context | Field userexit context
  param | Parameter to control the behavior of this function. Syntax like: "[/Columns=Column[,Column]*]" With possible arguments:
  Columns | fields | Comma separated list of T_CPS_FNC_DAT fields

Returns:

  0 | Ok
  EDB_CPS_INTERNAL | No widget
  EDB_CPS_NO_ACT_ROW | No current row

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

Post-field userexit for EDB_POS_TYPE to set access to dependent fields like EDB_UNIT.

If the position type is a text position then set the access "w" to UNIT and "m" to EDB_TXT_TEMPLATE_REF.

Parameters:

  context | Field userexit context
  param | Reserved

Returns:

  0 | Ok
  Else | Error

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

Post-field userexit for the attribute name field in filter list.

Sets the mandatory fields if user inserted value directly instead of using field menu.

Parameters:

  context | Field userexit context
  param | Reserved

Returns:

  0 | OK
  Else | Error

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

Post-field userexit for the attribute value field in filter list.

Checks the value for data type fields and in update mode copies the current value of the attribute field to all other language fields of this attribute (this is used to simulate single language fields).

Parameters:

  context | Field userexit context
  param | Reserved

Returns:

  0 | OK
  Else | Error

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

Post-field userexit to choose a product.

Searches the entered record in the specified entity (EDB-ARTICLE). If the record was found, the userexit updates the mask fields with the values of the found record, otherwise the userexit opens the select widget.

Parameters:

  context | Field userexit context
  param | Reserved

Returns:

  0 | OK
  Else | Error

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

Post-field userexit for parallel structure - product component widgets.

If widget buffer does not contain the key "v_name" then the current value of T_CPS_VIE_LUT. SHORT_TEXT is stored in the widget buffer else checks if the buffer value and row value for this field are different. If different then the buffer value is updated.

Parameters:

  context | Field userexit context
  param | Reserved

Returns:

  0 | OK
  1 | Error

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

Post-field userexit for solution masks.

Updates the reference of the solution to the effectivity based object. The EDB_ID of the effectivity based object will be stored into the field EDB_EFF_REF of the solutiuon record. Creates the effectivity based object for the product if it does not exists.

Parameters:

  context | Field userexit context
  param | Reserved

Returns:

  0 | OK
  Else | Error

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

Post-field userexit for solution masks.

Updates the EDB_ID of the object whose attribute has been changed. If a corresponding EDB_ID column exists in the mask, then get the EDB_ID value from database and write it into mask field.

Parameters:

  context | Field userexit context
  param | Parameter to control the behavior of this function. Syntax is: "[/CLR]" With possible arguments:
  CLR | Clears the reference if the edited field is empty.

Returns:

  0 | OK
  Else | Error

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

Menu userexit to set the currently effective context.

A module-static variable will be set to save the value of the context. Additionally the DataView default 'EDB-CTX' will be set to this value.

Note:
  If a NULL pointer or an empty string is passed as parameter, the value to be set will be taken from the current field (if existing). If a dash ("-") is passed for input parameter 'cp_Context', no effective context is set. To retrieve the id of the current context, read the value of the DataView default 'EDB-CTX'.

Parameters:

  ctx | Menu userexit context.
  param | Parameter to control the behavior of this function. Syntax is: "<contextId>" With possible arguments:
  contextId | ID of the context to be set.

Returns:

  0 | OK
  Else | Error

See also:
  xctx_set_nxt

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

The post-field to fill the corresponding fields of the found record.

The post-field userexit is similar to the userexit xdalobj_dlg_sel_rec(). The userexit uses the entered field content to find the matching record in the hidden selection mask. If no or more than one record matches the entered field content the userexit shows an error message and the selection mask is displayed. If the record was found, the userexit updates the fields in the edited mask with the values of this record.

Parameters:

  context | The userexit context.
  param | Parameter to control the behavior of this function. Syntax: "/SRC_ID=<fld> /DST_ID=<fld> /ENTITY=<ent> [/SRC_TAB=<tab>] [/DST_TAB=<tab>] [/LIST=<mask>]" With possible arguments:
  SRC_ID | field name | The field name of the key field in the selection mask.
  DST_ID | field name | The field name of the key field in the edited mask.
  ENTITY | entity name | The entity name for the selection mask.
  LIST | mask name | If the option is chosen, the specified mask will be used as selection mask.
  |  | If the option is not chosen, the standard mask of the entity will be used.
  SRC_TAB | table name | If the option is chosen the table name is used for the field mapping for the fields in the edited mask.
  |  | If the option is not chosen, the field names in the edited widget are used.
  DST_TAB | table name | If the option is chosen the table name is used for the field mapping for the fields in the selection mask.
  |  | If the option is not chosen, the field names in the selection mask are used.

Returns:

  0 | OK
  Else | Error

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

Post-field userexit for system language field in setup mask.

If the field content has changed, a message is displayed to inform the user that the change is valid after restart.

Note:
  This userexit is only used for the system language field, the user language is changed immediately.

Parameters:

  ctx | Field userexit context.
  param | Reserved.

Returns:

  0 | OK

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

Post-field userexit for setup forms to set the value of a default in the widget buffer.

The userexit `xdfv_wri_def_val()` writes the values from the widget buffer into the corresponding defaults. If a menu for choosing the current field exists, the parameter of the matching menu entry is used to set the value for the default. If no field menu exists, the entered value itself will be set as default value.

This userexit must be defined as post-field userexit. It is not permitted to call this userexit from within another function (otherwise the existing values will not be displayed when opening the setup form).

Note:
  Cascading menus are not supported.

Parameters:

  ctx | Field userexit context.
  param | Parameter to control the behavior of this function. Syntax is: "DEFAULT_NAME:<typ>" With possible arguments:
  DEFAULT_NAME | typ | Type of default. Possible values are: S - String I - Integer F - Float D - Date (default itself is of type 'S') P - Production date (may be "@NOW" too)

Returns:

  0 | OK
  1 | Error

Example:
  `Post-Field userexit: xdfv_set_val_pof BG_COLOR:I Field menu: Selection | Text | Parameter ----------|---------|---------- BGC_1 | Yellow | 1 BGC_2 | Green | 2 BGC_3 | Blue | 3`

If "Green" has been entered (or chosen from the menu), 2 will be set as integer value for the default "BG_COLOR". <endcode>

int xedb_agg_max_pnr | ( | ) |

Determines a new position number for the current relation in aggregate widgets.

Post-field userexit for master field in aggregate lists to determine a new maximum position/sequence number for current relation.

Note:
  The maximum position number is determined in the refine relation widget and not in the current widget. If jointable.EDB_ID field exists in the mask, then it is used to check current record, if not then current field is used.

Parameters:

  cpParameter | Reserved.

Returns:

  0 | OK
  Else | Error

See also:
  xedb_max_pnr

int xedb_cch_get_rec | ( | ) |

Post-field userexit.

Deprecated:
  Use zag_fld_cch_get_rec instead.

Returns:

  0 | OK

See also:
  zag_fld_cch_get_rec

int xedb_get_rec | ( | ) |

Post-field userexit to search all master records for the current field content when creating a new record in a relation list.

When only one record was found, the data from the master record is written into the master fields of the relation record. Otherwise a selection menu is displayed. If no record was found, an error message is issued and the field cannot be quit. To quit the field you have to delete the field value.

Note:
  If a master data record, which will be assigned, is found, the access of the field is set to 'r' (read), otherwise the access is set to 'w' (write) and the field can not be left.

Returns:

  0 | OK
  Else | Return code of cch_get_rec.

See also:
  cch_get_rec

int xedb_rpl_id_pof | ( | ) |

Post-field userexit for the ID field in structure widgets.

Replaces in 'U'pdate mode a position in the structure with another master record chosen by the user. The configuration parameter 'Entity-RPL' must be set to value REPLACE_POS (for example 'EDB-ARTICLE-RPL' - value REPLACE_POS).

Note:
  Works only for refine widgets in 'U'pdate mode.

Parameters:

  cp_IwfPar | Parameter to open aggregate list. Syntax like: "[<usx_par>]" With possible arguments:
  usx_par | Parameter for dal_iwf_lis_ent(e.g. EDB-ARTICLE for items) If NULL then the current entity name is used.

Returns:

  0 | OK
  1 | Error

int xedb_vie_set_prd | ( | ) |

Sets internal CRM variables.

Post-field userexit to read the value of default EDB-VER-PROD and set the internal production date variable to this value.

Parameters:

  cp_Arguments | Reserved.

Returns:

  0 | Ok.

See also:
  xedb_set_vie

int xewm_pac_pst_fld | ( | ) |

Postfield userexit at the field T_PAC_DAT.PAC_ID.

If the content of the field is empty, the field XXX.PAC_REF has to be cleared.

Returns:

  0 | OK
  else | Error

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

Post-field for unit field.

Checks if the field value of EDB_UNIT has changed (dirty flag is set) and updates the field with the newly calculated quantity.

Parameters:

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

Returns:

  0 | Ok.
  otherwise | Error

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

Checks if the field UNIT of the BVB-ARTICLE has changed, and prints a message.

Parameters:

  context | Context of the userexit
  param | Standard parameter with working mode and current row

Returns:

  0 | OK
  1 | Error (error in post field userexit of current field (if exist.))

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

Sets the default unit of the item master in the Unit field.

Parameters:

  context | Action userexit context
  param | The usual user defined userexit parameter.

Returns:

  0 | Ok.
  Else | Error

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

Post-field userexit for quantity field.

Checks if the field-value of QUANTITY_BOM has been changed (dirty flag is set) and updates the field value with the newly calculated nominal quantity.

Parameters:

  context | Context of the userexit
  param | Standard parameter (reserved)

Returns:

  0 | OK
  Else | Error

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

Sets the description according to the unit.

Parameters:

  context | Context of the userexit
  param | Standard parameter with working mode and current row

Returns:

  0 | OK
  Else | Error

Sets the description according to the unit.

int xpac_mul_pst_fld | ( | ) |

Post-field userexit at the field C_PAC_LEVEL Checks if the first character of the field entry is valid for menu EDB-PAC-MUL-CHO-ENT.

Returns:

  0 | No entry or correct entry
  1 | Entry does not correspond to any menu selection

int xsmlc_fld | ( | ) |

Post-field userexit for the class code field in ATC classification lists.

This userexit deals with the following actions:

'I'nsert | If the class is not a container class, the field title and access are changed. Displays an error message for container classes.

Returns:

  0 | OK
  Else | Error

int xstate_chk_usr_grp | ( | ) |

Checks if user or group entry is correct (transition definition).

Note:
  If field value is "0" then check is skipped.

Returns:

  0 | Valid user/group
  1 | Invalid user/group

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

Post-field userexit for the field '[tablename].CHK_NAME' on relation records.

Checks the field contents and determines the new level indicator if the field has been changed.

Parameters:

  usxContext | The userexit context.
  param | Reserved.

Returns:

  0 | OK
  Else | Error occurred.

int xtask_chk_abs | ( | ) |

Checks if inserted role is an abstract role.

If role is an abstract role then insert is not allowed.

Parameters:

  cp_Par | Reserved.

Returns:

  0 | Non-abstract role.
  XROLE_ABSTRACT_ROLE | Abstract role.

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

Copies the glossary term corrsponding to the glossary ID in field EDB_TXT_GLS_REF_[x] to field T_TXT_DUM_PLH.EDB_TXT_PLH_[x] of the current mask.

Note:
  Lastly, the post-field-userexit of the field T_TXT_DUM_PLH.EDB_TXT_PLH_[x] is fired.

Parameters:

  cpParameter | Parameter to control the behavior of this function. Syntax is: "/FIELDID=<field_x>" With possible arguments:
  FIELDID | field_x | x defines the constraint-(id) between the fields EDB_TXT_GLS_REF_[x] and T_TXT_DUM_PLH.EDB_TXT_PLH_[x].

Returns:

  0 | OK
  Else | Error

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

Copies the EDB_ID of the selected category in the default category field of the template/glossary and shows the main category name immediately.

Parameters:

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

Returns:

  0 | Always OK

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

Checks the value type of the entered value in the current field in the Text-Instance-Editor.

Parameters:

  ctx | Field userexit context.
  param | Parameter to control the behavior of this function. Syntax is: "/FIELDID" With possible arguments:
  FIELDID | The field-id of the current field. This is necessary, to create the relation to the type definition regarding this field.

Returns:

  0 | Ok.
  Else | Error

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

Post-field userexit to check if it is a valid text component and to copy the text value and refernce ID.

This userexit is used in general in combination with the pre-field userexit xtxt_fin_prf. There is a special check for classification attribute values. If the attribute is a single value attribute then the multi language field is invisible and the single value (T_AVL_DAT.C_EXACT_VALUE_SL) field is visible. Therefore, the value has to be copied into the visible field! If no value is in the current field the text and the reference field are also cleared. Checks the text field name so that the userexit could be used also if no text field must be copied like in the CPS-Structure list.

Parameters:

  ctx | Context of the userexit
  param | Parameter to control the behavior of this function. Not currently used.

Returns:

  0 | OK
  Else | Error

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

Handle multi-lingual placeholder values.

Checks for multi-language mask. Gets the current (actual language) row of the current mask. Checks the data value depending on the data type. Checks for glossary entry. Sets the cursor on the glossary field. Checks for data type Float, Integer, Logic. If data type equals Float, Integer, Logic copies the current value in the multi-lingual fields.

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_plh_pof | ( | const char * | param,
|  | const char * | ignore
| ) |  |

Updates the field which shows the Text-Instance-Text EDB_TXT_INST_[LANG] with the currently entered placeholder values.

Parameters:

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

Returns:

  0 | Ok.
  Else | Error

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

Updates the Text-Instance-Editor with the newly selected Text-Template definitions.

Parameters:

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

Returns:

  0 | Ok.
  Else | Error

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

Handles text position type and EDB_NULL_ITEM in T_MASTER_STR.

Checks, if the field "PART_ID" is in mask: |  |
TRUE | If current field value equals "T" (Text): |  |
| TRUE | Check, if the EDB_NULL_ITEM exists: |
|  | TRUE | Set value of PART_ID to EDB_NULL_ITEM.
|  | FALSE | Create EDB_NULL_ITEM.
|  | Set value of QUANTITY_BOM and EDB_UNIT to ''. |
|  | Set access of QUANTITY_BOM and EDB_UNIT to r(ead). |
| If current field value does not equals "T" (Text) |  |
| and T_MASTER_DAT.EDB_ID equals '-1' (EDB_NULL_ITEM): |  |
| TRUE | Write message "EDB-TXT-TYP-TXT". |
|  | Return 1 |
| ELSE: | Set menu type of field PART_ID to 'W' |
|  | Set access of QUANTITY_BOM and EDB_UNIT to r(ead) |

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_set_fld_acc_pof | ( | const char * | param,
|  | const char * | ignore
| ) |  |

Post-field userexit to restore the field access that was set by the pre-field userexit xtxt_set_fld_acc_prf.

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

References: xtxt_set_fld_acc_prf

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

Checks the type and format of a place holder.

Note:
  Sets a default when no type or format is entered
  Following types are possible:

  I1-I18 | Default:I10
  S1-S100 | Default:S20
  F1.1-F38.19 | Default:F10.3
  D | val2 |
  L | val2 |

Parameters:

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

Returns:

  0 | OK
  Else | Error

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

Checks if the current field value has the correct field datatype format.

Note:
  For float and money fields, the value of the field is formatted if necessary.

Parameters:

  cpParameter | Parameter to control the behavior of this function. Syntax like: "/FMT=format | /FMTFLD=fieldname" With possible arguments:
  FMT | format | Field datatype format.
  FMTFLD | fieldname | Field which contains datatype format.

Returns:

  0 | Success
  Else | Error

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

Updates mask fields which value depend on other constraint fields.

The dependency can either be defined explicitly (using both the /KEY and /OTHERKEY parameter, or can be determined from the constraints defined in the repository (in which case the OTHERKEY parameter must be omitted). Usually it is better to only use the /KEY parameter and let the system retrieve the other key by querying the constraints, but when no constraint is defined in the repository (for example when a mask join is used) the other key must be defined by the /OTHERKEY parameter.

Parameters:

  cpParameter | Parameter to control the behavior of this function. Syntax like: "/KEY1=key [/KEY2=otherkey] [/VISIBLE]" With possible arguments:
  KEY1 | key | The field which contains the foreign key of the relationship, usually the field which has been edited.
  KEY2 | otherkey | Optional parameter to define the field which contains the primary key of the depending table. If this parameter is omitted, the other key is determined from the repository.
  VISIBLE |  | If this parameter is passed then only fields which are visible are updated.

Returns:

  0 | Success
  1 | Error

int zag_dat_cpl_dat_pof | ( | ) |

Completes data value in current field based on passed MIN/MAX arguments.

Parameters:

  cpParameter | Parameter to control the behavior of this function. Syntax like: "/MIN=min_value /MAX=max_value" with possible arguments:
  /MIN | min_value | Minimum date value in format "YYYY-MM-DD HH:MI:SS" or "@TODAY".
  /MAX | max_value | Maximum date value in format "YYYY-MM-DD HH:MI:SS" or "@TODAY".

Returns:

  0 | Success
  -1 | Date cannot be completed.

int zag_dat_cpl_tim_pof | ( | ) |

Completes time value in current field.

Parameters:

  cpParameter | Currently not available.

Returns:

  0 | Success

int zag_fld_cch_get_rec | ( | ) |

Post-field userexit to search all master records for the current field content when creating a new record in a relation list.

When only one record was found, the data from the master record is written into the master fields of the relation record. Otherwise a selection menu is displayed. When switching to another mask, the relation record to the selected master record is created. If no record was found, an error message is issued and the field cannot be quit (exception for empty field).

Note:
  Only valid in insert mode. Any special character allowed in standard search mode can be used. If the field is write protected in the relation list, because the master fields have only read access (set), switch write access on with the userexit cch_fld_ins() before this userexit is called.

Returns:

  0 | OK
  1 | No record found

See also:
  xedb_cch_get_rec

References:
  This function was derived from xedb_cch_get_rec and extended for update mode.

int zag_fld_clr_cns | ( | ) |

Deletes reference field values from constraint if user clears field manually.

It has the same effect as the selection "Clear entry" in the context menu of a recursive widget, but only if the field is empty and dirty, i.e. only when the field has been cleared by the user!

Note:
  This post-field userexit can be attached to any field that is a foreign key field in a constraint.

Returns:

  0 | OK

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