Ansicht
Dokumentation

ARCHIVE_OPEN_FOR_MOVE - Datenobjekte in eine neue Archivdatei schreiben und/oder zurückladen

TXBHW - Original Tax Base Amount in Local Currency   CL_GUI_FRONTEND_SERVICES - Frontend Services  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Dieser Funktionsbaustein dient dazu, Archivdateien zu lesen und Datenobjekte aus diesen Archivdateien in neue Archivdateien zu schreiben. Dies erleichtert das selektive Rückladen von einzelnen Datenobjekten aus Archiven in das SAP-System.

Als Ergebnis dieses Funktionsbaustein erhalten Sie zwei Handles:

• Mit dem ARCHIVE_READ_HANDLE können Sie arbeiten, als hätten Sie diesen Handle über den Funktionsbaustein ARCHIVE_OPEN_FOR_READ erhalten. Sie können also alle lesenden Operationen ausführen.

• Der Handle, der über den Parameter ARCHIVE_WRITE_HANDLE zurückgeliefert wird, dient dazu, Datenobjekte, die nicht in die Datenbank zurückgeschrieben werden sollen, in das neue Archiv zu schreiben. Deshalb dürfen Sie mit diesem Handle nur den Funktionsbaustein ARCHIVE_SAVE_OBJECT aufrufen.

Beispiele

• Beispiel 1
  
  

DATA: READ_HANDLE LIKE SY-TABIX,

      SAVE_HANDLE LIKE SY-TABIX.

...

CALL FUNCTION 'ARCHIVE_OPEN_FOR_MOVE'

     EXPORTING

          OBJECT               = 'BELEG'

     IMPORTING

          ARCHIVE_READ_HANDLE  = READ_HANDLE

          ARCHIVE_WRITE_HANDLE = SAVE_HANDLE

     EXCEPTIONS

          FILE_ALREADY_OPEN    = 01

          FILE_IO_ERROR        = 02

          INTERNAL_ERROR       = 03

          NO_FILES_AVAILABLE   = 04

          OBJECT_NOT_FOUND     = 05

          OPEN_ERROR           = 06.

• Beispiel 2
  Ein ausführliches Beispiel finden Sie in dem Programm RSARCH07.

Weitere Hinweise

Die Vorgehensweise bei Rückladeprogrammen wird durch den Einsatz dieses Funktionsbausteins sehr einfach.

Jeder Aufruf des Funktionsbausteins ARCHIVE_SAVE_OBJECT mit dem Handle ARCHIVE_WRITE_HANDLE schreibt genau die Daten in die neue Archivdatei, die zuvor mit dem Funktionsbaustein ARCHIVE_GET_NEXT_OBJECT und dem Handle ARCHIVE_READ_HANDLE gelesen wurden.

Man liest ganz normal die ausgewählten Archivdateien und entscheidet sich, ob das Datenobjekt in die Datenbank zurückgeladen wird. Wollen Sie das Datenobjekt nicht zurückladen, dann rufen Sie einfach nur den Funktionsbaustein ARCHIVE_SAVE_OBJECT auf, und alle Daten zu diesem Datenobjekt werden in eine neue Archivdatei geschrieben.

Parameter

ARCHIVE_NAME
ARCHIVE_READ_HANDLE
ARCHIVE_WRITE_HANDLE
OBJECT
TEST_MODE

Ausnahmen

ARCHIVING_STANDARD_VIOLATION
FILE_ALREADY_OPEN
FILE_IO_ERROR
INTERNAL_ERROR
NOT_AUTHORIZED
NO_FILES_AVAILABLE
OBJECT_NOT_FOUND
OPEN_ERROR

Funktionsgruppe

ARCH

General Data in Customer Master   PERFORM Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 5687 Date: 20240523 Time: 132850     sap01-206 ( 56 ms )