Ansicht
Dokumentation

CLFM0003 - Call Up After Check of Assigned Characteristic Values

CLFM0003 - Call Up After Check of Assigned Characteristic Values

PERFORM Short Reference   BAL Application Log Documentation  
This documentation is copyright by SAP AG.
SAP E-Book

If this customer enhancement is activated, it is called after checking the assigned characteristic values. It allows the customer to respond to the result of the check in different ways.

In a transaction, the assigned characteristic values are checked when it can be assumed that value assignment is complete, for example in the following situations:

  • You leave the classification screen.

  • You save on the classification screen.

  • For objects with multiple classification, you switch to another class: in transaction MM02 by double-clicking on the assignment list.

This customer enhancement is especially useful for handling required characteristics. Here, you can define the conditions under which a user can leave a transaction if the user has not assigned a value to a required characteristic.

Typically, this customer enhancement will be used to generate a message of type E or I. Various conditions should be fulfilled before this happens, because not all transactions can be interrupted by a message. At least the class type should be checked before the message is displayed. Other possible restrictions could be transaction, class, or user.

Important:

If a required characteristic does not have a value, the classification status of the assignment is always set to 5 - incomplete (table KSSK-STATU).

If an assignment already has a status other than 1 (released), the assigned characteristic values are no longer checked for status. However, in the update task an attempt is made to change the status from 5 to 1, if the relevant indicator is set in Customizing (classification status: 'automatic release').

FUNCTION EXIT_SAPLCLFM_003

Import parameters

i_allkssk:

This structure (see dictionary ALLKSSK) contains the data of the current assignment, including class type, object name, and class.

i_check_rc

The result of the assigned value check, in other words the exception from function module CTMS_DDB_CLOSE. If an exception is raised, the module generates a message that is in the user exit or global structure SYST and can be copied (for example, message 817).

  • = 1: inconsistency

Inconsistency of a general nature.
  • = 2: incomplete

A characteristic that is a required characteristic due to a selection condition (object dependencies) has no value assigned to it.
  • = 3: verification

Not an error. A default value has not been confirmed.
  • = 4: not_assigned

A characteristic that is defined as "Entry Required" in the characteristic itself has no value assigned to it.
  • = 5: another_object

An object with the same classification exists. This check is only made if the class has the relevant indicator.
  • = 6: other_objects

Several objects with the same classification exist. This check is only made if the class has the relevant indicator.
  • = 7: display_mode

Obsolete.
  • = 8: others (= requ_char_excl)

A required characteristic was hidden by a precondition. This is only possible if no value is assigned to it.

i_from_api

  • = space

Classification was called by module CLFM_OBJECT_CLASSIFICATION and is running as a dialog in the full screen for classification (for example, classification CL20N, material master MM02, orders KO02). This means that messages can be displayed for the user - except in the case of batch input.
  • = 'X'

The customer enhancement was called by an API module (CLAP_*). This means that classification can run either in dialog on a tab page (for example, batches MSC2N, documents CV02N) or in the background (for example, ALE or BAPIs).
For this reason, the transaction must always be checked before a message is displayed, so that no messages can be generated during background processing.

i_appl

  • = space (Standard)

Classification.
  • = 'C'

Configuration.

Export parameters

e_active

This parameter can be set in order to show that the customer enhancement has been processed.
It is not currently processed.

Example

If you want to activate the customer enhancement, you can use include XCLF / LXCLFF03 as a template for your program ZXCLFU03.






SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up   CL_GUI_FRONTEND_SERVICES - Frontend Services  
This documentation is copyright by SAP AG.

Length: 5739 Date: 20240328 Time: 213846     sap01-206 ( 82 ms )