GET_SIMPLE_HELPVALUES
GET_SIMPLE_HELPVALUES
Verwendung
Die Methode GET_SIMPLE_HELPVALUES am Service-Objekt (RUNTIME->DDIC_UTILS) bestimmt die Werteliste aus einer einfachen Wertehilfe.
Als Importing-Parameter ist eine Referenz auf das Datenobjekt anzugeben, zu dem die Wertehilfe bestimmt werden soll. Dieses Datenobjekt muß einen direkten oder indirekten Bezug zu einem elementaren Dictionary-Typ (Datenelement oder Strukturfeld) besitzen, dem eine einfache Wertehilfe (Festwerte, Prüftabelle, Suchhilfe) zugeordnet ist. Es kann z.B. eine Referenz auf ein Datenobjekt mit einem Bezug zu einer elementaren Komponente einer Dictionary-Struktur (DATA: var TYPE strucname-compname) oder ein Datenobjekt mit direktem Bezug zu einem Datenelement (DATA: var TYPE dtelname) übergeben werden.
Die Methode liefert die gefundenen Werte in einer zweispaltigen Tabelle zurück: Die Spalte KEY enthält die jeweiligen Werte und die Spalte VALUE die zugehörigen Texte. Über den Parameter SORT_VALUES kann gesteuert werden, ob und - wenn ja – wie die Werteliste sortiert werden soll. Z.B. würde für eine Werteliste mit einer Tagesnummer und Wochentagsnamen eine Sortierung nach der VALUE-Spalte folgende Reihenfolge erzeugen: Dienstag, Donnerstag, Freitag, Mittwoch, Montag, Samstag, Sonntag. Hier sollte nach der KEY-Spalte sortiert werden. Ist die Wertehilfe über Festwerte definiert, so sind diese oft bereits in der gewünschten Reihenfolge abgelegt und eine Sortierung ist nicht notwendig.
Parameter und Ausnahmen
Importing-Parameter: | ||
|
SORT_VALUES |
Sortierung der Werteliste (NO_SORT, BY_VALUE, BY_KEY) | |
|
DATA_OBJECT_REF |
Referenz auf ein Datenobjekt | |
Changing-Parameter: | ||
|
HELPVALUE_TAB |
Werteliste zum Datenobjekt | |
Exceptions: | ||
|
CX_BSP_SERVICES_PARAM |
||
|
CX_BSP_SERVICES_NOTFOUND |
||
|
CX_BSP_SERVICES_SHLP |
||
Beispiel
Seitenattribut
Attribut |
Auto |
TypArt |
Bezugstyp |
Beschreibung |
airlinelist |
TYPE |
SHSVALTAB |
verfügbare Fluggesellschaften |
Ereignis
OnInitializationdata: flight type sflight, dataref type ref to data, errortext type string, l_ex_services type ref to cx_bsp_services.
get reference of flight-carrid into dataref. * get list of available airlines try. call method runtime->ddic_utils->get_simple_helpvalues exporting data_object_ref = dataref changing helpvalue_tab = airlinelist. catch cx_bsp_services into l_ex_services. * catch exception into message object errortext = l_ex_services->get_text( ). call method messages->add_message exporting condition = 'AIRLINES' message = errortext severity = CL_BSP_MESSAGES=>CO_SEVERITY_ERROR. endtry. |
Layout
<%@page language="abap"%> <html> <head> <link rel="stylesheet" href="../../sap/public/bc/bsp/styles/sapbsp.css"> <title> einfache Wertehilfe aus DDIC </title> </head> <body class="bspBody1"> <% if messages->num_messages( ) = 0. data: wa type SHSVALSTR. %> Mit welcher Fluggesellschaft möchten Sie verreisen? <p> <select name="AIRLINE"> <% loop at airlinelist into wa.%> <option value=" <%=wa-key%> "> <%=wa-value%> </option><% endloop. %> </select> <% else. %> Es sind leider keine Fluggesellschaften verfügbar <% endif. %> </body> </html> |