Ansicht
Dokumentation

BAPI_PROC_CHAR_GET_HELPVALUES - Read Allowed Values for a Process Characteristic

SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up   RFUMSV00 - Advance Return for Tax on Sales/Purchases  
This documentation is copyright by SAP AG.

Functionality

Using this method, you read allowed values for process instruction characteristics and process message characteristics from the SAP system.

The allowed values are determined based on the search help that has been allocated to the characteristics in R/3 or SAP ERP Customizing. The following characteristic settings are taken into account (see IMG for Process Management, Define characteristics for process messages and Define characteristics for process instructions):

• The allowed single values or value ranges

• The allocated check table or check function

• The allocated foreign key dependency

Matchcodes defined in characteristics are not taken into account.

Example

Notes

Prerequisites for Value Selection

• The characteristics must belong to a characteristics group that has been released for use in process instructions or process messages (see IMG for Process Management, Define characteristics groups for process messages and Define characteristics groups for process instructions). The system checks whether the characteristics groups have been released in the plant you specify in parameter Plant.

• A function module for value selection in the background must have been defined for characteristics with check functions. The name of the function module must consists of the following:

• The name of the check function defined in the characteristic

• The ending _ND

A corresponding function module is currently available for the following check function in the standard system:

• COC1_PPPI_CHAR_VALUES (Value check of process characteristics with foreign key dependencies)

Authorizations

You need the following authorization to carry out the method:

Authorization object	Field	Value
C_PROCCHAR	Characteristic name	Characteristics whose
		values you want to read
Aktivität	B1 (Transfer allowed
		values to external system)

The system checks the characteristic whose name you specify in parameter CharacteristicName.

Selection Criteria

Using parameter SelectionForHelpvalues you can pass on criteria for the selection of allowed values. Which criteria you can use depends on the search help of the characteristic.

For information on the search help, first carry out the method using the DescriptionOnly indicator.
If you do so, the SAP System passes on the search help parameters, that is, the criteria you can use, in parameter DescriptionForHelpvalues (provided there are any).

To read the allowed values, carry out the method without the DescriptionOnly indicator afterwards and pass on the selection criteria.

Allowed Values Transfer

The allowed values are returned in parameters Helpvalues, ValuesForField, or FixValues.

System Messages

System messages issued during method processing are returned in parameter Return. For more information on possible system messages and their meaning, see the parameter documentation.

Further information

Parameters

CHARACTERISTICNAME
DESCRIPTIONFORHELPVALUES
DESCRIPTIONONLY
FIXVALUES
HELPVALUES
MAXROWS
PLANT
RETURN
SELECTIONFORHELPVALUES
VALUESFORFIELD

Exceptions

Function Group

COC8B

Vendor Master (General Section)   PERFORM Short Reference  
This documentation is copyright by SAP AG.

Length: 6054 Date: 20240523 Time: 171739     sap01-206 ( 66 ms )