9.3    Open-SQL-Anweisungen 

Wie erwähnt, modifizieren Sie von Tabelleninhalten mithilfe von Open-SQL-Anweisungen. Open-SQL-Anweisungen sind spezielle ABAP-Anweisungen, von denen Sie als Beispiel die SELECT-Anweisung bereits kennen. Durch die Kapselung haben die Open-SQL-Anweisungen eine einheitliche ABAP-Syntax für alle zertifizierten Datenbanksysteme. Programme mit diesen Anweisungen laufen auch dann ohne Anpassungen, wenn das darunterliegende Datenbanksystem durch ein anderes ausgetauscht werden sollte. Allerdings ist hierfür Voraussetzung, dass alle Datenbankobjekte über das ABAP Dictionary angelegt und verwaltet wurden und werden.

Eine Datenbanktabelle für Anwendungsdaten hat als erstes Schlüsselfeld immer die Mandantennummer; nur Systemtabellen sind mandantenunabhängig. Grundsätzlich haben Open-SQL-Anweisungen eine automatische Mandantenbehandlung und gelten damit nur für den aktuellen Mandanten. Mit der automatischen Mandantenbehandlung ist es nicht möglich, aus einem Mandanten heraus die Daten eines anderen Mandanten zu selektieren oder zu modifizieren.

Für den Einstieg in ABAP sind außer der SELECT-Anweisung zum Lesen von Daten folgende Anweisungen zur Modifikation von Tabelleninhalten wichtig:

• Möchten Sie neue Zeilen, d. h. neue Datensätze, in eine Tabelle einfügen, verwenden Sie das INSERT-Kommando.

• Soll ein bestehender Datensatz verändert werden, dient hierzu der UPDATE-Befehl.

• Mit der MODIFY-Anweisung arbeiten Sie, wenn Sie nicht sicher sind, ob es diesen Satz in der Tabelle bereits gibt oder nicht. Für den Fall, dass er bereits existiert, wird er geändert; die Anweisung wirkt dann wie das UPDATE-Kommando. Für den Fall, dass der Datensatz noch nicht existiert, wirkt die MODIFY-Anweisung wie ein INSERT-Kommando.

• Sollen Datensätze aus der Datenbanktabelle gelöscht werden, verwenden Sie das DELETE-Kommando. Aber Vorsicht: Auch ganze Tabelleninhalte lassen sich mit der DELETE-Anweisung löschen und sind dann unwiederbringlich verloren.

All diese genannten Anweisungen liefern einen Returncode und füllen damit das Systemfeld SY-SUBRC. Unmittelbar nach der jeweiligen Anweisung kann das Feld SY-SUBRC im Debugger geprüft oder im Quellcode abgefragt werden. Je nach Inhalt des Tabellenfeldes wird die Aktion bewertet und entschieden, wie der weitere Ablauf sein soll. Für den Fall, dass die Anweisung formal vom System ohne Probleme ausgeführt werden konnte, erhält das Feld SY-SUBRC den Wert 0.

Der Returncode einer Anweisung mit dem Wert 0 ist, nebenbei bemerkt, auch in anderen Programmiersprachen meistens der Wert für den »Okay-Fall«. Kann das System die Anweisung nicht ausführen, meldet es einen anderen Returncode zurück, wobei es vom speziellen Kommando abhängig ist, welcher Wert für den Returncode geliefert wird. Außerdem müssen Sie in der Referenz oder der Hilfe zum Kommando nachlesen, welcher Wert welchen Fehler beschreibt. Je nach Art des Fehlers ist in der Programmlogik der weitere Ablauf des Programms zu steuern. Beispiele hierzu finden Sie in Kapitel 10, »Programmablaufsteuerung und logische Ausdrücke«. Für weitere Informationen sei auf die ABAP-Referenz (SAP PRESS, 3. Auflage 2010) verwiesen.

 

9.3.1    Neuen Datensatz anlegen 

Mit der INSERT-Anweisung können Sie einen oder mehrere neue Datensätze in eine Datenbanktabelle einfügen. Der Einfachheit halber beschränken wir uns bei dieser und den anderen Open-SQL-Anweisungen auf die Arbeit mit einzelnen Datensätzen.

Um mit den Tabelleninhalten zu arbeiten, deklarieren Sie zunächst eine Workarea, deren Struktur der der Tabelle entspricht. Dann ermitteln Sie alle Feldwerte des neuen Datensatzes und füllen anschließend die Workarea mit dem Datensatz, der als neue Zeile in die Datenbanktabelle geschrieben werden soll. Danach kopieren Sie den Inhalt der Workarea als neue Zeile in die Datenbanktabelle.

