Ansicht
Dokumentation

BANK_API_CHDOC_WRITE - Änderungsbeleg schreiben

Vendor Master (General Section)   RFUMSV00 - Advance Return for Tax on Sales/Purchases  
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 werden die Funktionen der Basis zum Erstellen von Änderungsbelegen aufgerufen. Die Änderungsbelege werden entsprechend in zwei Tabellen abgelegt. Die erste Tabelle (CDHDR) beinhaltet die Kopfinformationen, wie z.B. die Objektklasse, den Objektwert, das Änderungsdatum etc. Die zweite Tabelle (CDPOS) beinhaltet die einzelnen Positionen, also z.B. den Tabellen- und Feldnamen des geänderten Feldes, den alten und den neuen Wert etc.

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

Beim Erfassen wird nur ein Änderungsbeleg mit den Schlüsselinformationen des erfassten Satzes erstellt.

Beim Löschen stehen zwei Optionen zur Auswahl. Entweder erfolgt die Änderungsbelegschreibung wie beim Erfassen oder es wird jedes, im Data Dictionary als änderungsbelegrelevant definierte Feld des gelöschten Satzes dokumentiert (Einzelfelddokumentation).

Beim Ändern wird für jedes, im Data Dictionary als änderungsbelegrelevant definierte Feld eine Änderungsbelegposition erstellt, 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 den Benutzername des Änderers und im Parameter I_TCODE die Transaktion, in der die Änderung durchgeführt wurde. Haben Sie vorgesehen, dass die Änderungsbelege auch in der Verbuchungstask erstellt werden können, dann sind die Werte für diese Parameter bereits vor dem Aufruf des Verbuchungsbausteins zu besorgen und diesem Baustein dann mitzugeben. Der Zeitstempel des Erstellens des Änderungsbelegs sollte für alle in einer Datenbank-LUW (Geschäftsvorfall) erstellen Änderungsbelege identisch sein. Einen für die LUW einheitlichen Zeitstempel können Sie sich mittels der Zeitstempelverwaltung besorgen ( 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 Workareas ("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 Workareas die Struktur der unter I_TABNAMEx angegebenen Tabelle besitzen. Für die Änderungsbelegerstellung werden nur solche Felder berücksichtigt, die im Data Dictionary als änderungsbelegrelevant definiert wurden.

Im "Multiple Case" Fall muss für die übergebenen Tabellen im Data Dictionary ein Standardtabellentyp angelegt werden, der auf eine Struktur mit folgendem Aufbau verweißt:

.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 ist in jeder Tabellenzeile in dem Feld KZ, welches mit dem Einfügen des Includes ICDIND verfügbar gemacht wurde, der Änderungsindikator anzugeben.

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

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

Beispiel

Hinweise

Weiterführende Informationen

Parameter

I_BUSINESSPROC
I_BUSINESSPROCID
I_CHANGE_INDICATOR0
I_CHANGE_INDICATOR1
I_CHANGE_INDICATOR2
I_CHANGE_INDICATOR3
I_CHANGE_INDICATOR4
I_CHANGE_INDICATOR5
I_CHANGE_INDICATOR6
I_CHANGE_INDICATOR7
I_CHANGE_INDICATOR8
I_CHANGE_INDICATOR9
I_FLG_EMSG
I_OBJECTCLAS
I_OBJECTID
I_OBJECT_CHANGE_INDICATOR
I_TABNAME0
I_TABNAME1
I_TABNAME2
I_TABNAME3
I_TABNAME4
I_TABNAME5
I_TABNAME6
I_TABNAME7
I_TABNAME8
I_TABNAME9
I_TCODE
I_TIMESTAMP
I_UDATE
I_USERNAME
I_UTIME
I_WORKAREA_NEW0
I_WORKAREA_NEW1
I_WORKAREA_NEW2
I_WORKAREA_NEW3
I_WORKAREA_NEW4
I_WORKAREA_NEW5
I_WORKAREA_NEW6
I_WORKAREA_NEW7
I_WORKAREA_NEW8
I_WORKAREA_NEW9
I_WORKAREA_OLD0
I_WORKAREA_OLD1
I_WORKAREA_OLD2
I_WORKAREA_OLD3
I_WORKAREA_OLD4
I_WORKAREA_OLD5
I_WORKAREA_OLD6
I_WORKAREA_OLD7
I_WORKAREA_OLD8
I_WORKAREA_OLD9

Ausnahmen

INTERNAL_ERROR
NO_DOCUMENT_INSERTED
OBJECTCLASS_NOT_DEFINED
TABLE_NOT_DEFINED
TIME_ZONE_CONVERSION_ERROR
WRONG_WORK_AREA_TYPE

Funktionsgruppe

BANK_API_CHDOC_WRITE

Vendor Master (General Section)   General Material Data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 7849 Date: 20240523 Time: 101844     sap01-206 ( 149 ms )