Meldungen
Im Web Dynpro ABAP können Sie Meldungen erstellen und ausgeben, die wichtige Informationen für den Endbenutzer der Web-Dynpro-Anwendung enthalten. Meldungen sind sprachabhängige Texte, die am Bildschirm ausgegeben werden, wenn beispielsweise bei der Ausführung einer Anwendung ein Fehler aufgetreten ist oder der Benutzer Eingaben in einem falschen Format vorgenommen hat.
Wir empfehlen, die Anzahl der Meldungen auf ein übersichtliches Maß zu beschränken. Zu viele Meldungen überfordern den Endbenutzer.
Geben Sie Meldungen nur für Sachverhalte aus, die mit der aktuellen Benutzer-Interaktion zu tun haben, z.B. Validierungsfehler. Benutzen Sie Meldungen nicht dazu, ein allgemeines Protokoll auszugeben.
Zu SAP_UI 7.50 SP1 wurde ein neues Design NOTIFICATION_ICON für den Meldungsbereich eingeführt. Es ist automatisch aktiv, wenn die aktive UI Guideline (WDUIGUIDLINE) FIORI ist und in der Anwendung kein anderes Design explizit gesetzt wurde. Für weitere Information zu NOTIFICATION_ICON, siehe Design NOTIFICATION ICON für Guideline FIORI.
Beispiel-Meldungen in der Anwendung WDR_TEST_MSG_AREA
Beispiel-Anwendung für Eingabeprüfungen (WDR_TEST_INPUT)
Für das Programmieren dieser Benutzernachrichten wie Informationen, Fehlermeldungen und Warnungen stellt die Web-Dynpro-Laufzeit des Application Server ABAP einen Laufzeit-Service zur Verfügung. Die Message-Component ist in jede Web-Dynpro-Anwendung integriert und kann je nach Bedarf über die Einstellungen bei einer Web-Dynpro-Anwendung konfiguriert werden. Zwei Einstellungen sind für die Behandlung von Meldungen möglich:
- Message Component einblenden
Wenn Meldungen vorhanden sind, werden sie eingeblendet, sonst nicht.
- Message Component immer einblenden
Auch wenn keine Meldungen vorhanden sind, wird die Message Component in der obersten View angezeigt.
Benutzernachrichten werden in Form von Links in der Statuszeile ausgegeben. Damit erhält der Endbenutzer die Möglichkeit, durch das Anwählen des Links automatisch zu demjenigen UI-Element zu navigieren, das im Falle einer Fehlermeldung für die Fehlerbehebung genutzt werden kann. Der Eingabefokus wird damit automatisch verlagert, was die Effizienz der Meldungen stark erhöht. Die Ausgabe mehrerer Meldungen in einer Bildschirmausgabe ist über eine Tabelle ebenfalls möglich.
Sie können Meldungen spezifischen Views bzw. Windows zuordnen, damit die Meldungen nicht auf einem Pop-up angezeigt werden, wenn sie eigentlich beispielsweise zum Haupt-Fenster gehören. Hierfür gibt es in den entsprechenden Methoden des Message-Managers einen optionalen Parameter VIEW, mit dessen Hilfe Sie den Namen des entsprechenden Views bzw. Windows angeben können.
Um Ihre Anwendung aufseiten der Meldungsausgabe zu verbessern, überprüfen Sie, ob es sinnvoll ist, an bestimmten Stellen eine Meldung an eine View oder an ein bestimmtes Fenster zu binden, so dass sie nicht mehr in einem Pop-up angezeigt wird, wenn eines ausgelöst wird. Falls Sie read-only Pop-ups einsetzen, kann das Unterdrücken der kompletten Meldungsanzeige ebenfalls sinnvoll sein.
Meldungen werden auf der Ebene einer Web-Dynpro-Component definiert.
Siehe auch:
Wiederverwendbare Components und die MessageArea
Sie können festlegen, ob der Meldungsbereich (MessageArea) mit einer neuen Visualisierung in der Anwendung angezeigt wird. Die neue Visualisierung bietet die folgenden Vorteile:
- Komplett über eine API steuerbar
- Minimale Höhe beträgt eine Zeile
- Flexibel auf das jeweilige Einsatzszenario anpassbar
- Springen geschieht bei entsprechender Einstellung nicht mehr
Um die neue Visualisierung zu verwenden, benutzen Sie IF_WD_MESSAGE_AREA=>SET_DISPLAY_ATTRIBUTES. Sie finden weitere Informationen in der dazu gehörigen Methodendokumentation im System. Sie finden ein Beispiel im System in der Komponente WDR_TEST_MSG_AREA.
Die Meldungsanzeige auf einem Pop-up funktioniert standardmäßig on-demand, unabhängig davon, was bei der Komponente eingestellt ist. Pop-ups können jedoch über ein Kennzeichen so konfiguriert werden, dass sie:
- wie bisher alle Meldungen anzeigen (Standardfall)
- nur die Meldungen anzeigen, die zu ihrem Fenster gehören - sowie alle nicht-fensterspezifischen Meldungen
- gar keine Meldungen anzeigen
- Wenn zur Meldung ein Langtext existiert, wird die Meldung mit einem Link versehen dargestellt
- Anzeige ist von den oben geschilderten Enstellungen abhängig. Mehrere Meldungen
werden in einer scrollbaren Tabelle dargestellt.
- Aktuelle Meldungen der letzten Benutzerinteraktion
- Wechsel zum Meldungsprotokoll möglich (optional). Das Meldungsprotokoll zeigt
nicht nur die aktuellen Meldungen, sondern alle Meldungen seit Start der
Anwendung.
- Letzte Meldung mit der höchsten Gewichtung steht am Anfang der aktuellen Meldungen, beim Meldungsprotokoll dagegen werden die einzelnen Meldungen nach dem Zeitpunkt des Auftretens angezeigt
- Zähler für neue Meldungen und Zähler für alle Meldungen
- Symbol für die Gewichtung jeder einzelnen Meldung
- Zeitstempel für alle Meldungen
- Sortierung der Meldungen in einem TabStrip nach:
- Gewichtung
- Meldungstext
- Hilfe (Nachrichtenlangtext)
- Zeitstempel
- Eingabe von Filterkriterien für:
- Gewichtung
- Meldungstext
- Hilfe (Nachrichtenlangtext)
- Zeitstempel
- Zurücksetzen, dies bedeutet Löschen, des gesamten Meldungsprotokolls
- Ein- und Ausblenden des Meldungsprotokolls:
- Ausblenden: Nur die aktuellen Meldungen bleiben bestehen und der Link Meldungsprotokoll anzeigen
- Einblenden: Tabellensicht der aktuellen Meldungen und der gesamten Anzahl von Meldungen
Für die Anwendungsentwicklung steht zum freien Positionieren einer Meldungsanzeige das UI-Element MessageArea zur Verfügung.
Beachten Sie dabei, dass die Eigenschaften maxVisibleMessages und historyVisible im View Designer nicht ausgewertet werden, sie können lediglich programmatisch verwendet werden.
Die Vorgehensweise zur Einbindung von Meldungen in Ihre Anwendung finden Sie unter Einbindung von Meldungen.
Sie finden Beispiel-Anwendungen im System in den Komponenten WDR_TEST_MSG_AREA und WDR_TEST_INPUT.