Der Aufbau der Struktur für die Workarea und der Struktur des Tabellenbereichs ist sinnvollerweise identisch, was Sie am einfachsten dadurch erreichen, dass Sie sich bei der Deklaration der Workarea auf die Tabelle als zugrundeliegenden Datentyp beziehen. Workareas werden mit der DATA-Anweisung deklariert.

Bei der Namensvergabe für Workareas sind Sie lediglich wieder an die allgemeinen Namenskonventionen gebunden. Für die bessere Lesbarkeit des Quellcodes wird aber empfohlen, den Namen der Workarea mit WA_ beginnen zu lassen. Möchten Sie die Workarea WA_ZTEILNEHMER02 anlegen, und soll diese strukturgleich mit der Tabelle ZTEILNEHMER02 sein, lautet die DATA-Anweisung:

DATA wa_zteilnehmer02 TYPE zteilnehmer02.

ZTEILNEHMER02 ist hier in einer Doppelrolle. Als Datenbanktabelle im ABAP Dictionary ist ZTEILNEHMER02 ein globaler Datentyp und sollte mit TYPE referenziert werden; gäbe es im Programm eine Deklaration als Tabellenarbeitsbereich mit der obsoleten TABLES-Anweisung, so würde ein gleichnamiges Datenobjekt im Programm existieren, das Sie mit LIKE referenzieren könnten. Davon – und generell von solchen impliziten Doppelrollen – möchten wir aber aus Gründen der Verständlichkeit abraten.

Nach der Deklaration der Workarea ermitteln Sie die Werte für die Felder des neuen Satzes und legen die Ergebnisse in der Workarea ab. Steht der neue Satz vollständig aufgebaut in der Workarea, wird er von dort aus in die Datenbanktabelle übertragen; in unserem Beispiel wird die Workarea WA_ZTEILNEHMER02 gefüllt. Der neue Datensatz in der Datenbanktabelle ZTEILNEHMER02 wird mit folgendem Kommando eingefügt:

INSERT zteilnehmer02 FROM wa_zteilnehmer02.

In dieser Schreibweise könnte der Name der Datenbanktabelle auch dynamisch angegeben werden: Dann steht in der Anweisung anstelle des Tabellennamens ein Feldname, und der Inhalt des Feldes ist der Name der Datenbanktabelle. Angenommen, das Feld ZIELTABELLE wäre ein Feld vom Typ c und hätte als Inhalt ZTEILNEHMER02, dann könnte die Anweisung auch lauten:

INSERT (zieltabelle) FROM wa_zteilnehmer02.

Die Variable, in der die zu füllende Tabelle steht, in unserem Beispiel die Variable ZIELTABELLE, muss aus semantischen Gründen ohne Leerzeichen in Klammern stehen.

Hat die Übertragung funktioniert, wird die Workarea bei Bedarf mit der CLEAR-Anweisung initialisiert und für den nächsten Datensatz neu aufgebaut. Hierdurch erreichen Sie eine vollständige Trennung zwischen dem Arbeitsbereich für den zuletzt gelesenen Tabellensatz und dem für den neuen Tabellensatz.

In älteren Programmen finden Sie noch die Deklaration ohne Angabe einer Workarea mit der TABLES-Anweisung sowie das anschließende Schreiben einer neuen Zeile in die Tabelle:

TABLES zteilnehmer02.

Hiermit wird in Ihrem Programm nicht nur die Verwendung der Tabelle ZTEILNEHMER02 deklariert, sondern auch ein Datenobjekt angelegt, das die Eigenschaften einer globalen Variablen besitzt und die gleiche Struktur aufweist wie die Datenbanktabelle – so als hätten Sie deklariert:

DATA zteilnehmer02 TYPE zteilnehmer02.

Ist ein Tabellenarbeitsbereich deklariert, fungiert dieser daher implizit auch als Workarea für die jeweilige Tabelle. Das bedeutet, dass Sie bei der INSERT-Anweisung auf die Angabe der Workarea verzichten können – das System verwendet immer die implizit deklarierte Workarea, die den gleichen Namen besitzt wie die Datenbanktabelle:

INSERT zteilnehmer02.

In der regulären Notation wäre dies gleichbedeutend mit folgender Anweisung:

INSERT zteilnehmer02 FROM zteilnehmer02.

