Kontakt

Ansicht
Dokumentation

CBIH_WA30_PT_DELETE - EHS: Löschen von Schablonen

CBIH_WA30_PT_DELETE - EHS: Löschen von Schablonen

PERFORM Short Reference   Fill RESBD Structure from EBP Component Structure  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Funktionalität

Dieser Funktionsbaustein ist Teil des Application Programming Interface (API) der EH&S-Komponente Arbeitsschutz. Er dient dazu, eine Menge von Schablonen oder eine Menge von Teilobjekten von Schablonen zu löschen. Dabei bedeutet Löschen, daß das Löschkennzeichen (Feld DELFLG) der Objekte gesetzt wird. Ein physisches Löschen wird nicht durchgeführt.

Das Setzen des Löschkennzeichens wird nur innerhalb der Pufferdaten durchgeführt. Erst ein Aufruf des Funktionsbausteins CBIH_WA30_PT_SAVE_TO_DB und ein anschließendes Absetzen eines COMMIT WORK schreibt die Modifikationen endgültig in die Datenbank fort.

Objekte, die in SAP-internen Datenbanktabellen abgelegt werden (z.B. Merkmalswerte und Langtexte) können von diesem Baustein nicht gelöscht werden.

Schnittstelle

Eingabe

Mit Hilfe von Kennzeichen kann der Aufrufer festlegen, welche Teilobjekte einer Schablone er löschen möchte. Diese Kennzeichen sind entsprechend der folgenden logischen Hierarchie angeordnet:

Kennzeichen                          | korrespondierender
                                     | Tabellenparameter
-------------------------------------|---------------------------
                                     |
I_FLG_HEADER                         | X_API_HEADER_TAB
  |                                  |
  |--I_FLG_EXP_PROFILE               | X_API_EXP_PROFILE_TAB
 |--I_FLG_DESCRIPTION               | X_API_DESCRIPTION_TAB
  |--I_FLG_FREETEXT                  | X_API_FREETEXT_TAB
  |--I_FLG_WAQS_ASSIG                | X_API_WAQS_TAB
 |--I_FLG_PATTERN_ASSIG             | X_API_WAPT_TAB
  |--I_FLG_ACPATT_ASSIG              | X_API_PTCP_TAB
Der Aufrufer bestimmt zunächst, welche Teilobjekte er löschen will, indem er die zugehörigen boolschen Parameter auf "TRUE" setzt. ("TRUE" und "FALSE" sind als Konstanten im Include CBUI09 definiert.) Dann befüllt er die korrespondierenden Tabellenparameter mit den zu löschenden Teilobjekten. Dazu müssen die Tabellenparameter wie folgt befüllt werden:
  • In jeder Zeile muß das Feld RECN gefüllt sein.

  • Unterhalb der Schablonenkopfebene muß in jeder Zeile das Feld RECNROOT gefüllt sein.

  • Unterhalb der Schablonenkopfebene müssen die Fremdschlüsselfelder für die jeweils übergeordneten Teilobjekte gefüllt sein.

Der Funktionsbaustein ermittelt selbständig zu jedem zu löschenden Teilobjekt die jeweils abhängigen Teilobjekte und löscht diese ebenfalls. Ferner werden alle notwendigen Sperren gesetzt.
Es ist nicht sinnvoll, zugleich eine Tabelle und eine dazu untergeordnete Tabelle (gemäß der obigen Hierarchie) zu befüllen, da der Funktionsbaustein den Inhalt der untergeordneten Tabelle löscht und ihn mit den Teilobjekten, die vom Inhalt der übergeordneten Tabelle abhängen, neu befüllt.

Ausgabe

Boolsche Parameter weisen darauf hin, daß bei der Verarbeitung von Teilobjekten Fehler aufgetreten sind. Folgende Fehler können auftreten:

  • Sperrfehler: E_FLG_LOCKFAIL = TRUE
  • Verarbeitungsfehler: E_FLG_ERROR = TRUE
  • Verarbeitungswarnung: E_FLG_WARNING = TRUE

Ablauflogik

  1. Die Eingabedaten werden geprüft.
  2. Sperren werden abgesetzt und Eingabedaten so vervollständigt, daß stets komplette Teilobjekte von Schablonen gelöscht werden. Die Daten werden mittels CBIH_WA30_PT_READ gelesen.
  3. Löschkennzeichen werden mittels der BUF_WRITE-Funktionen der Pufferschicht gesetzt (z.B. mit CBIH_WA40_WAH_BUF_WRITE).

Mögliche Ausnahmen

  • NO_OBJECT_SPECIFIED: es wurde kein Objekt zur Löschung angegeben
  • PARAMETER_ERROR: fehlende Tabelle zu spezifiziertem Objekt
  • INTERNAL_ERROR: interner Verarbeitungsfehler
  • CONVMODE_SET_FAILED: Fehler bei der Zeichenkonvertierung




Parameter

E_FLG_ERROR
E_FLG_LOCKFAIL
E_FLG_WARNING
I_ADDINF
I_FLG_ACPATT_ASSIG
I_FLG_CHECK_ONLY
I_FLG_DESCRIPTION
I_FLG_EXP_PROFILE
I_FLG_FILL_EXTERROR
I_FLG_HEADER
I_FLG_PATTERN_ASSIG
I_FLG_WAQS_ASSIG
I_LSADM
X_API_DESCRIPTION_TAB
X_API_EXP_PROFILE_TAB
X_API_HEADER_TAB
X_API_PTCP_TAB
X_API_WAPT_TAB
X_API_WAQS_TAB

Ausnahmen

CONVMODE_SET_FAILED
INTERNAL_ERROR
NO_OBJECT_SPECIFIED
PARAMETER_ERROR

Funktionsgruppe

CBIH_WA30

rdisp/max_wprun_time - Maximum work process run time   General Data in Customer Master  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 8001 Date: 20240523 Time: 161540     sap01-206 ( 85 ms )