Show TOC

Eigenschaft explanationLocate this document in the navigation structure

Verwendung

Zusätzlich zu dem UI-Element Explanation können Sie für verschiedene UI-Elemente die Eigenschaft explanation setzen, die dann in Abhängigkeit des Hilfemodus zur Anzeige kommt. Das Verhalten ist je nach Hilfemodus unterschiedlich:

  • Help mode = on

    Ist bei einem UI-Element die Eigenschaft explanation gesetzt, so wird dieses UI-Element auf dem Bild mit einem grünen Unterstrich versehen. Steht der Cursor über diesem Symbol, so wird der Inhalt dieser Eigenschaft angezeigt. Dies ist zusätzlich zu und unabhängig von einem eventuell gesetzten Tooltip. Damit enthält diese Eigenschaft faktisch eine F1-Hilfe.

    Eigenschaft explanation plus Tooltip für Auslieferungszeitpunkt

    Hinweis

    Der Inhalt der Eigenschaft tooltip wird nur im Barrierefreiheit-Modus durch ein Bildschirmausleseprogramm vorgelesen.

  • Help mode = off

    Der Inhalt von explanation wird nicht angezeigt, d.h. es steht keine Primärhilfe zur Verfügung.

Sie können den Hilfemodus entweder bei den personenbezogenen Einstellungen im Portal oder über den dazugehörigen URL-Parameter WDHIDEMOREFIELDHELPASDEFAULT aktivieren.

Im View Designer legen Sie den gewünschten Text für die Eigenschaft explanation im Eingabefeld für den Wert dieser Property an. Der Text kann entweder ein frei eingegebener Text (maximal 255 Zeichen lang) sein oder ein OTR-Aliastext, für den Sie die Notation $OTR:Aliasname benutzen. Zusätzlich können Sie über die F4-Hilfe für dieses Feld festlegen, ob Sie die im System vorliegende Datenelementdokumentation oder Teile davon auf dem Bildschirm als Hilfetext ausgeben möchten. Hierbei handelt es sich um die Datenelementdokumentation des Datenelements, das Sie gegen die primäre Eigenschaft des jeweiligen Propertys gebunden haben. Es ist möglich, die folgenden Varianten der Datenelementdokumentation für die Anzeige auszuwählen:

  • Kurztext aus dem ABAP-Dictionary

  • Keyblock &DEFINITION& aus dem Datenelement-Langtext

  • Keyblock &USE& aus dem Datenelement-Langtext

  • Hinweis auf komplette Datenelementdokumentation (Langtext)

Der Hilfetext wird dann auf dem Bildschirm angezeigt, wenn der Mauszeiger über das jeweilige UI-Element bewegt wird (Mouse-Over).

Die verschiedenen Hilfe-Möglichkeiten können damit folgendermaßen festgelegt werden:

Auswahl der Hilfe-Möglichkeiten im View Designer

Die Anzeige der Datenelementdokumentation setzt voraus, dass es eine primäre Eigenschaft für das UI-Element gibt und dass Sie ein Datenelement mit Datenelementdokumentation aus dem ABAP-Dictionary entsprechend gebunden haben. Wenn es kein solches Datenelement gibt, dann sind auf dem Auswahl-Popup die Optionen für die Datenelementdokumentation ausgegraut. Bei einem Button beispielsweise ist diese Art der Datenelementdokumentationsanzeige nicht möglich, da es für einen Button keine primäre Eigenschaft gibt.

Beispiel

Beispiel für die verschiedenen Arten der Anzeige von Teilen der Datenelementdokumentation:

Auslieferungszeitpunkt

Von dem Datenelement WDR_TEST_HELP_DELIVERY_TIME wurde links der Definitionstext verwendet und rechts der Verwendungstext.

Sie können für die folgenden UI-Elemente die Eigenschaft explanation setzen:

Abschalten der F1-Hilfe

Standardmäßig wird die Datenelement-Dokumentation, falls vorhanden, bei aktiviertem Hilfe-Modus angezeigt. Sie können jedoch auch die Anzeige der Datenelement-Dokumentation abschalten und zusätzlich für einzelne ausgewählte Felder Ausnahmen definieren. Dazu steht der Anwendungsparameter WDHIDEMOREFIELDHELPASDEFAULT zur Verfügung.

Wenn dieser Parameter auf X steht und zusätzlich bei der Eigenschaft explanation für ein bestimmtes Feld neben den Optionen mit Hilfetext bei Mouse-Over und aus dem Datenelement der Schalter Zeige Hinweis auf vollständige Datenelement-Dokumentation aktiviert ist, wird bei der Anzeige des Feldes auf dem Bildschirm im Anschluss an den Informationstext der Text Rechte Maustaste für mehr in Klammern eingeblendet. Über die rechte Maustaste und Mehr Fehldhilfe wird dann die entsprechende Datenelement-Dokumentation angezeigt.