GET_SIMPLE_HELPVALUES

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

Funktionsumfang

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 OnInitialization

Syntax Syntax

data: 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.

Ende des Codes

Layout

Syntax Syntax

<%@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>

Ende des Codes