Ansicht
Dokumentation

SDOK_M_ENT_ACCESS_BEGIN - API Modell: Zugriff auf Entität beginnen

SDOK_M_ENT_ACCESS_BEGIN - API Modell: Zugriff auf Entität beginnen

General Material Data   TXBHW - Original Tax Base Amount in Local Currency  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

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_CHECK
ENTITY
MODE
ORDER
X_EXIST
X_LOCK
X_SELFEXCLUSIVE
X_SHOW_OPTION

Ausnahmen

ACCESS_REFUSED
BAD_ENTITY
ENTITY_IN_PROCESS
ENTITY_LOCKED
READ_ONLY

Funktionsgruppe

SDC_MODEL

Vendor 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 )