Ansicht
Dokumentation

ARCHIVE_GET_OBJECT_BY_OFFSET - Lesen eines Datenobjektes aus einer Archivdatei

ARCHIVE_GET_OBJECT_BY_OFFSET - Lesen eines Datenobjektes aus einer Archivdatei

CL_GUI_FRONTEND_SERVICES - Frontend Services   rdisp/max_wprun_time - Maximum work process run time  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Funktionalität

Dieser Funktionsbaustein liest zu einem vorgegebenen Offset ein bestimmtes Datenobjekt aus einer Archivdatei und liefert einen Handle zur weiteren Bearbeitung zurück.

Nachdem das Datenobjekt mit ARCHIVE_GET_OBJECT_BY_OFFSET gelesen wurde, können Sie mit den Funktionsbausteinen ARCHIVE_GET_NEXT_RECORD, ARCHIVE_GET_NEXT_STRUCT_SPECIF über den Handle auf die Daten zugreifen.

Falls gewünscht, kann die Archivdatei anhand des Handle sequentiell mit dem Funktionsbaustein ARCHIVE_GET_NEXT_OBJECT weitergelesen werden.

Beispiel


DATA:
archive_key      TYPE arkey      VALUE '001469-001BC_SBOOK',
archive_offset   TYPE admi_offst VALUE 285884,
handle           LIKE sy-tabix.
...
CALL FUNCTION 'ARCHIVE_GET_OBJECT_BY_OFFSET'
   EXPORTING
     archivkey      = archive_key
     offset         = archive_offset
   IMPORTING
     archive_handle = handle
   EXCEPTIONS
...
DO.
   CALL FUNCTION 'ARCHIVE_GET_NEXT_RECORD'
...

Weitere Hinweise

Vor dem erneuten Aufruf des Funktionsbausteins muß ARCHIVE_CLOSE_FILE für den zurückgelieferten Handle aufgerufen werden, d.h. ARCHIVE_GET_OBJECT_BY_OFFSET ist nicht reentrant.

Weitere Informationsquellen

Weitere Informationen finden Sie in der SAP-Bibliothek:

SAP NetWeaver -> Application Platform (SAP Web Application Server) -→ ABAP-Technologie -→ ABAP Workbench -> BC - Erweiterte Funktionsbibliothek Anwendungen → Archive Development Kit





Parameter

ARCHIVE_HANDLE
ARCHIVKEY
EV_DATA_IS_BLOCKED
OFFSET

Ausnahmen

FILE_IO_ERROR
INTERNAL_ERROR
NOT_AUTHORIZED
NO_RECORD_FOUND
OBJECT_NOT_FOUND
OPEN_ERROR

Funktionsgruppe

ARCH

CL_GUI_FRONTEND_SERVICES - Frontend Services   BAL_S_LOG - Application Log: Log header data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 3504 Date: 20240605 Time: 130258     sap01-206 ( 42 ms )