SAP Function BAPI_QPMK_REPLICATE - Prepare QM Master Inspection Characteristics for Distribution

Parameter Reference Type Length Default Optional Text
MSTCHARPLNT BAPIQPMK_MSTCHARPLNT u 12 Master Inspection Characteristic and Plant (Key Fields)

Parameter Reference Length Optional Text
EXTENSION1 BAPIEXTC 1000 X Container for 'Customer Exit' Parameter
RECIPIENTS BAPI_RECEIVER 10 X Target System for QM Inspection Methods
RETURN BAPIRET2 548 Standard Return Parameters


This function module is defined as a BAPI, and collects the masterinspection characteristics for dispatch with the help of ALE.
The filter object types are read from the distribution model; then, thevalues to be dispatched are written into the structurefilterobject_values, depending on these types. Finally, the relevantlogical systems are read, together with the filterobject_values fromthe distribution model, using a function module .
The import parameter is a structure that contains the master inspectioncharacteristic and its plant. This characteristic/plant combination isdistributed.
The function module is called once for each combination ofcharacteristic and plant.
  • The data for the master inspection characteristic/plant combination is
    • read from QPMK and the entire combination is sent (this means includingshort texts, physical-sample drawing texts and long texts).
    In this function module, the internal display (QPMK fields) areconverted to an external display of data fields (BAPI data fields).

    Import parameter
    MSTCHARPLNT is a key field containing the master inspectioncharacteristic and plant. This data clearly identifies the masterinspection characteristic.

    Export parameter
    RETURN is the standard return parameter for a BAPI and returns messagesif errors occur.

    Description
    This import parameter is a structure that contains a master inspectioncharacteristic number and a plant description. This parameter describesthe master inspection characteristic that is to be sent.
    All versions for a master inspection characteristic are processed.

    Value range
    An entry of areas is not supported. Only one master inspectioncharacteristic/ plant combination can entered at one time. If several,for example, n master inspection characteristics, should be copied,then the module must be called up n times.

    Description
    This parameter is a general enhancement parameter, which, if necessary,makes it possible to carry out enhancements in this BAPI interfaceenhancement (for example, additional data), without changing thestructure of the interface.
    The parameter is also available in BAPI 'BAPI_QMTB_SAVEREPLICA'.
    In both modules, the parameter 'EXTENSION1' can be managed with thehelp of the customer exit 'QPMK0020'.

    Description
    This parameter contains the target systems, to which the inspectionmethods are distributed.

    Value range
    This parameter must not be filled. If RECIPIENTS is empty, the systemattempts to create recipient systems, with the help of the matchingmessage type 'QPMK' from the distribution model.

    Note
    If recipient systems are entered in this parameter and matchingrecipient systems are also maintained in the distribution model, theobjects to be distributed are sent to all recipient systems. If neitherrecipient systems are entered in RECIPIENTS (empty), nor recipientsystems can be found in the distribution model, the distribution cannotbe executed, and an error message is generated.

    Description
    This parameter is the standard parameter for returning messages. If amessage (of whatever type) is written within this function module, themessage is stored in this return table. As exceptions are not allowedin BAPIs, this is the only possibility for returning messages. If thistable is empty, no error has occured. This parameter is mandatory for aBAPI. Further information can be found in the description for the datatype for this parameter (data type BAPIRET2)