Programme SAP REAARCH_READ_LINES - Archive Billing Document Line Items

Title
Archive billing document line items

Purpose
This report carries out the second step in archiving billingdocument line items: writing billing document line items to an archivefile, based on the analysis carried out in the first step.
The archiving object related to the archiving of billing document lineitems is called ISU_BILLZ. It encompasses the following print documentdata:

  • Billing document line items

  • Discount line item data for the billing document

  • Texts for a billing line item

  • Data on conversion steps for each bill line item

  • Tax code information

    • Using the AOBJ transaction you will find the definition of the ISU_BILLarchiving object and the related Customizing.
    Using the SARA transaction you will find archiving administration andthe related Customizing.
    Using the SARI transaction you will find the technical view of anarchive.
    Using the standard Utilities Industry menu, you will find the accountingview of an archived billing document.

    Integration

    • REAARCH_ANALYSE_LINES

      • First step in archiving billing document line items: analyzingbilling documents with a view to possibly archiving them.
      • REAARCH_DELETE_LINES

        • Third step: deleting the billing document line items in thedatabase on the basis of the previously created archive.
        • REAARCH_RELOAD_LINES

          • Use this report to reload data that has been archived and alreadydeleted. Note that you cannot reload individual documents. You have toreload the entire archiving run. This procedure should not normally beused and should be limited to extreme problem cases (for example,incorrect retention period in Customizing).
          • REAARCH_READ_ARCHIVE_LINES

            • This report allows you to read a billing document line item archive andto display parts of the data in a list before the deletion program hasbeen executed. It displays the data in a technical view.

            Precondition
            Before starting this archiving report, you have to carry out at leastone analysis with the REAARCH_ANALYSE_LINES report.

            Output

            Features
            The archiving report selects the billing documents that have archivingindicator 1 (billing document line items can be archived). The lineitems from these billing documents are written to an archive file andtheir archiving indicator is set to 2 (billing document line item can bedeleted) in the ERCHARC table. If you start the report in test mode, thechanges to the database described above are not carried out and thesystem just displays a detailed overview (you can set the level ofdetail) of the documents whose line items you can archive.

            Starting the program
            When you start the report you can make various settings on the initialscreen:
            Log type: general statistical data, detail log with detailed data foreach analyzed record (can become confusing with large amounts of data)or detail log with detailed data for documents that could not bearchived.
            Test run: If you start the report as a test run, no changes are made tothe database (updating the archiving indicator, writing to the archivefile, etc.).
            Comment on archive run: here you can enter an individual comment for anarchiving run.

            Error messages specific to the report (for system administrators)
            If one of the following system messages occurs while the program isrunning, proceed as follows:

            • Program stop: error opening the archive file

              • The system could not open a new archive file.
              Get rid of the reason for the error message and restart the archivingreport.
              • Program stop: error reading archive information

                • After the system opens a new archive file, it reads system data from thefile. In this case this was not possible.
                Get rid of the reason for the error message and restart the archivingreport.
                • Program stop: Error updating the archiving indicator in the ERCHARC
                  • table
                  A list of billing document numbers is displayed with this error message.The line could not be inserted in one of these billing documents.
                  Find out for which billing documents the archiving indicator could notbe inserted and get rid of the reason for the error message. Restart theanalysis report.
                  • Program stop: error closing the archive file

                    • The archive file could not be closed. Get rid of the reason for theerror message. Restart the analysis report.