Ansicht
Dokumentation

ABENABAP_DYNPROS_FIELD_HELP - ABAP DYNPROS FIELD HELP

ABENABAP_DYNPROS_FIELD_HELP - ABAP DYNPROS FIELD HELP

PERFORM Short Reference   PERFORM Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

- Feldhilfe

Es gibt drei verschiedene Möglichkeiten, um Feldhilfe zu Bildschirmelementen von Dynpros anzuzeigen:

Anzeige der Dokumentation des Datenelements

Wenn ein Bildschirmelement im Screen Painter durch Übernehmen eine Felds aus dem ABAP Dictionary definiert wurde, wird bei Auswahl der F1-Hilfe für dieses Feld automatisch die Dokumentation des zugehörigen Datenelements angezeigt, falls dies nicht in der Dynpro-Ablauflogik übersteuert wird.

Anzeige der Zusatzdokumentation des Datenelements

Die Dokumentation des Datenelements kann durch Zusatzdokumentation erweitert sein. Die Zusatzdokumentation für ein Dynpro-Feld wird nicht mit dem Werkzeug ABAP Dictionary der ABAP Workbench angelegt, sondern im Screen Painter. Dabei wird die Zusatzdokumentation unter einer Nummer für das Datenelement definiert.

Eine solche Zusatzdokumentation ist programm- und Dynpro-spezifisch. Eine im ABAP Dictionary definierte Zusatzdokumentation der gleichen Nummer wird durch eine Dynpro-spezifische Zusatzdokumentation übersteuert. Eine im Dictionary definierte Zusatzdokumentation kann in der Tabelle THLPF nachträglich mit einem Dynpro-Feld verknüpft werden. Dazu muss eine neue Zeile in der Tabelle THLPF angelegt werden, welche die Programmname, Dynpro-Nummer, Feldname und Nummer der Zusatzdokumentation enthält.

Um eine Zusatzdokumentation anzuzeigen, muss die Dynpro-Ablauflogik wie folgt auf das Ereignis POH reagieren:

PROCESS ON HELP-REQUEST.
...
  FIELD field [MODULE mod] WITH hlp.
  ...

Hinter PROCESS ON HELP-REQUEST sind nur FIELD-Anweisungen erlaubt. Ist das Ereignisschlüsselwort PROCESS ON HELP-REQUEST in der Ablauflogik eines Dynpros nicht vorhanden, wird bei F1 entweder die Dokumentation des Datenelements des Felds, auf dem der Cursor steht, oder keine Hilfe angezeigt. Ansonsten wird die nachfolgende FIELD-Anweisung ausgeführt, auf deren Feld field der Cursor steht.

Wenn für das Feld field eine Dynpro-spezifische Zusatzdokumentation existiert, wird diese durch Angabe ihrer Nummer hlp zur Anzeige gebracht. Zum Füllen einer Variablen hlp kann beispielsweise das Dialogmodul mod vor Anzeige der Hilfe aufgerufen werden. Zum Zeitpunkt PROCESS ON HELP-REQUEST transportiert die FIELD-Anweisung aber nicht den Inhalt des Dynpro-Felds field in das ABAP-Programm.

Aufruf von Hilfetexten in Dialogmodulen

Zur Anzeige beliebiger Hilfetexte können zum Zeitpunkt POH Dialogmodule aufgerufen werden:

PROCESS ON HELP-REQUEST.
  ...
  FIELD field MODULE mod.
  ...

Hinter PROCESS ON HELP-REQUEST kann die MODULE-Anweisung nur in Verbindung mit der FIELD-Anweisung verwendet werden. Bei der Auswahl von F1 wird das Dialogmodul mod der FIELD-Anweisung aufgerufen, auf deren Feld field der Cursor steht. Falls mehrere FIELD-Anweisungen zum gleichen Feld field aufgeführt sind, wird nur die erste ausgeführt. Im Dialogmodul mod steht der Inhalt des Dynpro-Felds field nicht zur Verfügung, da dieser zum Zeitpunkt PROCESS ON HELP-REQUEST nicht durch die FIELD-Anweisung transportiert wird.

Das Dialogmodul mod wird im ABAP-Programm wie ein normales PAI-Modul definiert. Die Verarbeitungslogik des Moduls muss dafür sorgen, dass eine adäquate Hilfe zum ausgewählten Feld angezeigt wird. Dazu können geeignete Funktionsbausteine wie z.B. HELP_OBJECT_SHOW_FOR_FIELD oder HELP_OBJECT_SHOW verwendet werden.

Feldhilfe






CPI1466 during Backup   BAL Application Log Documentation  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 4815 Date: 20240523 Time: 180126     sap01-206 ( 95 ms )