Handling von Bildern und Web-Ikonen
Bei der Erstellung von User Interfaces von Web-Anwendungen werden häufig immer wiederkehrende grafische Elemente fester Größe benötigt, z.B. zur Verwendung auf Button s oder als Statusikonen auf Bildschirmbildern oder auf Listen. Diese Ikonen dienen der bildlichen Darstellung eines Objekts oder einer Funktion. Für die häufigsten Standard-Objekte und Funktionen stellt SAP vordefinierte Web-Ikonen zur Verfügung.
Web Dynpro ABAP stellt verschiedene Techniken zum Auflösen von URLs in UI-Elementen (z.B. Image.source) zur Verfügung:
-
Für den Zugriff auf Web-Ikonen steht die Klasse CL_WD_WEB_ICON bereit.
-
Neue Web-Ikonen werden über ~IconAlias adressiert (siehe Tabelle der unterstützten URL-Formate).
-
Eine Untermenge der neuen Ikonen stand in früheren Releases bereits über symbolische Namen beginnend mit WEBICON_* zur Verfügung.
AchtungDie Syntax WEBICON_* ist deprecated. Die früheren WEBICON_* Namen werden intern auf die neuen Web-Ikonen gemappt. Beachten Sie, dass die alten SAP GUI Ikonen ( ICON_*) überhaupt nicht mehr verwendet werden sollten. Zur Zeit findet jedoch noch keine Prüfung auf alte WEBICON_* und ICON_* Verwendungen statt. Die früheren Notationen werden aus Kompatibilitätsgründen in der unteren Tabelle aufgeführt.
|
Format |
Beschreibung |
Übersetzung in |
Beispiel(e) |
|---|---|---|---|
|
~IconAlias |
Format für die neuen vordefinierten Web-Ikonen |
Großbuchstaben |
~Icon/Attachment ~IconLarge/AudioFile ~Pictogram/2PeopleDocCircularArrow |
|
$NAME$ oder $NAME$/path |
$NAME$ bezieht sich auf einen Eintrag in Transaktion SM59 für eine HTTP-Verbindung (Typ G). Wenn ein Pfad angegeben ist, wird er an den bereits definierten Pfad-Präfix angehängt. Dies ist die einzige Technik für die Verwendung absoluter URLs. |
$NAME$-Sequenz in Großbuchstaben, /Pfad in Kleinbuchstaben |
$MY_HTTP_DESTINATION$/images/hello.gif |
|
/path |
Relative Pfadangabe von einem Server zu einem MIME Repository Eintrag. Dieser Eintrag beginnt bei der Wurzel des MIME-Repositories. Die URL wird immer vom aktuellen Server geladen. Wenn es sich um einen Web-Dynpro-Pfad handelt, wird die Angabe in die symbolische Repräsentation umgewandelt. Ansonsten finden keine Überprüfungen statt, um die Gültigkeit der URL sicherzustellen. |
Kleinbuchstaben |
/sap/public/images/hello.gif |
|
image.ext oder folder/image.ext |
Laden eines Bildes aus dem MIME-Ordner der aktuellen Component. Dies ist die Kurzform des folgenden Formats. |
s_lr_11417.jpg hello.gif images/hello.gif |
|
|
{/NAMESPACE/COMPONENT}/image.ext oder {/NAMESPACE/COMPONENT}/folder/image.ext |
Das Bild wird relativ zu einer anderen Component festgelegt, es kann aber auch die eigene Component sein. Das bedeutet, dass das Bild im MIME-Ordner der betreffenden Component abgelegt ist. Für Components innerhalb des SAP-Namensraumes wird die /NAMESPACE/-Sequenz nicht angegeben. |
Namensraum und Component in Großbuchstaben, Pfad in Kleinbuchstaben. |
{WDR_TEST_EVENTS}/s_lr_11417.jpg |
Beachten Sie, dass bis auf /path (siehe Tabelle) keine relativen Pfade unterstützt werden, also keine Angaben in der Form ./path oder ../path.
|
Format |
Beschreibung |
Übersetzung in |
Beispiel |
|---|---|---|---|
|
ICON_<NAME> |
Format für ältere SAP GUI Ikonen. Siehe auch NAME-Spalte der Tabelle ICON. Diese Ikonen sind nicht für die Verwendung im Web optimiert. |
Großbuchstaben |
ICON_CRITICAL |
|
WEBICON_<NAME> |
Deprecated Format. Diese Syntax wurde ersetzt durch die Notation ~IconAlias, siehe vorherige Tabelle |
Großbuchstaben |
WEBICON_CRITICAL |
|
[WWWDATA]/objectName |
Laden eines Bildes aus dem SAP Web Repository des ITS. |
[WWWDATA]/HELLO_IMAGE |
Programmierschnittstellen
Für Ihre Entwicklungen stehen die folgenden öffentlichen APIs zur Verfügung:
-
Wertehilfe: Funktionsbaustein WDY_WB_VD_ICON_PICKER
-
Datenelement: Web-Ikonen-Aliases WDG_UR_WEB_ICON_ALIAS
-
Domäne: Web-Ikonen-Aliases WDG_UR_WEB_ICON_ALIAS
Test
Sie finden eine Testanwendung im System in der Component WDR_TEST_WEB_ICONS.
Weitere Informationen zur Klasse CL_WD_WEB_ICON finden Sie in der zugehörigen Systemdokumentation.