Ansicht
Dokumentation

CHANGEDOCUMENT_READ_ONLY - Änderungsbeleg Änderungsbeleg lesen und aufbereiten

TXBHW - Original Tax Base Amount in Local Currency BAL Application Log Documentation
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Der Funktionsbaustein liest Änderungsbelegheader und -positionen. Es findet keine Aufbereitung statt.

Als Mindesteingabe wird die Objektklasse erwartet.

ACHTUNG Performance-Hinweis:

Um den Zugriff auf die gesuchten Änderungsbelege 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.

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.

Werden mehr CDHDR und CDPOS Einträge gelesen, als in dem Parameter READ_MAX vorgegeben, dann bricht der Funktionsbaustein mit der Ausnahme READ_TOO_MANY_ENTRIES ab. Die gelesenen Daten sind unvollständig und können nicht verwendet werden.

Beispielaufruf:

DATA: gt_cdhdr TYPE TABLE OF cdhdr,
      gt_cdpos TYPE TABLE OF cdpos,
      gt_cdpos_uid TYPE TABLE OF cdpos_uid,
      gt_cdpos_str TYPE TABLE OF cdpos_str,

...

CALL FUNCTION 'CHANGEDOCUMENT_READ_ONLY'
    EXPORTING
*     ARCHIVE_HANDLE                 = 0
*     CHANGENUMBER                     = ' '
      date_of_change                   = datum
      objectclass                      = objekt
      objectid                         = objektid
      tablekey                         = tabkey
     tablename                        = tabname
      time_of_change                   = zeit
      username                         = aenderer
*      LOCAL_TIME                       =
*      TIME_ZONE                        = 'UTC'
     tablekey254                      = tabkeylo
      keyguid                          = keyguid
      date_until                       = dat_bis
      time_until                       = zeit_bis
      keyguid_str                      = key_exp
*     READ_CHANGEDOCU                  = ' '
      NO_INITIAL_VALUES                = p_init
   IMPORTING
      et_cdhdr                         = gt_cdhdr
      et_cdpos                         = gt_cdpos
      et_cdpos_uid                     = gt_cdpos_uid
      et_cdpos_str                     = gt_cdpos_str
    EXCEPTIONS
      no_position_found                = 1
     wrong_access_to_archive          = 2
      time_zone_conversion_error       = 3
      OTHERS                           = 4
            .

...

Parameter

CHANGENUMBER
DATE_OF_CHANGE
DATE_UNTIL
ET_CDHDR
ET_CDPOS
ET_CDPOS_STR
ET_CDPOS_UID
IARCHIVE_HANDLE
I_HOT
KEYGUID
KEYGUID_STR
LOCAL_TIME
NOPLUS_ASWILDCARD_INOBJID
NO_INITIAL_VALUES
OBJECTCLASS
OBJECTID
READ_CHANGEDOCU
READ_MAX
TABLEKEY
TABLEKEY254
TABLENAME
TIME_OF_CHANGE
TIME_UNTIL
TIME_ZONE
USERNAME

Ausnahmen

NO_POSITION_FOUND
READ_TOO_MANY_ENTRIES
TIME_ZONE_CONVERSION_ERROR
WRONG_ACCESS_TO_ARCHIVE

Funktionsgruppe

SCD2

rdisp/max_wprun_time - Maximum work process run time Addresses (Business Address Services)
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 9541 Date: 20240523 Time: 183613 sap01-206 ( 69 ms )