Ansicht
Dokumentation

ARCHIVE_DELETE_TABLE - Hilfsroutine für Löschprogramme

General Data in Customer Master   BAL Application Log Documentation  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Der Funktionsbaustein ARCHIVE_DELETE_TABLE dient zum tabellenweisen Löschen von Daten in Löschprogrammen von Archivierungsobjekten oder in den entsprechenden Löschroutinen von Archivierungsklassen. Er löscht aus der Datenbanktabelle IV_TABNAME die Datensätze, die in der internen Tabelle IT_RECORDS übergeben wurden.

Der Funktionsbaustein hat die folgenden Eigenschaften:

• ARCHIVE_DELETE_TABLE unterstützt das Löschen von Daten sowohl im Produktiv- als auch im Testmodus, siehe Parameter IV_DELTST.

• ARCHIVE_DELETE_TABLE löst selber keinen COMMIT aus.

• ARCHIVE_DELETE_TABLE kann für mehrere Archiv-Handle (ADK-Instanzen) aufgerufen werden und unterstützt das Löschen "ON COMMIT". Deshalb kann der Funktionsbaustein sowohl in Löschprogrammen von Archivierungsobjekten als auch direkt in den Löschroutinen von Archivierungsklassen verwendet werden (siehe auch Parameter IV_ON_COMMIT).

• Die Anzahl der gelöschten Datensätze pro Tabelle wird sowohl im Produktiv- als auch im Testmodus mit ARCHIVE_GIVE_STATISTICS fortgeschrieben, so dass Sie sich bei Verwendung des Funktionsbausteins ARCHIVE_DELETE_TABLE nicht mehr selber darum kümmern müssen.

• Der Funktionsbaustein prüft in der Strukturdefinition des jeweiligen Archivierungsobjekts, ob Daten aus der in IV_TABNAME übergebenen Datenbanktabelle gelöscht werden dürfen. Für diese Tabelle muss es mindestens eine Registrierung geben, die das Löschen explizit erlaubt. Falls dies nicht der Fall ist, dann wird die Ausnahme DELETION_NOT_ALLOWED ausgelöst. Es werden in diesem Fall auch keine Daten aus der Datenbank gelöscht.

Achtung: Beachten Sie, dass es zu dieser Tabelle eine weitere Registrierung geben kann, die das Löschen erlaubt. Sie dürfen dem Funktionsbaustein ARCHIVE_DELETE_TABLE also nur solche Daten zum Löschen übergeben, die Sie auch wirklich löschen wollen.
(Verwenden Sie gegebenenfalls die Record Flags, um ihre Daten in geeigneter Weise zu markieren. Siehe zum Beispiel Funktionsbaustein ARCHIVE_PUT_TABLE, Parameter RECORD_FLAGS und RECORD_FLAGS_TABLE.)

• ARCHIVE_DELETE_TABLE unterstützt keine dynamisch mit ARCHIVE_REGISTER_STRUCTURES registrierten Tabellen. Wenn sie ARCHIVE_DELETE_TABLE zum Löschen dynamisch registrierter Tabellen verwenden möchten, dann müssen Sie die Tabellen mit einer geeigneten Implementierung zur BAdI-Definition ARC_OBJECT_ADD_TABLE bzw. ARC_CLASS_ADD_TABLE dynamisch registrieren.

Beispiel

Hinweise

Beachten Sie, dass Sie dem ADK die Anzahl der bearbeiteten Datenobjekte im Gegensatz zu der Anzahl der Datensätze pro bearbeiteter Tabelle immer noch selber mit dem Funktionsbaustein ARCHIVE_GIVE_STATISTICS mitteilen müssen.

Weiterführende Informationen

Parameter

IT_RECORDS
IV_DELTST
IV_HANDLE
IV_ON_COMMIT
IV_TABNAME

Ausnahmen

DELETION_NOT_ALLOWED

Funktionsgruppe

ARCH_HIGHLEVEL

Addresses (Business Address Services)   BAL_S_LOG - Application Log: Log header data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 4705 Date: 20240523 Time: 124736     sap01-206 ( 81 ms )