In der Kurzschreibweise ohne die Angabe der Workarea muss nur der Name der Datenbanktabelle direkt angegeben werden. Wie beschrieben, können Sie unmittelbar nach dem Kommando den Returncode abfragen, der im Systemfeld SY-SUBRC eingetragen wurde. Falls er 0 ist, hat das System die Anweisung formal problemlos ausführen können. Kann das System keine neue Zeile in die Datenbanktabelle einfügen, weil bereits ein Datensatz mit diesem Primärschlüssel vorhanden ist, wird SY-SUBRC auf 4 gesetzt.

Bei der Verwendung des Tabellenarbeitsbereichs als Puffer für einen neuen Datensatz müssen Sie leider einige Risiken in Kauf nehmen. Wenn beispielsweise beim neuen Datensatz weniger Felder gefüllt sind als beim alten, stellt sich die Frage, wie Sie sicherstellen, dass wirklich alle Felder der Satzstruktur den richtigen, neuen Inhalt bekommen und keine unerwünschten Mischformen entstehen. Ein anderes Beispiel: Für die Ermittlung von Ergebnissen oder Zwischenergebnissen benötigen Sie gleichzeitig wechselweise Werte aus dem alten und dem neuen Satz. Wie gewährleisten Sie, dass Sie so lang wie nötig auf die alte Satzstruktur noch zugreifen können und gleichzeitig bereits die neue Struktur aufbauen?

Die Lösung für das Problem aus dem ersten Beispiel ist relativ einfach: Bevor Sie beginnen, die neue Satzstruktur zu füllen, löschen Sie den Inhalt des Tabellenarbeitsbereichs mit der CLEAR-Anweisung. Möchten Sie den Tabellenarbeitsbereich für die Tabelle ZTEILNEHMER02 löschen, lautet die Anweisung:

CLEAR zteilnehmer02.

Die Anweisung CLEAR setzt alle Felder des Tabellenbereichs auf ihre typbezogenen Initialwerte zurück. Beispielsweise erhalten Felder mit dem Datentyp c, d. h. Character-Felder, als Initialwert ein Leerzeichen (' ') und Felder mit dem Datentyp d, hierbei handelt es sich um Datumsfelder, den Initialwert '00000000'.

 

9.3.2    Bestehenden Datensatz ändern 

Auch mit einem UPDATE-Kommando können mehrere Datensätze gleichzeitig geändert werden; wir beschränken uns allerdings auf die Änderung eines Satzes. Arbeiten Sie mit einer Workarea, modifizieren Sie die Workarea und aktualisieren die entsprechende Zeile der Datenbank mit dem folgenden Ausdruck:

UPDATE zteilnehmer02 FROM wa_zteilnehmer02.

In der traditionellen Schreibweise bauen Sie den Tabellenarbeitsbereich auf und ändern die jeweilige Zeile in der Datenbanktabelle. In unserem Beispiel modifizieren Sie den Tabellenarbeitsbereich für die Tabelle ZTEILNEHMER02 und aktualisieren die jeweilige Zeile der Datenbanktabelle:

UPDATE zteilnehmer02.

Existiert ein Datensatz in der Datenbanktabelle mit demselben Primärschlüssel, wird dieser Satz aktualisiert, und der zurückgelieferte Returncode hat den Wert 0. Findet das System keinen Satz mit diesem Primärschlüssel in der Datenbanktabelle, bleibt die Tabelle unverändert, und der Returncode erhält den Wert 4.

 

9.3.3    Datensatz modifizieren 

Das MODIFY-Kommando dient sowohl zur Anlage eines neuen Satzes als auch zur Modifikation eines bestehenden. Das MODIFY-Kommando hat damit zwei verschiedene Wirkungsweisen und ist von der Performance her schlechter als die jeweiligen Spezialisten INSERT und UPDATE, weshalb Sie es nur dann verwenden sollten, wenn die Programmlogik es erfordert, beide Möglichkeiten offenzuhalten. Grundsätzlich sollten Sie den Einsatz der speziellen Anweisungen INSERT und UPDATE dem MODIFY-Kommando vorziehen.

Auch bei der MODIFY-Anweisung verwenden Sie normalerweise eine Workarea, damit Ihr Code ebenfalls mit ABAP Objects kompatibel ist und jederzeit im Kontext von ABAP-Klassen laufen kann:

MODIFY zteilnehmer02 FROM wa_zteilnehmer02.

