|
Functionality
The method is called in the system in which the originals of the objectBatch-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 recipient
- 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 ofmeasure, The actual replication is carried out with a time-delay, if themethod is called in the receiving system via theIDOC interface Thisdecoupling is ensured via the distribution functions that are madeavailable using ApplicationLink Enabling (ALE) technology.Example Notes Dependencies Between Parameters
The batch-specific material units of measure are identified either usingthe selection parameters Material and UoM Usage or usingthe import parameter Request Changes. In particular, you shouldrefer to the documentation on import parameterRequest Changes.
The receiving systems are either passed on using the table parameterRecipients or determined using the ALE distribution model
.
If you request changes from Engineering Change Management,(import parameter Request Changes), the recipients must be determinedusing the ALE distribution model.Customizing
Distribution (ALE)
You make the global settings for distributing data between applicationsystems in Customizing, at Distribution (ALE).
You must add method SaveReplicaMultiple to object names/interfaceBatchSpecMaterialUoM in your distribution model for thedistribution of batch-specific material units of measure. The datafiltering for recipient determination depends onmessage type Material (MATMAS). You make thesettings for the distribution model in Customizing atMaintain Distribution Model.
Change pointers
The prerequisite for change requests from Engineering Change Managementis the update of change pointers for batch-specific material units ofmeasure. You have to execute the following Customizing activities forthis:
- Activate change pointers - general
- Activate change pointers for
batch-specific material units of measure (message type BMUMAS)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,,,,SDependencies on other methods
This method calls method SaveReplicaMultiple. For moreinformation on this method, see themethod documentation.Performance
If you do not narrow down the selection of batch-specific material unitsof measure using either change requests from Engineering ChangeManagement 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 aheavy system load.
The selection is independent of whether batch-specific units of measureare used for the materials or not, because batch-specific units ofmeasure must be deleted in the receiving system, if necessary. Messages
INCLUDE BAPI_RET Further information
For more information, see 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
Description
Using this parameter, modifications to batch-specific material units ofmeasure can be adopted directly fromEngineering Change Management
and transferred to the receiving systems.
You must not use this parameter in conjunction with the parameterReceiving Systems (Recipients), since if a recipient accesses thesystem, the change pointer in Engineering Change Management is resetand any other recipients are no longer taken into account. In addition,you must not use the import tables Material or UoM Usage to define anyselection criteria.Value range
- The value 'X' means that batch-specific units of measure for a material
that are new, to be changed, or to be deleted, are replicated directlyfrom Engineering Change Management.
- The value BLANK means that Engineering Change Management has not been
accessed.Description
In the selection parameter Material, you can predefine criteria forselecting materials for which you want to replicate batch-specificunits of measure.
For the selection of materials, you can enter several tables rows withindividual material numbers or value ranges.
INCLUDE BAPI_DATAELEMENT
If you request changes from Engineering Change Management (importparameter Request Changes), you must not use this parameter. For moreinformation, see the relevantparameterdocumentation.Value range
INCLUDE VBWU_REPLICATE_SELECT_VALUES
When you maintain value ranges for the material number, bear in mindthat some application servers support character sets other than ASCII.In this case, problems can occur with selection or sorting theselection. For this reason, you should only choose characters in theranges A-Z, a-z, and 0-9.
INCLUDE VBWU_REPLICATE_SELECT_DEF Description
This import parameter identifies the logical systems in which thebatch-specific material units of measure are to be replicated.
If you do not specify a recipient in this parameter, the receivingsystem is determined using theALE distribution model.
INCLUDE BAPI_DATAELEMENT
If you request the change from Engineering Change Management (importparameter Request Changes), you must not use this parameter. For moreinformation, see the relevantparameterdocumentation.Description
The export parameter Replicated Object Instances contains a table ofthe materials and logical systems in which the batch-specific materialunits of measure are replicated.
INCLUDE BAPI_DATAELEMENT Description
INCLUDE BAPI_TABLE Value range
General processing information
Type,,ID,,Number,,Message
I,,LB,,246,,No materials to be replicated were selected
,,,,,,
S,,LB,,221,,Reading batch-specific units of measure for
,,,,,,material &1 (logical system &2)
This information is only output when errors occur during authorizationchecks or consistency checks for a certain material.
Messages about input checks
Type,,ID,,Number,,Message
E,,LB,,098,,The 'batch-specific units of
,,,,,,measure' function is not active
E,,LB,,226,,Please define at least one receiving system
E,,LB,,240,,Value &3 is not permitted for field &1
,,,,,,in parameter &2
E,,LB,,244,,Replicate from engineering change
,,,,,,management ==> selection criteria not permitted
E,,LB,,245,,Replicate from engineering change
,,,,,,management ==> recipient not permitted
E,,B1,,202,,Sending system must be different to receiving
,,,,,,system
E,,S&,,026,,Value & in field SIGN can only be I, E
E,,S&,,027,,Value & in field OPTION is invalid
,,,,,,(EQ,NE,GT,GE,LE,LT,BT,NB,CP,NP)
E,,DB,,650,,Lower limit is greater than upper limit
E,,DB,,664,,The options EQ / NE allow only singlevalues
E,,DB,,665,,Specify the range limits
E,,DB,,666,,Specify only the upper range limit
E,,DB,,667,,Specify only the lower range limit
E,,DB,,668,,The options CP / NP require at least one
,,,,,,masking character
E,,DB,,670,,No range allowed for generic entries
Messages about authorizations
Type,,ID,,Number,,Message
E,,M3,,849,,No authorization for material &
E,,M3,,852,,No authorization for material group &
E,,MM,,301,,You are not authorized to maintain material
,,,,,,master data at client level
Messages about consistency checks
Type,,ID,,Number,,Message
E,,LB,,103,,Please maintain the 'Use of UoM' key for
,,,,,,material &1
E,,LB,,023,,No batch class could be determined for
,,,,,,material &
E,,LB,,101,,For material & there are no allowed
,,,,,,characteristics for batch class &
E,,LB,,112,,Please assign batch class &2 to material &1
E,,LB,,113,,The batch class of material & was changed
,,,,,,from & to &
E,,LB,,117,,Characteristic & is no longer valid
E,,LB,,120,,Planned value & for UoM & is not stored as
,,,,,,char. value for char. &
E,,LB,,121,,Planned val. ( & ) and numer./denom.convers.
,,,,,,( & & ) differ for char. &
E,,LB,,133,,Inconsistent planned value forcharacteristic &
E,,LB,,139,,No characteristics of batch class & fulfilthe
,,,,,,format requirements
E,,LB,,140,,No characteristic of batch class & has
,,,,,,organizational area '&'
Other possible messages
Other possible messages concern ALE Customizing and Customizing forBatch Classification, for example:
Type,,ID,,Number,,Message
E,,B1,,442,,There are no receiver systems defined in
,,,,,,the distribution model
E,,B1,,555,,No RFC destination could be determined for
,,,,,,the method call
E,,B1,,808,,Filter object &1 is not valid for BAPI (&2,3)
E,,VK,,663,,Class type & is not active
E,,LB,,142,,Object table MARM_WS is not defined in the
,,,,,,classification systemNotes
If the table contains error messages (type = 'E') about input checks,the system ends the method without replicating batch-specific materialunits of measure.
If the table contains error messages (type = 'E') about authorizationsor consistency checks, the system does not select the batch-specificunits of measure belonging to the affected material for replication. Description
You can use the selection parameter Using Units of Measure to:
- Narrow down replication of batch-specific units of measure to materials
with proportion units or production units
|