Kontakt

Ansicht
Dokumentation

EHSWAR_SETUP_APP_QTY_UPDATE - Update Report for Quantity Update

EHSWAR_SETUP_APP_QTY_UPDATE - Update Report for Quantity Update

PERFORM Short Reference   BAL Application Log Documentation  
This documentation is copyright by SAP AG.
SAP E-Book

Purpose

Update report EHSWAR_SETUP_APP_QTY_UPDATE checks and updates (if required) the quantity update in Waste Management.

The quantity update consists of two parts, both of which are supported by this report:

  • Quantity update of total quantity
The quantity update for the total quantity is active as standard, if you create disposal document items with reference to a waste approval and select a waste code that is relevant to quantity update from this waste approval. To display or manually select the quantity update-relevant waste code, in Customizing you must define the screen Change Disposal Documents so as to show the Waste Code tab page.
Depending on the update mode for the quantity update-relevant waste code, remember that the update report may set a quantity update-relevant waste code in the disposal document automatically.
  • Period-based quantity update
You can activate period-based quantity update in the IMG activity Specify Waste Approval Types and choose between different activation levels (low, medium, or high tolerance). As for quantity update of the total quantity, the basis is the disposal document items plus the quantity update-relevant waste code. However, the disposal document items are updated according to the key date defined in addition to the update of the total quantity for the relevant period.
If you deactivate period-based quantity update, the update report does not check or update the quantities disposed of to date in the periods of the relevant waste code in the waste approval.
When you activate period-based quantity update, you must run the update report in order to initialize period-based quantity update.

For more information about quantity update, see the documentation on Waste Management (EHS-WA).

Integration

Prerequisites

Before running the update report, you must check the sort sequence of waste codes in the waste approval and may need to redefine it, so that the report can determine a quantity update-relevant waste code.

For disposal document items that contain several waste codes and for which you do not want to determine new quantity update-relevant waste codes, you must ensure that only the quantity update-relevant waste code you require is selected.

If you specify different units of measure for the quantity disposed of, the alert quantity, and the licensed quantity for a waste code or period, you must specify global conversion rules in the IMG activity Check Units of Measurement.

You can specify the rules for converting units of measure for the quantity specified in the disposal document item into the units of measure for the waste code or period as global conversion rules in Customizing or as conversion rules for the waste material.

In case of conversion errors, the report cannot correct the total quantity or period-based quantity.

If you run the report in update mode for quantity update, all the waste approvals whose quantities are different to the calculated total of the disposal document items must be locked for correction.

If the update mode that you use for the quantity update-relevant waste code determines a new quantity update-relevant waste code, the affected disposal document must also be locked to enable the correction to be made.

If a locking error occurs, the report cannot make the change or correction. You must then make sure that the waste approval or disposal document is unlocked, and then call the report again.

If you want to use the report in update mode for quantity update, choose a time when no users are working in the Waste Management component.

If you are running an upgrade or installing Waste Management for the first time, you must first run report EHSWAR_INIT_FUNC_APP_DISPDOC to run an initialization.

The initialization report defines a sort sequence of waste codes for waste approvals, to determine the quantity update-relevant waste code of the disposal document item, and initializes the quantity update-relevant waste code. The initialization of the quantity update-relevant waste code is not identical to the process that report EHSWAR_SETUP_APP_QTY_UPDATE supports by means of the sort sequence for waste codes. If you want to continue to use the same waste code for the waste approval after an upgrade, you must run the report EHSWAR_SETUP_APP_QTY_UPDATE in update mode Retain Selection for Relevant Waste Code.

Features

Report EHSWAR_SETUP_APP_QTY_UPDATE runs a comprehensive check on quantity update (total quantity and – if active – period-based quantities).
This check calculates the total of all quantities for disposal document items that are assigned to the waste code of a waste approval. Disposal documents that are flagged for deletion and reversed disposal documents are ignored in this total.
Then the report compares the calculated total of disposal document items with the total quantity disposed of so far or the quantity disposed of for the period, and displays the result.
Provided that no critical error occurs when calculating the total (for example, an error when converting units of measure, or the exceeding of the licensed quantity), the report can correct the quantity disposed of so far, if you are running the report in update mode for quantity update.

The report can determine a quantity update-relevant waste code. Each disposal document item must contain exactly one quantity update-relevant waste code, so that the disposal document item can be updated.
The quantity update-relevant waste code and a corrected quantity disposed of for quantity update are only written to the database if you run the update report in update mode for quantity update.

