RoadMap

Verwendung

Das RoadMap-Oberflächenelement visualisiert die Schritte eines Wizards. Jeder Schritt wird durch ein eigenes RoadMapStep-Objekt bzw. MultipleRoadMapStep repräsentiert. Sie können die Anfangspunkte und Endpunkte dieses Oberflächenelements mit verschiedenen Symbolen markieren. Wenn Sie der Eigenschaft startPointDesign oder endPointDesign den Wert more zuordnen, dann können Sie damit den Benutzer darauf hinweisen, dass sich weitere Schritte vor dem ersten sichtbaren Schritt bzw. nach dem letzten sichtbaren Schritt befinden.

Das RoadMap-Oberflächenelement eignet sich zur schrittweisen Darstellung von Arbeitsabläufen. Die Anwendungsentwicklung kann damit kleine Einzelschritte eines klar festgelegten Arbeitsprozesses visualisieren.

Beispiel für die visuelle Darstellung

Scrolling bei der RoadMap

Es gibt bei einer RoadMap zwei Möglichkeiten bezüglich des Scrolling:

Fall 1: Es ist kein ActionHandler für RoadMap.OnLoadSteps definiert
- Falls endPointDesign=startPointDesign=standard, so passt sich die Größe der RoadMap der Breite des Browserfensters an. Es findet automatisch Scrolling am Client ohne Roundtrip statt. Das Design der Start- und Endpunkte passt sich entsprechend automatisch an.
  Wenn die Breite des Browserfensters nicht ausreicht, um die gesamte RoadMap anzuzeigen, wird die RoadMap abgeschnitten und es wird markiert, ob nach links und/oder nach rechts noch weitere Schritte folgen. Wenn die Anwendung die Lead-Selection auf einen RoadMapStep legt, der außerhalb des angezeigten RoadMap-Ausschnittes liegt, dann verschiebt sich der Ausschnitt automatisch, so dass der RoadMapStep sichtbar wird.
  
  Hinweis
  Hat der Benutzer den sichtbaren Ausschnitt einmal durch Klicken auf den Start- bzw. Endpunkt verschoben, verschiebt sich der Ausschnitt nicht mehr automatisch beim Server-seitigen Scrollen.
- Falls andere Designs für Start- und Endpunkt gewählt wurden, wird das entsprechende Design angezeigt und es findet kein Client-seitiges Scrolling statt.
Fall 2: Es ist ein ActionHandler für RoadMap.OnLoadSteps definiert
- Falls endPointDesign=more so wird beim Klicken auf den Endpunkt die Web-Dynpro-Action ausgelöst und die Anwendung muss sich um das Scrolling kümmern.
- Für andere Designs wird beim Draufklicken keine Action ausgelöst.
Dies gilt analog für den Startpunkt.

Implementierungsdetails

Hinweis

Um die Entwicklung barrierefreier Anwendungen zu ermöglichen, wird im Rahmen des Syntaxchecks die Eigenschaft accessibilityDescription überprüft, wenn die tooltip-Eigenschaft nicht gesetzt wurde.

Laufzeit-Klasse

CL_WD_ROAD_MAP

Eigenschaften im View Designer

Name	Typ	Anfangswert	Bindbar
id	STRING	(automatisch)	nein
accessibilityDescription	Übersetzbarer Text		ja
contextMenuBehaviour	WDUI_CONTEXT_MENU_BEHAVIOUR	inherit	nein
contextMenuId	WDY_MD_UI_ELEMENT_REFERENCE		nein
enabled	WDY_BOOLEAN	true	ja
endPointDesign	WDUI_ROAD_MAP_EDGE_DESIGN	standard	ja
selectedStep	STRING		ja
startPointDesign	WDUI_ROAD_MAP_EDGE_DESIGN	standard	ja
styleClassName	STRING		ja
tooltip	Übersetzbarer Text		ja
visible	WDUI_VISIBILITY	visible	ja

Aggregationen im View Designer

Name	Kardinalität	Typ
Step	0..n	RoadMapStep

