Handling von Web-Ikonen (SAP-Bibliothek

Handling von 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 Buttons 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.

Achtung

Die 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.

Unterstützte URL-Formate

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

Hinweis

Beachten Sie, dass bis auf /path (siehe Tabelle) keine relativen Pfade unterstützt werden, also keine Angaben in der Form ./path oder ../path.

Aus Kompatibilitätsgründen vorhandene Notationen für URL-Formate

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.