Generating Worklists 

Use

Worklists can be generated manually or scheduled automatically.

Worklists are generated automatically using programs RC1AVGE1 and RC1AVGE2.

The program RC1AVGE1 determines the reports that could be affected by a change to a substance or phrase, so-called reports with potential changes. The program RC1AVGE2 then determines whether the reports with potential changes that you selected have actually been affected by a change to a substance or a phrase.

For more information, see the hyperlink to Report RC1AVGE1 and Report RC1AVGE2 that is set in release note EHS_22B_PATCHLEVEL03 (Changes to SAP EH&S Release 2.2B, Patch Level 1 and 3).

The release note is assigned to the standard release 4.6A of component Environment Management -> Product Safety. To obtain the release notes, choose Help -> Release notes and generate the release notes for standard release 4.6A.

Prerequisites

Manually or automatically generated report requests exist (see: Usage under Report Management Worklist).

The R/3 System places manually generated report requests in the worklist. For automatically generated report requests, you can create the worklist manually or have the R/3 System create them for you periodically.

You have set up the environment parameters AVGEN_SPLIT and AVGEN_SHOW_MSG in the IMG activity Specify environment parameters. For more information, see the documentation in the IMG activity Specify environment parameters.

Procedure

Generating the Worklist Manually

  1. From the Product Safety screen, choose Reports ® Edit reports ® Gen. work list.

    2. The Generate work list dialog box appears.

  2. Choose Yes.

The R/3 System creates the worklist in the background.

Generating Worklists Automatically

  1. Scheduling the program RC1AVGE1

The program RC1AVGE1 should be scheduled periodically, for example, on a daily basis.
    1. Call the R/3 System in the required client.
    2. From the SAP R/3 screen, choose System ® Services ® Jobs ® Define job.
    3. Enter a job name ( WORKLIST_GEN, for example) and choose the appropriate job class.
    4. Choose Start condition and in the following dialog box, choose Date/Time.
    5. Enter the required data and select Periodic job.
    6. Choose the function Period values and specify the periods. Choose and then .
    7. Choose and then .
    8. Choose Step and in the following dialog box, choose the function ABAP program.
    9. In the Name field, enter the key RC1AVGE1 .
    10. Choose and then .

Before you leave the Define Job screen, you must save your entries again.

The R/3 System creates the worklist periodically according to the start date defined.
  1. Scheduling the program RC1AVGE2

You can schedule a job for the program RC1AVGE2 in the following ways:
    1. You can schedule the program RC1AVGE2 with the program RC1AVGE1. To do this, schedule a job that has program RC1AVGE1 assigned as step 1, and program RC1AVGE2 assigned as step 2.

      2. Make sure that no variants with selection criteria are scheduled for the program RC1AVGE2 that restrict the selection of reports with potential changes. This would prevent all reports that were determined by program RC1AVGE1 from being checked.

    2. If changes to a substance or a phrase could lead to the report program RC1AVGE1 determining very many reports as having potential changes, you should schedule the job for report program RC1AVGE2 in such a way as to prevent all of the reports with potential changes from being checked in one run. Otherwise the runtime could be extremely long.

      3. For this reason, you should schedule the job for program RC1AVGE2 with selection criteria (for example, substance authorizations group, substance, SRGV, language, number of reports to be checked). This means you can run several jobs simultaneously, or spread the checks out over several days.

      With this procedure, you must make sure that the selection criteria is chosen for the different jobs in such a way so that each report with potential changes is taken into account for checking by at least one job. If the criteria overlap, the report with potential changes is checked by the job that selects the report first.

    3. Apart from scheduling jobs periodically, you also have the option of always starting the job for the program RC1AVGE2 whenever the reworking of a particular substance or phrase is completed in a particular language.

For example, if a substance is reworked over a period of two weeks, we do not recommend that you generate new versions of the reports for this substance within these two weeks. In this case, after the substance has been reworked, you should start the job for the program RC1AVGE2 with a variant that has this substance as a selection criterion.

In the same way, for example, you should only check all English reports when the reworking of all the English phrases has been completed.

With this procedure, you must once again make sure that reports specified are not forgotten during the checks. We therefore recommend that you run the job for report program RC1AVGE2 at regular intervals without selection criteria to be sure that all the reports with potential changes are checked.

Result

All reports generated for the worklist have the same initial status defined in the generation variant header. You can then call reports in the worklist and process them (see also: Processing Worklists for Reports).

Depending on the status, older report versions that exist for the same substance, generation variant and language are updated as follows:

If an older report version

Then

Does not yet have the status Released

The R/3 System replaces the older report version with the current report.

Has the status Released

The R/3 System creates the updated report again.