Ansicht
Dokumentation

ARCHIVE_NEW_OBJECT - Datenobjekt zum Schreiben anfordern

SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up   ABAP Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Dieser Funktionsbaustein ist immer dann aufzurufen, wenn ein neues Datenobjekt für das Schreiben in ein Archiv vorbereitet werden soll.

Je Handle kann es immer nur ein Datenobjekt geben. Beim Aufruf dieses Funktionsbausteins werden alle Daten des aktuellen Datenobjekts vergessen und alle zugehörigen Archivierungsklassen werden darüber informiert, daß alle folgenden Operationen zum Handle zu einem neuen Datenobjekt gehören.

Die Archivierungsklassen werden ihrerseits alle Informationen zum aktuellen Datenobjekt vergessen.

Es wird nicht geprüft, ob Sie das aktuelle Datenobjekt mit dem Funktionsbaustein ARCHIVE_SAVE_OBJECT gespeichert haben. Sie haben damit die Möglichkeit, ein Datenobjekt zu verwerfen, wenn Sie erst zu einem späten Zeitpunkt feststellen, daß die Daten noch nicht archiviert werden dürfen.

Beispiele

• Beispiel 1
  
  

DATA: HANDLE LIKE SY-TABIX.
...
CALL FUNCTION 'ARCHIVE_NEW_OBJECT'
     EXPORTING
          ARCHIVE_HANDLE          = HANDLE
     EXCEPTIONS
          INTERNAL_ERROR          = 01
          WRONG_ACCESS_TO_ARCHIVE = 02.

• Beispiel 2
  Ein ausfühliches Beispiel finden Sie in dem Programm RSARCH04.

Weitere Hinweise

Wenn Sie mit dem Funktionsbaustein ARCHIVE_PUT_RECORD versuchen, einen Datensatz an ein Datenobjekt anzuhängen, bevor mit diesem Funktionsbaustein ein Datenobjekt bereitgestellt wurde, wird die Ausnahme WRONG_ACCESS_TO_ARCHIVE ausgelöst.

Das gleiche passiert, wenn Sie mit dem Funktionsbaustein ARCHIVE_SAVE_OBJECT ein Datenobjekt abschließen und in die Archivdatei schreiben, danach aber versuchen, mit dem Funktionsbaustein ARCHIVE_PUT_RECORD noch einen Datensatz an das Datenobjekt anzuhängen.

Parameter

ARCHIVE_HANDLE
OBJECT_ID

Ausnahmen

INTERNAL_ERROR
WRONG_ACCESS_TO_ARCHIVE

Funktionsgruppe

ARCH

ABAP Short Reference   TXBHW - Original Tax Base Amount in Local Currency  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 3030 Date: 20240523 Time: 142922     sap01-206 ( 44 ms )