Sapass

 Simplify SAP R/3 development with Excel VBA/VB RFC  
Home> Bapi>ProcessCharactrstcPI



Index

ProcessCharactrstcPI

ProcessCharactrstcPI


Characteristic of a characteristics group that has been released for use in process instructions or process messages.


Process instruction characteristics are used in process instructions.
Together with the corresponding characteristic values, they determine:


  • The information transferred or requested in a process instruction (for example, the status of a control recipe)

  • How the requested data is processed (for example, the message category used to report them)

  • Process message characteristics are used in process messages. Together
    with the corresponding characteristic values, they determine the content of a process message.


    11-Dec-2005


    Methods

    Available Methods


    • GetHelpvalues : Get allowed values for process characteristic [ BAPI_PROC_CHAR_GET_HELPVALUES ]
    • GetList : Read characteristic list incl. details [ BAPI_PROC_CHAR_GET_LIST ]

    11-Dec-2005


    GetHelpvalues

    GetHelpvalues


    Using this method, you read allowed values for process instruction characteristics and process message characteristics from the R/3 System.

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

  • 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.

    Notes

    Prerequisites for Value Selection

  • The characteristics must belong to a characteristics group that hasbeen 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舩 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 criteriafor 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 R/3 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.


    11-Dec-2005


    GetList

    GetList


    Using this method, you read process message characteristics and process instruction characteristics defined in the R/3 System as well as their detail data.

    For example, you obtain information on the characteristics group andthe format of a characteristic. This information is stored in R/3 Customizing in the characteristics definition (see IMG for
    Process Management
    , Define characteristics for process messages and Define characteristics for processinstructions).

    Notes

    Authorizations

    You need the following authorization to carry out the method:


    Authorization object Field Plant

    C_CABN Activity 03 (Display characteristic)

    Selection Criteria

    In the parameters Plant, InstrCharsFlag, MessageCharsFlag, and
    CharacteristicGroup
    , you specify the characteristics for which detailed data is to be passed on.

    In parameter Language, you specify the language of the texts to be passed on.

    Characteristics Data

    The detailed data of the selected characteristics is returned in parameters CharacteristicData and
    CharacteristicTexts
    .

    System Messages

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



    11-Dec-2005