Ansicht
Dokumentation

CHANGEDOCUMENT_READ_HEADERS - Änderungsbeleg Änderungsbelegheader lesen

BAL Application Log Documentation   ABAP Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.
Funktionalität

Der Funktionsbaustein ermittelt Änderungsbelegnummern mit den zugehörigen Header-Informationen für eine Objektklasse. Die Ermittlung kann durch Angabe verschiedener Parameter eingeschränkt werden (siehe Schnittstellenbeschreibung).

Die Änderungsbelege werden abhängig vom Parameter ARCHIV_HANDLE von der Datenbank (Voreinstellung) oder aus einem Archiv gelesen.

Zusätzlich kann man über den Parameter LOCAL_TIME festlegen, ob ein lokales Datum und eine lokale Zeit (bzgl. der lokalen Zeitzone des Benutzers) übergeben wird oder das Systemdatum und die Systemzeit (Standardeinstellung).

Wird über den Parameter TIME_ZONE eine Zeitzone mitgegeben, so wird diese statt der Systemzeit für die Umrechnung in die lokale Zeit verwendet. TIME_ZONE enthält die Zeitzone, in der die Änderungsbelege geschrieben wurden. Der Parameter TIME_ZONE wird nur ausgewertet, wenn LOCAL_TIME = 'X' ist.

Der Funktionsbaustein liest zu den gefundenen Header-Informationen die zugehörigen Positionen intern mit.

Wird anschließend der Funktionsbaustein CHANGEDOCUMENT_READ_POSITIONS mit den hier gelesenen Änderungsbelegnummern aufgerufen, so können die zugehörigen Positionen direkt aus den internen Tabellen gelesen werden. Ein erneuter Zugriff auf die Datenbank entfällt.

Deshalb bietet sich ein kombinierter Aufruf, wie in Report RSSCD100, an.

Sollen nur die Header-Informationen gelesen werden, so kann der Funktionsbaustein CHANGEDOCUMENT_READ_HDRS_ONLY verwendet werden.

Performance-Hinweis:

Um den Zugriff auf die gesuchten Header-Informationen zu beschleunigen, ist es sinnvoll, falls bekannt, folgende Suchkriterien mitzugeben: OBJECTCLAS und OBJECTID. Diese gehören zum Schlüssel der Tabelle CDHDR, die die Header-Informationen enthält.

Wird das Datum als Parameter mitgegeben, so kann die Suche mit einem Index, der zusätzlich das Datum enthält, auf der Tabelle CDHDR beschleunigt werden.

Wenn möglich sollte auf Wildcards in den Parameterwerten verzichtet werden.

Beispielaufruf:
DATA: OBJEKT     LIKE CDHDR-OBJECTCLAS,
      OBJEKTID   LIKE CDHDR-OBJECTID,
      AENDERER   LIKE CDHDR-USERNAME,
      DATUM      LIKE CDHDR-UDATE,
      ZEIT       LIKE CDHDR-UTIME,

DATA: ,,BEGIN OF ICDHDR OCCURS 50.
  ,,,,  INCLUDE STRUCTURE CDHDR.
DATA: ,,END OF ICDHDR.

CALL FUNCTION 'CHANGEDOCUMENT_READ_HEADERS'
  EXPORTING OBJECTCLASS     = OBJEKT
            OBJECTID        = OBJEKTID
            USERNAME        = AENDERER
            TIME_OF_CHANGE  = ZEIT
            DATE_OF_CHANGE  = DATUM
  TABLES    I_CDHDR         = ICDHDR
  EXCEPTIONS ...

Parameter

ARCHIVE_HANDLE
DATE_OF_CHANGE
DATE_UNTIL
I_CDHDR
I_HOT
LOCAL_TIME
NOPLUS_ASWILDCARD_INOBJID
OBJECTCLASS
OBJECTID
READ_CHANGEDOCU
TIME_OF_CHANGE
TIME_UNTIL
TIME_ZONE
USERNAME

Ausnahmen

NO_POSITION_FOUND
TIME_ZONE_CONVERSION_ERROR
WRONG_ACCESS_TO_ARCHIVE

Funktionsgruppe

SCD1

rdisp/max_wprun_time - Maximum work process run time   BAL Application Log Documentation  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 5520 Date: 20240523 Time: 154344     sap01-206 ( 63 ms )