11.6    Ergänzende Textobjekte 

Bevor Sie das Selektionsbild völlig frei gestalten können, benötigen Sie noch etwas Handwerkszeug: Textsymbole und Nachrichten.

 

11.6.1    Textsymbole anlegen 

Die Arbeit mit Textelementen kennen Sie bereits ein wenig aus Abschnitt 11.4, »Selektionstexte verwenden«. Die Möglichkeiten, wie Sie in den Pflegedialog der Textelemente gelangen, wurden dort ebenfalls beschrieben.

In diesem Umfeld gibt es nun noch eine dritte Art von Textelementen, die Textsymbole. Textsymbole ersetzen z. B. Literale bei der WRITE-Anweisung und ermöglichen die Mehrfachverwendung und die Übersetzung variabler Texte. Hartes Codieren von Literalen im Quellcode ist somit überflüssig, und Sie sollten es von nun an weitgehend vermeiden.

Textsymbole sind sozusagen Platzhalter für Texte. Im ABAP-Quellcode schreiben Sie beispielsweise nicht mehr:

WRITE: / 'Teilnehmer'.

Stattdessen schreiben Sie:

WRITE: / text-001.

Der Name eines Textsymbols besteht aus TEXT- und einer dreistelligen Nummer. Für einen Report sind in einer Sprache maximal 1.000 Textsymbole verwendbar, von denen jedes maximal 132 Stellen haben kann. In die Pflege der Textsymbole gelangen Sie entweder über die ABAP Workbench auf dem Weg über die Textelemente – wie bei den Selektionstexten beschrieben – oder durch Vorwärtsnavigation aus dem ABAP Editor. Ein Doppelklick auf das Textsymbol führt in den Pflegebildschirm der Textsymbole. In Abbildung 11.28 ist die Liste schon aktiv; die Textsymbole wurden bereits angelegt.

Abbildung 11.28    Pflegebildschirm der Textsymbole

Das System hat bereits für alle verwendeten Textsymbole Zeilen angelegt; die Zeilennummer entspricht der Nummer des Textsymbols. Sie müssen nur noch in der entsprechenden Zeile den Text eintragen, den Sie später im Selektionsbild sehen möchten.

Um die Einträge im veränderten Textpool später im Selektionsbild zu sehen, müssen Sie den Textpool zunächst wieder aktivieren ((Strg) + (F3)). Erst danach kehren Sie mit der Taste (F3) in den ABAP Editor zurück.

 

11.6.2    Nachrichten anlegen 

Nachrichten dienen überwiegend dem Dialog der Programmablaufsteuerung mit dem Benutzer, beispielsweise bei Falscheingaben im Selektionsbild. Um Nachrichten an den Anwender senden zu können, müssen Nachrichten in einer Nachrichtenklasse in der Systemtabelle T100 hinterlegt sein. Die Nachrichtenklasse gruppiert Nachrichten nach Arbeitsgebieten und fachlichen Gesichtspunkten; für Kunden ist der Kundennamensraum zu beachten. Kundenspezifische Nachrichtenklassen beginnen mit einem Z oder einem registrierten Namensraumpräfix. Über den Sprachenschlüssel müssen Nachrichten auch länderspezifisch gepflegt werden.

Das Einstiegsbild zur Nachrichtenpflege erreichen Sie aus dem ABAP Editor über den Menüpfad Springen • Nachrichten oder über Transaktion SE91. Auch die Vorwärtsnavigation aus dem Quellcode ist möglich, d. h. durch einen Doppelklick auf die Nachricht. Sollte es die Nachrichtenklasse noch nicht geben, tragen Sie den Namen ein, und legen sie über den entsprechenden Button an. Der Name der Nachrichtenklasse hat maximal 20 Stellen und beginnt aus den bereits genannten Gründen mit Z; Sie nennen die Nachrichtenklasse ZABAP (siehe Abbildung 11.29).

