Sapass

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



Index

BatchSpecMaterialUoM

BatchSpecMaterialUoM


The Proportion/Product Unit object combines the proportion and
product unit. Proportion and product units are special kinds of the alternative units of measure.


The Proportion unit is a unit of measure in which you can enter proportions of a material base quantity.


The Product unit is a unit of measure in which you can enter
quantities of a material that are alternative to the base unit of measure.


Structure


Proportion units and product units are defined for a material.


Whereas the conversion ratio for alternative units of measure is set in
the base unit of measure in the material, for the proportion unit and the product unit, you define


  • the planned conversion ratio in the material and

  • the actual conversion ratio in the batch

  • Integration


    Proportion and product units for materials to that are to be handled in batches can be used in all processes along the
    supply chain
    .


    As long as the batch is not yet recognized, the system uses the planned
    conversion ratio from the material when converting to the base quantity. As soon as the batch is recognized, the system uses the
    actual conversion ratio from the batch.


    11-Dec-2005


    Methods

    Available Methods


    • Replicate : Distribute batch-specific material units of measure [ BAPI_BMUOM_REPLICATE ]
    • SaveReplicaMultiple : Replicate batch-specific material quantity units [ BAPI_BMUOM_SAVEREPLICAMULTIPLE ]

    11-Dec-2005


    Replicate

    Replicate


    Notes

    ==================================================

    This method is

      not
    released for use

    in a production system!

    ==================================================


    The method is called in the system in which the originals of the object Batch-Specific Material Units of Measure are located.

    The method includes the following functions:

  • Identify the batch-specific material units of measure for replication

  • Combine the relevant attributes
  • Determine the receipient
  • Call the method SaveReplicaMultiple in the receiving systems
  • Fill the table with the replicated object instances
  • Fill the return parameter and end the method
  • This method only triggers replication of batch-specific units of
    measure, The actual replication is carried out with a time-delay, if the method is called in the receiving system via the IDOC interface This decoupling is ensured via the distribution functions that are made available using ApplicationLink Enabling (ALE) technology.


    Notes

    Dependencies Between Parameters

    The batch-specific material units of measure are identified either using the selection parameters Material andUoM Usage or using the import parameter Request Changes. In particular, you
    should refer to the documentation on import parameter Request Changes.

    The receiving systems are either passed on using the table parameter Recipients or determined using the ALE distribution model.

    If you request changes from Engineering Change Management,
    (import parameter Request Changes), the recipients must be determined using the ALE distribution model.

    Customizing

    Distribution (ALE)

    You make the global settings for distributing data between application systems in Customizing, at Distribution (ALE).


    You must add method SaveReplicaMultiple to object names/interface BatchSpecMaterialUoM in your distribution model for the distribution of batch-specific material units of measure. Thedata filtering for recipient determination depends on message type Material (MATMAS). You make the
    settings for the distribution model in Customizing at Maintain Distribution Model.

    Change pointers

    The prerequisite for change requests from Engineering Change Managementis the update of change pointers for batch-specific material units of
    measure. You have to execute the following Customizing activities for this:

  • Activate change pointers - general
  • Activate change pointers for batch-specific material units of measure (message type BMUMAS)
  • Note:


    You cannot activate any change pointer for batch-specific material units of measure in this release

    Authorizations

    You require the following authorizations to execute this method:

    Object description Object


    Fields Description Values

    Material master: Central data M_MATE_MAN

    ACTVT Activity 03

    Material master: Material M_MATE_MAT


    ACTVT Activity 03

    BEGRU Authorization group for material

    Material master: Material group M_MATE_WGR

    ACTVT Activity 03

    BEGRU Authorization group for material group


    Class types authorization C_TCLA_BKA

    KLART Class type 022, 023

    Classification authorization C_KLAH_BKL

    ACTVT Activity 03

    BGRKL Authorization for classification


    Maintenance authorization for view characteristics

    C_TCLS_MNT

    ACTVT Activity any

    KLART Class type 022, 023

    SICHT View indicator S

    Dependencies on other methods


    This method calls method SaveReplicaMultiple. For more information on this method, see the method documentation.

    Performance

    If you do not narrow down the selection of batch-specific materialunits of measure using either change requests from Engineering Change
    Management or the selection parameters Material or UoMUsage, allmaterials and units of measure that exist in the current system arepassed on to the receiving systems. This can lead to long runtimes and a heavy system load.

    The selection is independent of whether batch-specific units of measure
    are used for the materials or not, because batch-specific units of measure must be deleted in the receiving system, if necessary.

    Messages

    Messages are returned in the parameter return. The parameterdocumentation shows the return codes and their meanings.


    Further Information

    For more information, refer to the SAP Library at:

  • CA - Cross Application Components: Application Link Enabling
  • ALE BAPI Programming guide in particular
  • CA - Cross Application Components: BAPI

  • BAPI User Guide
  • BAPI Programming Guidelines
  • LO - Logistics: Logistics - General: Batch Management

  • 11-Dec-2005


    SaveReplicaMultiple

    SaveReplicaMultiple


    Notes

    ==================================================

    This method is

      not
    released for use

    in a production system!

    ==================================================


    You use this method to replicate batch-specific material units of measure to the target system.

    The method includes the following functions:

  • Batch-specific units of measure for a material
  • Change
  • Create

  • Delete
  • Change alternative units of measure to batch-specific units of measure
  • Change batch-specific units of measure to alternative units of measure
  • Only the attributes relevant for batch-specific units of measure are
    replicated with this method. You can find these attributes in the documentation on the table parameter Batch-SpecificUnits of Measure.
    All other attributes of an alternative unit of measure, such as weightand volume information, must be supplied using material master functions.


    The prerequisites for replicating batch-specific material units of measure are:

  • The material already exists in the target system
  • The material is assigned to a class of class type 'Batch'.
  • The class contains at least one characteristic to which a batch-specific material unit of measure can be assigned. The
    characteristic must meet certain format requirements and have the organizational area'Batch-specific material units of measure'.
  • Before you execute this method, you must replicate the material master data and the material classification with the class type 'Batch'.


    Notes

    Dependencies between parameters and functions

    For the functions Change batch-specific units of measure, Create batch-specific units of measure and Change alternative units of measure to batch-specific units of measure, it
    is sufficient to maintain the import table Batch-Specific Units of Measure. The function that is executed for the unit ofmeasure to be maintained depends on whether the unit of measure for the material:

  • Already exists as a batch-specific unit of measure

  • Does not exist yet
  • Is only defined as an alternative unit of measure until now
  • The functions Delete batch-specific units of measure and Change batch-specific units of measure to alternative units of measure
    are supported in two different ways. With these functions, you must note the dependencies between the following import parameters:

  • Complete replication (Complete Replication)
  • Batch-specific units of measure (Batch Specific UoMs)
  • Special functions (Special Functions)

  • Alternative units of measure (Alternative UoMs)
  • For more information, refer to the documentation on the import parameter Complete Replication.

    Change-relevant attributes

    You should note that you must select change-relevant attributes for all import parameters in the relevant update information
    .

    Authorizations

    To execute this method, you require the following authorizations:

    Object description Object

    Fields Description Values

    Material master: central data M_MATE_MAN

    ACTVT Activity 02

    Material master: material M_MATE_MAT

    ACTVT Activity 02

    BEGRU Authorization group for material

    Material master: material group M_MATE_WGR

    ACTVT Activity 02

    BEGRU Authorization group for material group

    Class types authorization C_TCLA_BKA


    KLART Class type 022, 023

    Classification authorization C_KLAH_BKL

    ACTVT Activity 01

    BGRKL Authorization group for classification

    Maintenance authorization for organizational area characteristics


    C_TCLS_MNT

    ACTVT Activity 023

    KLART Class types 022, 023

    SICHT Organizational view indicator S

    Buffering

    This method works with buffering. You cannot execute any other changing
    methods on the material processed in this method in the same Logical Unit of Work (LUW) That means that a database commit to update the data is necessary beforehand. For more information, refer to the transaction model for BAPI development
    in the BAPI Programming Guidelines in the SAP Library.

    Dependencies on other methods

    This method is called by the method Replicate. If you want toreplicate batch-specific material units of measure from an R/3 System, you should use the method Replicate
    to trigger the replication. For more information on this method, refer to the method documentation.

    Messages

    Messages are returned in the parameter return. The parameterdocumentation shows the return codes and their meanings.


    Further Information

    For more information, refer to the SAP Library at:

  • CA - Cross Application Components: BAPI
  • BAPI User Guide
  • BAPI Programming Guidelines

  • LO - Logistics: Logistics - General: Batch Management

  • 11-Dec-2005