Ansicht
Dokumentation

GLE_ECS_DB_ITEM_WRITE_CHG_DOC - Änderungsbeleg schreiben

CPI1466 during Backup   TXBHW - Original Tax Base Amount in Local Currency  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Der Funktionsbaustein erstellt zum angegebenen Änderungsbelegobjekt (Parameter I_OBJECTCLAS) für das betriebswirtschaftliche Objekt mit dem Objektwert (Parameter I_OBJECTID) einen Änderungsbeleg.

Intern ruft das System die Funktionen der Basis zum Erstellen von Änderungsbelegen auf. Die Änderungsbelege legt das System entsprechend in zwei Tabellen ab. Die erste Tabelle CDHDR beinhaltet die Kopfinformationen, wie beispielsweise die Folgenden:

• Objektklasse

• Objektwert

• Änderungsdatum

Die zweite Tabelle CDPOS beinhaltet beispielsweise die folgenden Positionen:

• den Tabellen- und Feldnamen des geänderten Feldes

• den alten und den neuen Wert

Der Funktionsbaustein unterscheidet, ob es sich um einen Erfass-, Lösch- oder Änderungsvorgang handelt:

• Beim Erfassen erstellt das System nur einen Änderungsbeleg mit den Schlüsselinformationen des erfassten Satzes.

• Beim Löschen stehen zwei Optionen zur Auswahl. Entweder erfolgt das Schreiben des Änderungsbelegs wie beim Erfassen, oder das System dokumentiert jedes, im ABAP Dictionary als änderungsbelegrelevant definierte Feld, des gelöschten Satzes (Einzelfelddokumentation).

• Beim Ändern erstellt das System für jedes, im ABAP Dictionary als änderungsbelegrelevant definierte Feld eine Änderungsbelegposition, die den alten und neuen Inhalt des Feldes dokumentiert.

Im Parameter I_TIMESTAMP geben Sie den Zeitstempel des Erstellens des Änderungsbelegs an.

Im Parameter I_USERNAME hinterlegen Sie den Benutzernamen des Änderers.

Im Parameter I_TCODE geben Sie die Transaktion an, in der die Änderung durchgeführt wurde.

Haben Sie vorgesehen, dass die Änderungsbelege auch in dem Verbuchungsschritt erstellt werden können, dann müssen Sie die Werte für diese Parameter dem Verbuchungsbaustein mitgeben. Der Zeitstempel des Erstellens des Änderungsbelegs sollte für alle in einer Datenbank-LUW (Geschäftsvorfall) erstellten Änderungsbelege identisch sein. Einen für die LUW einheitlichen Zeitstempel erhalten Sie über die Zeitstempelverwaltung (Funktionsbaustein BANK_API_TSTAMP_GET_TSTAMP). Dadurch erreichen Sie eine zusammenhängende Darstellung der Änderungen einer LUW.

Mittels der Parameter I_BUSINESSPROC und I_BUSINESSPROCID können Sie die Art und die Identifikation des Geschäftsvorfalls im Änderungsbeleg hinterlegen.

Der Änderungsindikator des Objektes I_OBJECT_CHANGE_INDICATOR kennzeichnet, ob das betriebswirtschaftliche Objekt erfasst (I), geändert (U) oder gelöscht (D) wird.

Dem Funktionsbaustein ist eine Änderung unter Angabe des alten, unveränderten und des neuen, veränderten Stands zu übergeben. Die Übergabe des alten und neuen Stands erfolgt immer pro Tabelle. Entsprechend der Festlegungen beim Definieren der Objektklasse muss die Übergabe der Änderungen je Tabelle in Form von Arbeitsbereich ("Single Case") oder internen Tabellen ("Multiple Case") erfolgen. Für 10 Tabellen (x={0...9}) stehen je vier Parameter zur Übergabe der Änderungsinformationen zur Verfügung.

Im Parameter I_TABNAMEx geben Sie den Namen der Tabelle an, zu der die Änderungen spezifiziert werden.

Im "Single Case" Fall müssen die übergebenen Arbeitsbereiche die Struktur der unter I_TABNAMEx angegebenen Tabelle besitzen. Für die Änderungsbelegerstellung werden nur solche Felder berücksichtigt, die im ABAP Dictionary als änderungsbelegrelevant definiert wurden.

Im "Multiple Case" Fall müssen Sie für die übergebenen Tabellen im ABAP Dictionary einen Standardtabellentyp angelegt haben, der auf eine Struktur mit folgendem Aufbau verweist:

.INCLUDE	Name der unter I_TABNAMEx angegebenen Tabelle
.INCLUDE ICDIND	Struktur für generierte Strukturen der Änderungsbelegverbucher

In der übergebenen Tabelle des neuen, veränderten Stands müssen Sie in jeder Tabellenzeile in dem Feld KZ, welches mit dem Einfügen des Includes ICDIND verfügbar gemacht wurde, den Änderungsindikator angeben.

Für die Änderungsbelegerstellung werden nur solche Felder berücksichtigt, die im ABAP Dictionary als änderungsbelegrelevant gekennzeichnet wurden.

Der Änderungsindikator der Tabelle I_CHANGE_INDICATORx gibt an, ob die Änderungen ein Erfassen (I), Ändern (U)oder Löschen (D) dokumentieren.

Beispiel

Hinweise

Weiterführende Informationen

Parameter

I_CHNGIND_ECS_ITEM
I_CHNGIND_FI_ITEM
I_CHNGIND_OBJECT
I_TAB_ECS_ITEM_NEW
I_TAB_ECS_ITEM_OLD
I_TAB_FI_ITEM_NEW
I_TAB_FI_ITEM_OLD
I_TCODE
I_USERNAME

Ausnahmen

FAILED

Funktionsgruppe

GLE_ECS_PER_ITEM

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

Length: 7054 Date: 20240523 Time: 081719     sap01-206 ( 110 ms )