Ansicht
Dokumentation

ARCHIVE_PUT_TABLE - Place Records in Current Data Object by Structure

ARCHIVE_PUT_TABLE - Place Records in Current Data Object by Structure

RFUMSV00 - Advance Return for Tax on Sales/Purchases   rdisp/max_wprun_time - Maximum work process run time  
This documentation is copyright by SAP AG.
SAP E-Book

Funktion

This function module transfers an internal table to the data object that was previously requested by function module ARCHIVE_NEW_OBJECT. Each line of the internal table is placed in the data object as a separate data record. All data records that are transferred to the data object are written together to the archive file when function module ARCHIVE_SAVE_OBJECTis called.

The function module belongs to the general functions of the ADK interface - that is, it can be called from the write program in an archiving object or from an archiving class. If it is called from an archiving class, it must be called within subroutine <CLASS>_GET_DATA: Here, the records are transferred by structure, including control information (RECORD_FLAGS or RECORD_FLAGS_TABLE) for the current class depending on the handle for the current data object.

Examples

  • Example 1
    Extract from a program for archiving FI documents.

TABLES: BKPF, BSEG, BSET, BVOR, BSEC, BSED.
DATA: HANDLE  LIKE SY-TABIX.
DATA: BEGIN OF BSEG_TAB OCCURS 10.
      INCLUDE STRUCTURE BSEG.
DATA: END OF BSEG_TAB.
...
  CALL FUNCTION 'ARCHIVE_PUT_TABLE'
     EXPORTING
          ARCHIVE_HANDLE          = HANDLE
          RECORD_FLAGS            = FLAGS
          RECORD_STRUCTURE        = 'BSEG'
     TABLES
          TABLE                   = BSEG_TAB
...

  • Example 2
    For a comprehensive example, refer to program RSARCH10 (write program for an archiving object) or the subroutine BC_DEMO_GET_DATA in archiving class BC_DEMO (function group DEMOCLASS)

Further Notes

(Only valid if the function module is called from an archiving object:) In the case of complex data objects, you may have to read and evaluate all data records before you can decide whether this data object is to be archived.

It is not necessary to note the data records or even the read the data records again from the database. You can, from the start, transfer the data records to the data object with this function module.

If you realize that you do not want to archive the data records that you have transferred, simply call function module ARCHIVE_NEW_OBJECT. This ensures that the data that you have transferred is discarded. Even the data that you have forwarded to the archiving classes for archiving is discarded.





Parameters

ARCHIVE_HANDLE
RECORD_FLAGS
RECORD_FLAGS_TABLE
RECORD_STRUCTURE
TABLE

Exceptions

INTERNAL_ERROR
INVALID_RECORD_STRUCTURE
WRONG_ACCESS_TO_ARCHIVE

Function Group

ARCH

CPI1466 during Backup   rdisp/max_wprun_time - Maximum work process run time  
This documentation is copyright by SAP AG.

Length: 4357 Date: 20240523 Time: 102747     sap01-206 ( 59 ms )