SAP Function API_SEMBPS_CHA_VALUES_GET - Read Characteristic Values

Parameter Reference Type Length Default Optional Text
I_AREA UPC_AREA-AREA C 8 Planning Area
I_CHANM UPC_YS_API_CHAPRO-CHANM C 30 Characteristic
I_READ_ATTR BOOLE-BOOLE C 1 SPACE X Read Attributes

Parameter Reference Type Length Text
ES_RETURN BAPIRET2 u 548 Return Parameter
E_SUBRC SYST-SUBRC I 4 Return Code

Parameter Reference Length Optional Text
ETK_ATRVL UPC_YS_API_ATRVL 170 X Attributes for Characteristic Value
ETK_CHAVL UPC_YS_API_CHAVL 190 X Characteristic Values
ITK_CHASEL UPC_YS_API_CHASEL 173 X Characteristic Selection

Functionality
This function module delivers the characteristic values of acharacteristic corresponding to a selection condition.
Application possibilities:

  • Leave selection condition empty: All characteristic values of a
    • characteristic (for example an input help can be built in this way)
    • Selection condition with exactly one single value: Check whether
      • characteristic value exists (if it does not exist, the table ETK_CHAVLremains empty)
      • Get texts on one or several characteristic values

        • Description
        This structure can contain a message. In the case of E_SUBRC <> 0 itcontains an error message, in the case of E_SUBRC = 0 an informationmessage can be in this structure.

        Description
        This return parameter contains the value 0, when the module could beexecuted without any errors, otherwise the value of the returnparameter is larger than 0.

        Description
        A selection condition for characteristic values can be entered in this
        table.
        Selection of one or several single values
        For every single value, a table entry of the following structure is to
        be entered:
        CHANM = Name of characteristic
        SIGN = 'I'
        OPTION = 'EQ'
        LOW = Characteristic value
        Selection of one or several ranges
        For every range, a table entry of the following structure is to be
        entered:
        CHANM = Name of characteristic
        SIGN = 'I'
        LOW = Lower limit characteristic value
        HIGH = Upper limit characteristic value
        The characteristic values must be entered in external format (forexample period 001.1999 instead of internal format 1999001).
        A selection condition for the characteristic itself (I_CHANM)) can beentered in this table, and - with compounded characteristics - aselection condition for the higher level characteristic. Though thelatter must be selected with exactly one single value.