Functionality
In ALE outbound of the ALEdistribution of product catalogs, this module triggers the transferof item data of a product catalog to specified recieving systems.
Using parameter "RequestChanges", you can control whether the specifieddata is send "directly" (that is, in full) or on the basis of changepointers. If change pointers are used, the data is only sent if it hasbeen changed before the "CreationDateTo" date.
The entries for BAPI "ProductCatalog.SaveItemsReplica" in the ALEdistribution model are used to determine the possible receiving systemsand the data that is to be replicated. The parameters "VariantIds","AreaIds", "ItemIds" and "Recipients" can be used to further restrictthe data allowed by the distribution model.
Parameter "RequestComplete" can be used to increase the amount of datato be replicated (prices and material short texts, for example). Thismay be of used when corresponding with an external system.
You can use parameter "MaxItems" to control the number of IDocs overwhich the data (layout area items) is split. If you expect errors tooccur in inbound processing, it is advisable to split the data over asmany IDocs as possible, as this makes it easier to find the errors andpost the data.
Information on the objects (catalogs, catalog items, materials andIDocs) actually distribued are returned in parameters"ReplicatedCatalogIds", "ReplicatedItemIds", "ReplicatedMaterialIds"and "CommunicationDocuments".
All the messages that are created are returned in parameter "Return".

Notes
To be able to create and change data, you need authorization for theactivity "Create IDocs" for the catalog in question for authorizationobject "W_PCAT_MTN".
A separate IDoc segment and function exit "Exit_Saplwpca_002" of SAPenhancement "Wpca001" are available for customer enhancements.
Method "ProductCatalog.ReplicateHead" is available for the basic andstructure data of a product catalog.

Further information

Description
You can use parameter "CatalogId" to transfer the number of the catalogfrom which layout area items are to be replicated. If this parameteris blank, the layout area items of all catalogs (according to theconditions in the distribution model) are transferred. Data cannot besent if the distribution model does not allow this.
For further information, see the data elementdocumentation.

Description
If parameter "RequestChanges" is selected, all non-processed changepointers for product catalog data are analyzed up to the date enteredin parameter "CreationDateTo" . All changes made to the catalog up tothis date are send to the recipient(s). If "RequestChanges" is blank,the parameter is ignored.

Description
The maximum number of layout items that can be distributed in an IDoccan be specified in paramter MAXAREAS. A maximum of 999 layout areasare possible per IDoc. A default value of 100 is displayed.

Description
You can use this parameter to transfer modifications to catalog datathat has already been replicated to the receiving system.
This parameter can contain the following values:

• 'X'

This value means that only item data that has been modified (accordingto change pointers) is replicated. All non-processed change pointers upto the date CREATIONDATETO are analyzed. A prerequisite for this isthat the change pointers are activated for message type PCITEMS in theIMG.

• ' ' (no value)

"No value" is the standard setting and means that all item data isreplicated, irrespective of changes.

Note
This parameter cannot be used if recipients are explicitly entered inparameter "Recipients", as in this case, the change pointers for allrecipients are reset, and any further recipients cannot be taken intoconsideration at a later date.

Description
You can use the parameter REQUESTCOMPLETE to instruct the BAPI to sendall data of an item. As a result, if data is transferred using changepointers, all data for the item (including texts and prices) is sent,not just data that has changed. In the case of direct transfer,material descriptions and pricing conditions are also sent. This is notnecessary for the replication of all data if the receiving system is aR/3 system, as this data is sent to the receiving system in a separatemessage.

Description
If this indicator is selected, the change pointers to be selectedcannot be set to complete. This means they are available for a repeatexecution. As a result, it is possible to test the function.

Description
Optional table parameter "AreasIds" can contain the layout areas ofcatalog "CatalogId" for which layout area items are to be transferred.

Note
If no catalog number is entered, this parameter must not be filled.

Description
If IDocs are created, their keys are returned in table"CommunicationDocuments".

Description
If paramter "AreaIds" (layout areas) contains a single entry, items ofthis layout area can also be selected in parameter "ItemIds".

Note
This parameter can only be filled if the parameters "CatalogId"(catalog) and "AreaIds" (layout areas) are also filled and "AreaIds"contains a single entry.

Description
The possible receiving systems are determined via the ALE distributionmodel. You can restrict the number of receiving systems by using theparameter "Recipients". If parameter "Recipients" is blank, the productcatalog data is sent to all allowed receipints (allowed recipients arethose stored for BAPI "ProductCatalog.SaveHeadReplica" in thedistribution model). Once the module is ended, all recipient systems towhich IDocs were sent are returned in this table parameter.

Note
Distribution on the basis of change pointers is not possible if therecipients are explicitly entered, as in this case, the change pointersfor these recipients are reset, and further recipients may not be takeninto consideration.

Description
The numbers of the distributed catalogs are returned in table"ReplicatedCatalogIds".

Description
The keys of the distributed layout area items are returned in table"ReplicatedItemKeys".

Description
The numbers of the materials that are used in the distributed layoutarea items are returned in table "ReplicatedMaterialIds".

Description
This structure is used to return the return code to the callingprogram.
For information on the significance of the individual fields in thestructure, see the relevant data element documentation on theindividual fields.

Value range
Type,, ID ,, Number
E ,, B1 ,, 004
E ,, W+ ,, 401
E ,, W+ ,, 424
E ,, W+ ,, 425
I ,, W+ ,, 428

Description
If you entered a catalog in the "CatalogId" parameter, you can use theoptional table parameter "VariantIds" to restrict the variants of thiscatalog that are to be copied rather than include all the variantsentered in the distribution model. All texts (e.g. texts for layoutarea items) are then distributed in the languages of the selectedvariants only.

Note
If no catalog number is entered, this field cannot be filled.