Kontakt

Ansicht
Dokumentation

BAPI_SITELAYMOD_CHANGE2 - Layout Module: Update Material Data

BAPI_SITELAYMOD_CHANGE2 - Layout Module: Update Material Data

CL_GUI_FRONTEND_SERVICES - Frontend Services   BAL_S_LOG - Application Log: Log header data  
This documentation is copyright by SAP AG.
SAP E-Book

Functionality

This method posts to SAP Retail the optimized material master and movement data from the space management program.

The following data can be transferred to SAP Retail:

  • Master data:
    Material number, unit of measure, EAN, material dimensions, sort sequence in shelf, shelf section, horizontal facing, vertical facing, layout module variant, and exclusion indicator. Exclusion means that the material is missing in the layout module variant, i.e. does not have a placement.
  • Movement data:
    Maximum shelf quantity, optimum shelf quantity, presentation quantity.

Import parameters

  • The parameter layout module SiteLayoutModule and
  • the structure Controls, which contains the following fields:
  • A plant for which listing conditions may have to be created

  • The path for the planogram file assigned to the layout module

  • A plant, if applicable

  • The requirement group

  • Indicator for whether a listing check is to be carried out

  • Indicator for whether the dimensions are to be updated

  • Indicator for whether the placement data is to be updated (this indicator should always be set if a material is to be added to the shelf or removed from the shelf and/or if placement data has changed)

  • The validity date for the listing of the materials assigned to the layout module. This date is also used as the validity date for the layout module version. If the date is empty, the system date is used instead.

  • Indicator for whether updating is to be started from this BAPI itself (=Commit Work),

  • Indicator for whether a check is to be carried out on the layout module against the layout and plant

  • A mapping variant. In the customer exit of this method, various mapping variants are defined which can be accessed for each call. Thus one mapping variant can form the average of the movement data, and another can aggregate this, for example.

  • Indicator for whether listing is to be carried out for the materials concerned

  • Indicator for whether the version of the layout module is to be released immediately

  • A layout module variant to which certain materials are to be assigned

  • A layout module version. If no version is specified, the "Valid from" date can be used to find a version

  • Indicator for whether the valid-from date is to be used for version determination

  • A document number that links a layout module version with a shelf planogram file via document management

Import and consistency check

The table Items is imported for the optimized material data.

First additional header data is read for the selection data and checked for consistency. The imported material numbers are then compared with the material numbers in SAP Retail. If a material number in table Items does not exist in SAP Retail, a further check is carried out to determine whether a material with the same EAN exists. If it does not, the material is deleted from the table. In addition, the material is written to an error log, in order to inform the initiator of which material postings led to errors.

An entry is also written to the error log if a work in the import table for plant does is not assigned to the relevant layout module or does not exist at all.

Finally the system checks whether the materials are in the valid listing period or sales period. The start date of listing for the layout module in structure Controls is used as the check date. If materials in the import table are not listed or salable at the specified time, an entry is written to the method's error log.

The fixture assignments for the layout module version are imported in table Fix_Asgmt.

Updating of optimized data

After the checks, the following data is updated:

  • Date of last optimization for the relevant layout module version
  • Updating of material dimensions
  • Updating of layout module version
  • Updating of assignment of layout module variants
  • Updating of assignments of fixtures to layout module version
  • Updating of placement data of a material in the layout module
  • Updating of the document number.
Values <> 0 are also updated, as materials can be assigned that were not placed in the planogram but still need to remain in the layout module. Material dimensions with values equal to zero are not updated. For the updating of optimized stock data, the customer exit of the method must be used up to Release 4.5A. As of Release 4.5B, this stock data can be updated directly without the use of the customer exit.

Planogram file

This link between a planogram file and a layout module is created by a document in document management. Here, it is necessary for a few settings to be made in Customizing for document management. Define Document Types.

You must ensure that document type "Layout document" (L01) permits external number assignments. These settings are made in the details view for the document type in Customizing for document management under control data Define Document Types.

At the same point, the flag next to "Version Assignment" must not be set, so that different versions can be created using the BAPI.

