Fonction SAP ARCHIVE_REGISTER_STRUCTURES - Dynamic Registration of Dictionary Structures

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
ARCHIVE_HANDLE SYST-TABIX I 4 Handle to the Open Archive Files

Paramètre Reférence Long. Facultatif Description
RECORD_STRUCTURES ARCH_DDIC 30 Structure of Table Type from DDIC

Exception Description
NO_NEW_STRUCTURES_PERMITTED Call Outside Initialization Phase
WRONG_ACCESS_TO_ARCHIVE Invalid Operation with Archive Handle

Functionality
During the write phase, this function module informs the ArchiveDevelopment Kit (ADK) dynamically of the structures in which data is tobe archived.
This function is useful if structures for archiving objects andarchiving classes are not known until runtime. These structures cannotbe entered in transaction AOBJ or ACLA because the names are not known.
Calling this function module is only permitted during theinitialization phase:

  • Calling the function module is permitted for the write program once
  • function module ARCHIVE_OPEN_FOR_WRITE has been called andbefore function module ARCHIVE_NEW_OBJECT has been called forthe first time.
    • An archiving class can call the function module within the
    • subroutine _INIT_WRITE and <
      CLASS>_POST_INIT_WRITE.

      Notes

      • The structures whose names are to be passedto the function module must
      • be defined in the ABAP Dictionary.
        • The structures in which the data is to be archived should, as far as
        • possible, be specified statically in transaction AOBJ or ACLA. Onlythen is it possible to gain an overview of the relationship between a
          rchiving objects or archiving classes and the tables in the database.
          • An archiving object or an archiving class can determine the structures
          • that were made known to the system by the archiving object or archivingclass during the write phase using function moduleARCHIVE_GET_STRUCTURES.
            INCLUDE 'ARCHIVE_PARAM_HANDLE_WRITE' OBJECT DOKU ID TX

            Description
            This table contains the names of the structures in which data is to bearchived and that were not specified statically in the system.

            Value range
            The structures must be known to the ABAP Dictionary. The recognitioncheck in the ABAP Dictionary does not yet take place within thisfunction module.