Events im View Designer

Name
onLoadSteps
onSelect

Hinweis

Weitere Eigenschaften, die über Vererbung zur Verfügung stehen, sind in den dazugehörigen übergeordneten Klassen definiert. Die dazugehörigen Oberflächenelemente sind:

Dynamische Programmierung

Für die dynamische Programmierung stehen dieselben Eigenschaften, Ereignisse und Aggregationen zur Verfügung wie im View Designer. Beachten Sie dabei die unterschiedlichen Schreibweisen.

Dynamische Programmierung der Eigenschaften

View Designer Name	Laufzeitname	Typ
accessibilityDescription	ACCESSIBILITY_DESCR	WDY_MD_TRANSLATABLE_TEXT
contextMenuBehaviour	CONTEXT_MENU_BEHAVIOUR	WDUI_CONTEXT_MENU_BEHAVIOUR
contextMenuBehaviour: inherit	CL_WD_ROAD_MAP=>E_CONTEXT_MENU_BEHAVIOUR-INHERIT
contextMenuBehaviour: provide	CL_WD_ROAD_MAP=>E_CONTEXT_MENU_BEHAVIOUR-PROVIDE
contextMenuBehaviour: suppress	CL_WD_ROAD_MAP=>E_CONTEXT_MENU_BEHAVIOUR-SUPPRESS
contextMenuId	CONTEXT_MENU_ID	WDY_MD_UI_ELEMENT_REFERENCE
enabled	ENABLED	WDY_BOOLEAN
endPointDesign	END_POINT_DESIGN	WDUI_ROAD_MAP_EDGE_DESIGN
endPointDesign: disabled	CL_WD_ROAD_MAP=>E_END_POINT_DESIGN-DISABLED
endPointDesign: more	CL_WD_ROAD_MAP=>E_END_POINT_DESIGN-MORE
endPointDesign: moreDisabled	CL_WD_ROAD_MAP=>E_END_POINT_DESIGN-MORE_DISABLED
endPointDesign: selected	CL_WD_ROAD_MAP=>E_END_POINT_DESIGN-SELECTED
endPointDesign: standard	CL_WD_ROAD_MAP=>E_END_POINT_DESIGN-STANDARD
selectedStep	SELECTED_STEP	STRING
startPointDesign	START_POINT_DESIGN	WDUI_ROAD_MAP_EDGE_DESIGN
startPointDesign: disabled	CL_WD_ROAD_MAP=>E_START_POINT_DESIGN-DISABLED
startPointDesign: more	CL_WD_ROAD_MAP=>E_START_POINT_DESIGN-MORE
startPointDesign: moreDisabled	CL_WD_ROAD_MAP=>E_START_POINT_DESIGN-MORE_DISABLED
startPointDesign: selected	CL_WD_ROAD_MAP=>E_START_POINT_DESIGN-SELECTED
startPointDesign: standard	CL_WD_ROAD_MAP=>E_START_POINT_DESIGN-STANDARD
styleClassName	STYLE_CLASS_NAME	STRING
tooltip	TOOLTIP	WDY_MD_TRANSLATABLE_TEXT
visible	VISIBLE	WDUI_VISIBILITY
visible: none	CL_WD_ROAD_MAP=>E_VISIBLE-NONE
visible: visible	CL_WD_ROAD_MAP=>E_VISIBLE-VISIBLE

Dynamische Programmierung der Ereignisse

View Designer Name	Laufzeitname
onLoadSteps	ON_LOAD_STEPS
onSelect	ON_SELECT

Dynamische Programmierung der Aggregationen

View Designer Name	Laufzeitname	Kardinalität
Step	STEPS	0..n

Beispiel

Beispiele für dieses Oberflächenelement finden Sie im System in der Web-Dynpro-Applikation WDR_TEST_UI_ELEMENTS sowie in der Component WDR_TEST_EVENTS in der View ROADMAP. Ein ganz einfaches Beispiel finden Sie im System in der Web-Dynpro-Applikation DEMO_ROADMAP.