There are four different cases for updating the document number:

  • If the document specified in the update BAPI does not yet exist in SAP Retail, this document is created.
  • If the document specified in the update BAPI already exists in SAP Retail and both the object link to the layout module version and the planogram name and path were not changed, the only the document update date is changed.
  • If the document specified in the update BAPI already exists in SAP Retail, but is now linked to another layout module version, a new version is created in version management for the document. The old version of the document is not deleted.
  • Finally, if the document specified in the update BAPI already exists in SAP Retail, but the planogram was saved in a different destination or with a different file name in the space management system, a new version is again created. In this case, too, the old version of the document is retained.

Notes

If the update flag is not set in this method, a Commit Work is not triggered. As a result, after the method has been called, a general BAPI BAPI_TRANSACTION_COMMIT must be called to trigger the update.

As mentioned above, consistency and dependency checks are carried out. The validity of the entries customer, layout, and layout module is checked and error messages are issued as appropriate. The dependencies customer to layout and layout to layout module are also checked.

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

In the listing check, for each material the system checks whether the material is list and/or whether it can be sold. The checking period for the listing check covers the listing period and the sales period. However, a listing check is only possible if a plant was also entered in the control parameters.

The materials are only assigned to a shelf assortment modules if the indicator for executing listing has been set. In addition, the listing conditions for the materials are created with a horizontal facing of 0 and the shelf assortment modules are assigned to the relevant assortments if the layout module on which the version is based was already assigned to one or more plants.
A prerequisite for listing is that the layout module version has been released. This can either be done in version maintenance in SAP or via the Release Version Immediately indicator in this method. If a plant is specified in the control data, listing conditions are only generated for this plant. Otherwise, listing conditions are generated for all plants to which the layout module is assigned.

Directly after data import and before the updating of data in SAP Retail, this method has a customer exit which can be used to process the imported data elsewhere or to import and update further data.

The length of the document path should not exceed 140 characters.

The layout check determines whether the specified layout module is assigned to the plant(s).

The Plant control parameter is used to determine the space management profile assigned to this plant. If a plant was not transferred during data import, the reference plant of the layout module is used.

The Requirement Group parameter has no functionality in the standard system. It is merely used as a further option for controlling the updating of the imported space management data.

In addition, table STORES can be used to transfer the plants whose local assortments are to be assigned the selected layout module variant.

It behaves in a similar way for the updating of a layout module variant if a store (CUSTOMER) was entered in the Controls. Its local assortment is also assigned the layout module version.

GLOSSARY:
All the key terms are explained in brief below:

Planogram:
Graphical representation of a shelf in a space management program.

Layout:
Spatial arrangement of the goods on sale in a store or department. A layout consists of layout modules and can be assigned to one or more stores.

Layout area:
A layout can be subdivided into layout areas, whereby a layout area corresponds to exactly one layout module within the layout.

Layout module:
Grouping of materials that are to be presented together in the same area of the store. A layout module can correspond to one or more sales shelves. Different layout module versions can exist for a layout module. Each of these versions is valid for a particular period. Different materials can be assigned to the versions. Layout module variants are used to map differences to the currently valid version for individual stores.

Fixture:

A fixture is used to present the goods on the relevant sales area. This means that the fixture holds the goods in order to encourage the customer to buy them. The fixture takes up a certain amount of space on the sales area, so that only a limited number of fixtures can be placed in the sales area. Fixtures are assigned to layout module versions and include the following objects: shelf section, wall with hooks, wall with pins, container, round stand, freezer, and so on.

Layout module version:
Version of a layout module. The layout module version assigns materials to a layout module for a specific period and thus enables layout modules to be planned. At least one version exists for every layout module. Only one version can be valid at a given point in time.

Layout module variant:
Layout module variants are used to define slight differences to the currently valid version for individual stores. The variant can contain extra materials or fewer materials than in the version. The currently valid version is also known as the basic variant. Layout module variants always relate to a basic variant, and from a technical point of view only contain the delta, that is the differences to this basic variant.

Further information

For more information, see the SAP Library under Space Management.





Parameters

CONTROLS
EXTENSIONIN
FIX_ASGMT
ITEMS
LAYOUTMODULE
RETURN
STORES

Exceptions

Function Group

WRF_WPLG

Fill RESBD Structure from EBP Component Structure   CL_GUI_FRONTEND_SERVICES - Frontend Services  
This documentation is copyright by SAP AG.

Length: 14464 Date: 20240523 Time: 170330     sap01-206 ( 218 ms )