Ansicht
Dokumentation
SDOK_M_ENT_ACCESS_BEGIN - API Modell: Zugriff auf Entität beginnen
General Material Data TXBHW - Original Tax Base Amount in Local CurrencyDiese Dokumentation steht unter dem Copyright der SAP AG.
Funktionalität
Diese Funktion ist vor einem nicht-atomaren (d.h. zeitlich ausgedehnten, etwa im Rahmen eines User-Dialogs) Zugriff auf eine Modell-Entität aufzurufen, um die Integrität des Zugriffs zu gewährleisten. Nach dessen Beendigung muß dann die Funktion SDOK_M_ENT_ACCESS_END aufgerufen werden.
Folgende Operationen werden [noch nicht] durchgeführt:
- [Berechtigungsprüfung]: Noch nicht implementiert.
- (Nicht-)Existenzprüfung bei bestimmten Zugriffsmodi, z.B. bei Anlegen (Nichtexistenz) und Schreiben (Existenz). Im Modus Ersetzen wird die (Nicht-)Existenz nur ermittelt (Ausgabe in X_EXIST), führt aber in keinem Fall zu einem Fehler.
- CTS-Prüfung (Correction & Transport System, Langzeitsperre). Ist X_SHOW_OPTION gesetzt, so wird dem User, falls ändernder Zugriff verwehrt, lesender Zugriff aber erlaubt ist, der lesende Modus angeboten.
- Enqueue (Kurzzeitsperre). Im Modus Lesen ist diese Sperre optional (Parameter X_LOCK). Ist X_SELFEXCLUSIVE gesetzt und erfordert der Zugriffsmodus eine exklusive Sperre, so blockiert auch eine bestehende selbstexklusive Sperre im gleichen R/3-Modus den Zugriff.
- Als Typ der Entität kann auch ein kollektiver Typ (z.B. nicht "reale-PHIO-Klasse", sondern "IO-Klasse") übergeben werden. Sperre und ggf. Existenzprüfung erfolgen dann generisch für alle dadurch bezeichneten spezifischen Entitätstypen.
Beispiel
Hinweise
Es ist nicht notwendig, diese Funktion vor atomaren Operationen (z.B. für Original- und/oder Kopie-Entität bei SDOK_M_ENT_COPY) aufzurufen, da die API-Funktionen die notwendigen Prüfungen selbst durchführen. Es führt nicht zu Fehlern, ist aber ineffizient.
Weiterführende Informationen
Parameter
AVOID_TR_CHECKENTITY
MODE
ORDER
X_EXIST
X_LOCK
X_SELFEXCLUSIVE
X_SHOW_OPTION
Ausnahmen
ACCESS_REFUSEDBAD_ENTITY
ENTITY_IN_PROCESS
ENTITY_LOCKED
READ_ONLY
Funktionsgruppe
SDC_MODELVendor Master (General Section) BAL_S_LOG - Application Log: Log header data
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 2798 Date: 20240523 Time: 121515 sap01-206 ( 64 ms )