Bei dieser Schreibweise könnten Sie den Tabellennamen wieder dynamisch angeben; auch alle übrigen Regeln und Anmerkungen gelten analog zu den Hinweisen bei INSERT und UPDATE.

Natürlich existiert auch die MODIFY-Anweisung in der traditionellen Schreibweise, d. h. in Verbindung mit einem mit der TABLES-Anweisung deklarierten Tabellenarbeitsbereich. Die Anweisung lautet dann:

MODIFY zteilnehmer02.

Der Primärschlüssel des Datensatzes ergibt sich aus den Feldinhalten des Tabellenarbeitsbereichs. Existiert in der Datenbanktabelle noch kein Datensatz mit diesem Primärschlüssel, wird eine neue Zeile angelegt. Ist ein Datensatz mit diesem Primärschlüssel bereits vorhanden, wird die entsprechende Zeile mit den Inhalten des Tabellenarbeitsbereichs aktualisiert. In beiden Fällen ist der Wert für den Returncode 0. Nur wenn die Zeile überhaupt nicht bearbeitet werden konnte, erhält der Returncode den Wert 4.

 

9.3.4    Datensatz löschen 

Wie in der Einleitung dieses Kapitels bereits erwähnt, kann mit dem DELETE-Kommando versehentlich viel Unheil angerichtet werden. Dies sollte allerdings nicht dazu führen, das Löschen zu vermeiden, stattdessen müssen Sie beim Löschen eines oder mehrerer Datensätze besonders risikobewusst planen, entwickeln und testen – dies betrifft auch nachträgliche Programmänderungen.

Beginnen wir wieder mit dem Normalfall, dem Löschen eines Datensatzes der Datenbanktabelle unter Verwendung einer Workarea. Es müssen nicht alle Felder der Workarea mit den richtigen Inhalten gefüllt sein; die Angabe des zutreffenden Primärschlüssels genügt. In unserem Beispiel der Tabelle ZTEILNEHMER02 besteht der Primärschlüssel aus dem Mandanten und der Teilnehmernummer. Durch die automatische Mandantenbehandlung müssen Sie sich nicht um den richtigen Mandanten kümmern, sondern es genügt die Angabe der Teilnehmernummer, um den Primärschlüssel festzulegen. Sie füllen in der Workarea das Feld für die Teilnehmernummer mit der zu löschenden Teilnehmernummer, dann löschen Sie die entsprechende Zeile in der Datenbanktabelle:

DELETE zteilnehmer02 FROM wa_zteilnehmer02.

Bei dieser Schreibweise können Sie den Namen der Datenbanktabelle wieder dynamisch angeben; die übrigen Regeln und Anmerkungen gelten analog zu den Hinweisen bei INSERT, UPDATE und MODIFY.

Das Löschen eines Datensatzes in der veralteten Schreibweise mit Nutzung eines mit TABLES deklarierten Tabellenarbeitsbereichs geschieht analog zu den vorherigen Beispielen:

DELETE zteilnehmer02.

Bei dieser Schreibweise wird der Tabellenname wieder statisch angegeben. Der Primärschlüssel des zu löschenden Datensatzes ergibt sich aus den Feldinhalten des Tabellenarbeitsbereichs. Findet das System in der Datenbanktabelle eine Zeile mit diesem Primärschlüssel, wird sie gelöscht und der Returncode auf 0 gesetzt. Falls das System keine solche Zeile findet, erhält der Returncode den Wert 4.

Wenn Sie, wie in Abschnitt 7.3.1, »Append-Strukturen pflegen«, vorgeschlagen, Ihre Tabelle erweitert haben, sind dort auch Kursbezeichnungen mit dem Kurstitel gespeichert. Angenommen, ein Kurs fällt aus – z. B. der Kurs zur »Netzwerktechnik« –, und Sie müssen alle Teilnehmer dieses Kurses aus der Tabelle löschen, dann kommen Sie durch die Formulierung einer Bedingung schneller zum Ziel. Allerdings muss diese Bedingung sehr sorgfältig programmiert werden, damit nicht versehentlich die falschen Datensätze gelöscht werden.

In unserem Beispiel ist die Schreibweise von »Netzwerktechnik« daher für den Erfolg ausschlaggebend, und Sie sollten genau überlegen, wie das Literal auszusehen hat: Heißt es 'NETZWERKTECHNIK' oder 'Netzwerktechnik'? Entsprechend würde Ihre Anweisung lauten:

DELETE FROM zteilnehmer02
  WHERE zzkurstitel = 'Netzwerktechnik'.