The report runs several consistency checks, for example, whether the waste approval is valid and released. The results of this check are for information only and do not prevent any correction of the quantity update or a change to the quantity update-relevant waste code. The report assumes that the data was correct at the time when the disposal document or disposal document item was created.

Selection screen

You can restrict the waste approvals to be checked or updated according to the authority-assigned waste approval number and disposal document type, or any combination thereof.

If you leave the input fields blank, the report checks or updates all the waste approvals in the system.

To retain the current quantity update-relevant waste code for the disposal document item, select Retain Selection for Relevant Waste Code. First make sure that you have selected exactly one quantity update-relevant waste code in each disposal document item, and that the selected waste code is valid.

To automatically determine a quantity update-relevant waste code for all disposal document items where no quantity update-relevant waste code has been selected, select Determine Relevant Waste Code for Missing Selection. This is the default setting.

To determine new quantity update-relevant waste codes, select Determine Relevant Waste Code in Each Case. In this case the system overwrites any previous quantity update-relevant waste codes that are selected in each disposal document item. You can use this option to automatically correct cases where multiple quantity update-relevant waste codes have been selected for a disposal document item.

Note that the quantity update-relevant waste code is only updated in the disposal document items of disposal documents that are assigned to one of the waste approvals within the scope of the selection.

To display all disposal document items with the item quantities that were included in the total quantity disposed of to date, together with the calculated quantity update data (total quantity and period quantity if applicable), select Display Assigned Disposal Document Items.

To run the report in update mode for quantity update, select Update Quantity Update.This means that the report saves the determined quantity update-relevant waste codes to the database and corrects any errors that can be corrected.

If you do not set this indicator, the report only runs a simulation without changing the data.

Result output

The report outputs the result as an application log, both on screen and in the database.
However, the output on screen and the output in the database are slightly different. The screen shows one log, to facilitate export of the output, whereas the output in the database is split into several logs, to make it easier to read.
To display the database output, use transaction SLG1, object EHWM, and subobject WMAPPQTY.
You can influence the expiry date of the database output with the EH&S environment parameter WAM_PROT_EXPIRE_DAYS. If you do not specify a value for this environment parameter, the report assumes a value of 30 days. Note that the database entries are needed in case of support queries about quantity update.

The external identification of the application log specifies whether the report runs as a check (simulation) or a correction (update).

Each output section is introduced by one of the following messages lines. (For the database entries this means separately written logs with an identifier in the external identification to distinguish them):

  • Global
Messages that cannot be assigned to either a specific disposal document or a specific waste approval.
  • Disposal document X
Messages for the disposal document and its disposal document items (for example, the definition of a new quantity update-relevant waste code).
  • Waste approval Y
Messages for the waste approval and the data for quantity update of the assigned waste codes – total quantity and, if active, period quantities.
if you have set the Display Assigned Disposal Document Items indicator, the disposal document items used to calculate the quantity disposed of to date are displayed for each calculated total quantity or period quantity.

All output sections are optional and are only shown if relevant messages exist.

The messages are sorted first according to relevance, then according to error classification. For example, the first message may be an information message about a situation that is caused by an error shown in a later message.

To ensure that the quantity update is correct, no new quantity update-relevant waste codes can be determined in the simulation, and all data of the quantity update must be correct.

When updating the quantity update, all the determined quantity update-relevant waste codes must be set correctly and in addition all data of the quantity update must be either correct or corrected.
If this is not the case, you must resolve the cause of any errors to ensure the correctness of the quantity update (for example, increase the total licensed quantity, so that the update report can correct the total quantity), then run the update report again in update mode for quantity update.

Notes

SAP recommends that you first run a simulation of the quantity update.
Once you have checked the result by using the screen output or the created database entries in the application log, you can select update mode for quantity update, which writes any new quantity update-relevant waste codes determined and the corrected quantities disposed of to the database.

The update report can only automatically correct the quantity update errors that are shown in the simulation as correctable. In case of critical errors, the relevant quantity disposed of cannot be corrected automatically, and the new quantity update-relevant waste code cannot be set. First you must resolve the critical error, then run the update report again.

You can run the report any number of times.

The update report calculates the quantities disposed of so far for quantity update, using the current system status. If you change the assignment of the disposal document status that corresponds to Reversed in Customizing, the calculated value of the quantity disposed of so far may be incorrect.
However, you can use the report to recalculate the quantity update data according to the changed Customizing settings.

Selection

Standard Variants

Output

Activities

Example






Addresses (Business Address Services)   General Data in Customer Master  
This documentation is copyright by SAP AG.

Length: 13955 Date: 20240531 Time: 144251     sap01-206 ( 246 ms )