Abbildung 11.29    Einstieg in die Nachrichtenpflege

Bei einer neuen Nachrichtenklasse müssen Sie zunächst die Eigenschaften pflegen (siehe Abbildung 11.30). Anschließend pflegen Sie die Nachrichten auf der passenden Registerkarte.

Jede Nachrichtenklasse hat die Zeilen 000 bis 999. Sie wählen die jeweilige Zeile aus und tragen dort Ihre Nachricht ein, deren Text über maximal 72 Stellen verfügen darf (siehe Abbildung 11.31). Vergessen Sie nach der Pflege der Nachricht und der Nachrichtenklasse nicht, diese zu sichern, damit die neuen Einträge auch in der Tabelle T100 gespeichert werden.

Abbildung 11.30    Attribute der Nachrichtenklasse pflegen

Abbildung 11.31    Nachrichtenkurztext pflegen

Nun gehen wir auf die Fehlerbehandlung bei der Eingabeprüfung im Rahmen des Ereignisses AT SELECTION-SCREEN ein und beschäftigen uns damit, wie dieser Anweisungsblock für die Fehlerbehandlung genau aussieht.

Durchaus tückisch ist der Nachrichtentyp. Er ist kontextsensitiv, d. h. je nach Ort der MESSAGE-Anweisung wirkt er unterschiedlich. Beispielsweise bewirkt der Nachrichtentyp E (für Error) in Selektionsbildern den Abbruch der Selektionsbildverarbeitung: Das Selektionsbild wird erneut gesendet; in der Statuszeile erscheint die Meldung rot hinterlegt. Die Eingabefelder, die mit dem Ereignis AT SELECTION-SCREEN angesprochen wurden, sind wieder eingabebereit und müssen gefüllt werden. Der Prozess wird so lange wiederholt, bis die Eingaben den Prüfungen standhalten. Erst dann wird der Report weiter ausgeführt.

Möchten Sie »richtige« Eingaben im Feld für die neue Teilnehmernummer bzw. für die Sekunden erzwingen, schreiben Sie Folgendes in den Anweisungsblock für die Fehlerbehandlung der Teilnehmernummer:

MESSAGE e002(zabap).

In den Anweisungsblock für die Fehlerbehandlung der Sekunden schreiben Sie:

MESSAGE e001(zabap).

Das MESSAGE-Kommando hat in diesem Fall die folgenden Zusätze:

• e
  Der Nachrichtentyp E erzwingt beim Selektionsbild den Abbruch der Selektionsbildverarbeitung und ein erneutes Senden des Selektionsbildes mit rot hinterlegter Meldung in der Statuszeile.

• 001
  Die Nachrichtennummer hat den Inhalt »Sekunden müssen zwischen 5 und 20 liegen« aus der angegebenen Nachrichtenklasse.

• (zabap)
  Dies ist die kundeneigene Nachrichtenklasse ZABAP, die in Klammern geschrieben werden muss.

Mit dem Zusatz WITH der MESSAGE-Anweisung können bis zu vier Operanden als Stellungsoperanden in einer Feldliste für die Meldung mit gesendet werden. Dabei wird der Inhalt des ersten Feldes in der Feldliste anstelle des ersten Platzhalters im Meldungstext eingesetzt, der Inhalt des zweiten Feldes für den zweiten Platzhalter etc. Dies funktioniert allerdings nur, wenn in der Nachricht selbst für diese Operanden ein Platzhalter vorgesehen ist. Als Platzhalter dient im Nachrichtentext das kaufmännische Und-Zeichen (&). Lautet der Nachrichtentext beispielsweise »Teilnehmernummer & besteht bereits«, könnte die MESSAGE-Anweisung hierzu folgendermaßen aussehen:

MESSAGE e002(zabap) WITH falschtnr.

Der Inhalt des Feldes FALSCHTNR ist dabei für den variablen Meldungstext vorgesehen.