Ansicht
Dokumentation

CFG_API_GET_CSTIC_DOMAINS - Retrieve the domains of multiple cstics

CFG_API_GET_CSTIC_DOMAINS - Retrieve the domains of multiple cstics

CL_GUI_FRONTEND_SERVICES - Frontend Services   BAL_S_LOG - Application Log: Log header data  
This documentation is copyright by SAP AG.
SAP E-Book

Functionality

*"--------------------------------------------------------------------

*"*"Local Interface:

*"  IMPORTING

*"     VALUE(CONFIG_ID) TYPE  COMT_CFGM_CONFIG_ID

*"     VALUE(INST_ID) TYPE  COMT_CFGD_INSTID

*"     VALUE(CSTICS) TYPE  COMT_CFGM_CHNAME_I

*"     VALUE(ASSIGNABLE_VALUES_ONLY) TYPE  COMT_CFGM_BOOLEAN

*"         DEFAULT 'T'

*"     VALUE(INCLUDE_SURCHARGES) TYPE  COMT_CFGM_BOOLEAN DEFAULT 'F'

*"  TABLES

*"      CSTICS_DOMAINS TYPE  COMT_CFGM_CSTIC_DOMAIN_VAL_I

*"  EXCEPTIONS

*"      PARAMETER_EXCEPTION

*"      COMMAND_EXCEPTION

*"      EXCEPTION_CONFIG_NULL

*"--------------------------------------------------------------------

The characteristic domain for individual characteristics is retrieved. Domain retrieval may be expensive for two reasons:

  1. The data amount of characteristic domains is bigger than for characteristics. As the function modules are called as RFC, the data is mapped to Java and possibly passed over the network. The domains should be retrieved only if needed.
  2. For single value restrictable characteristics that have a value assigned, the internal domain is restricted to the one assigned value. This is done for technical reasons as the domain restriction may be used for further inferences. To determine the domain that would be calculated, if no user value would have been assigned the so called 'user domain' is calculated. This costs some extra performance.

Characteristic value domains should only be retrieved if really needed.

Possible filters that apply:

  • ASSIGNABLE_VALUES_ONLY determines if all values maintained for the characteristic are returned or only the values that are currently allowed
  • INCLUDE_SURCHARGES determines the retrieval of the surcharges for characteristic values.

The list of characteristics, whose domains shall be retrieved, has to be passed explicitly. If the list is empty, no domain is returned.

The domains are returned as follows:

  • CSTIC_NAME ,,,,the characteristic name to identify the characteristic
  • INTERVAL_TYPE ,,,,returns one of the following codes:
  • C_UNITY ,,= 1, // x == lower boundary

  • C_OPEN_RIGHT ,,= 2, // lower boundary <= x && x < upper boundary

  • C_CLOSED ,,= 3, // lower boundary <= x && x <= upper boundary

  • C_OPEN_BOTH ,,= 4, // lower boundary < x && x < upper boundary

  • C_OPEN_LEFT ,,= 5, // lower boundary < x && x <= upper boundary

  • C_OPEN_HIGH ,,= 6, // x < upper boundary

  • C_CLOSED_HIGH = 7, // x <= upper boundary

  • C_OPEN_LOW ,,= 8, // lower boundary < x

  • C_CLOSED_LOW = 9; // lower boundary <= x

  • LOWER_VALUE the lower value as a char40
  • UPPER_VALUE the upper value as a char40
  • ASSIGNABLE if the value can be assigned (possibly replacing the current value)
  • VCOND_KEY variant condition key that is assigned directly to the characteristic value
  • AMOUNT the amount of the variant condition that is determined for the given key,
  • CURRENCY the currency of the variant condition that is determined for the given key.

Further information





Parameters

ASSIGNABLE_VALUES_ONLY
CONFIG_ID
CSTICS
CSTICS_DOMAINS
INCLUDE_SURCHARGES
INST_ID

Exceptions

COMMAND_EXCEPTION
EXCEPTION_CONFIG_NULL
PARAMETER_EXCEPTION

Function Group

COM_CFG_API_UI_COMMAND

BAL_S_LOG - Application Log: Log header data   General Material Data  
This documentation is copyright by SAP AG.

Length: 6029 Date: 20240523 Time: 120252     sap01-206 ( 57 ms )