Ansicht
Dokumentation

ARCHIVE_GET_TABLE - Sätze strukturgerecht aus aktuellem Datenobjekt lesen

RFUMSV00 - Advance Return for Tax on Sales/Purchases   General Material Data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Dieser Funktionsbaustein liest mehrere Datensätze zur Struktur RECORD_STRUCTURE aus dem aktuellen Datenobjekt in die als Parameter angegebene interne Tabelle.
Auch in Zusammenhang mit logischen Datenbanken kann dieser Funktionsbaustein verwendet werden. Dabei ist zu beachten, daß der Parameter ALL_RECORDS_OF_OBJECT = ' ' ist.

Der Funktionsbaustein gehört zu den Allgemeinen Funktionen der ADK-Schnittstelle, d.h. er kann sowohl aus Programmen eines Archivierungsobjekts als auch aus einer Archivierungsklasse heraus aufgerufen werden. Wird der Funktionsbaustein in einem Le _put_data erfolgen: hier werden die Sätze der aktuellen Klasse (wiederum handle-abhängig bezogen auf das aktuelle Datenobjekt) gelesen.

• ALL_RECORDS_OF_OBJECT = ' '
  In diesem Fall funktioniert der Funktionsbaustein ähnlich wie der Funktionsbaustein ARCHIVE_GET_NEXT_STRUCT_SPECIF. Es werden sequenziell alle Datensätze zur angegebenen Struktur gelesen, bis sich die Struktur ändert. Alle gelesenen Datensätze werden in die Tabelle TABLE gestellt. Die dazugehörigen Flags werden in gleicher Ordnung in der Tabelle RECORD_FLAGS_TABLE abgelegt. Die Flags des zuletzt gelesenen Satzes werden im Parameter RECORD_FLAGS zurückgegeben.

• Weiterlesen

1. mit ARCHIVE_GET_NEXT_RECORD (nur im Kontext Archivierungsobjekt):
   Beim Weiterlesen mit ARCHIVE_GET_NEXT_RECORD wird automatisch der nächste ungelesene Datensatz gelesen.
2. beim nächsten Aufruf des Funktionsbausteins ARCHIVE_GET_TABLE
   Beim Weiterlesen mit ARCHIVE_GET_TABLE wird ab dem nächsten ungelesenen Datensatz gelesen.

• Wert von RECORD_CURSOR
  Der RECORD_CURSOR wird auf den letzten Datensatz gesetzt, der in die Tabelle eingelesen wurde.

• Terminierung
  Falls keine Sätze mehr zu der gewünschten Struktur existieren, wird die Ausnahme END_OF_OBJECT ausgelöst.

• ALL_RECORDS_OF_OBJECT = 'X'
  In diesem Fall liest der Funktionsbaustein alle Datensätze der angegebenen Struktur im gesamten Datenobjekt. Die gelesenen Datensätze werden in die interne Tabelle TABLE gestellt. Es ist egal, ob zwischen den Datensätzen mit der angegebenen Struktur RECORD_STRUCTURE Datensätze mit anderer Struktur stehen. Alle Datensätze zur angegebenen Struktur werden im aktuellen Datenobjekt gesammelt, egal an welcher Stelle sie im aktuellen Datenobjekt stehen.

• Weiterlesen

1. mit ARCHIVE_GET_NEXT_RECORD (nur im Kontext Archivierungsobjekt):
   Ein Weiterlesen mit ARCHIVE_GET_NEXT_RECORD ist möglich. Dabei wird völlig unabhängig von den Datensätzen, die mit ARCHIVE_GET_TABLE gelesen wurden, der nächste Datensatz gelesen - bezogen auf das zuletzt aufgerufene ARCHIVE_GET_NEXT_RECORD. Wurde ARCHIVE_GET_NEXT_RECORD noch nicht aufgerufen, so wird der erste Datensatz gelesen.
2. beim nächsten Aufruf des Funktionsbausteins ARCHIVE_GET_TABLE:
   Es werden wieder die gleichen Sätze gelesen wie beim vorausgehenden Aufruf von ARCHIVE_GET_TABLE.

• Wert von RECORD_CURSOR
  Es wird kein gültiger RECORD_CURSOR zurückgeliefert. Der RECORD_CURSOR erhält den Wert 0.

• Terminierung
  Falls keine Sätze zu der gewünschten Struktur existieren, werden die Tabellen TABLE und RECORD_FLAGS_TABLE ohne Zeilen zurückgegeben. Die Ausnahme END_OF_OBJECT wird nicht ausgelöst.

Beispiele

Ein ausführliches Beispiel finden Sie in den Programmen SBOOKR_3 und RSARCH11 (Leseprogramme eines Archivierungsobjekts) bzw. im Unterprogramm BC_DEMO_PUT_DATA (Archivierungsklasse BC_DEMO in Funktionsgruppe DEMOCLASS).

Parameter

ALL_RECORDS_OF_OBJECT
ARCHIVE_HANDLE
ARCHIVING_CLASS
AUTOMATIC_CONVERSION
RECORD_CURSOR
RECORD_FLAGS
RECORD_FLAGS_TABLE
RECORD_LENGTH
RECORD_STRUCTURE
TABLE

Ausnahmen

END_OF_OBJECT
INTERNAL_ERROR
WRONG_ACCESS_TO_ARCHIVE

Funktionsgruppe

ARCH

BAL_S_LOG - Application Log: Log header data   PERFORM Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 6381 Date: 20240523 Time: 143559     sap01-206 ( 98 ms )