Kontakt

Ansicht
Dokumentation

HELP_VALUES_GET_EXTEND - Bitte F4IF_FIELD_VALUE_REQUEST verwenden

HELP_VALUES_GET_EXTEND - Bitte F4IF_FIELD_VALUE_REQUEST verwenden

SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up   CL_GUI_FRONTEND_SERVICES - Frontend Services  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Achtung, benutzen Sie diesen Baustein bitte nicht mehr.

Für die neuen Eingabehilfen zu Release 4.0 bietet der neue Baustein F4IF_FIELD_VALUE_REQUEST die volle Unterstützung.

Funktionsbaustein: HELP_VALUES_GET_EXTEND

Aufgabe: Wertehilfeanzeige mit Selektion unter Berücksichtigung der
Dynproeinschränkung

Funktionsgruppe: SHL3 - Help-Funktionen für externe Verwendung

Verantwortlich: KRAFTT

Freigabe: -

DOKUMENTATION

Funktionalität

Mit Hilfe dieses Funktionsbausteines können die für ein Feld angeforderten möglichen Werteeingaben dargestellt werden. In der Anzeige steht die volle Funktionalität der Standard-F4-Hilfe zur Verfügung. Zusätzlich berücksichtigt der Funktionsbaustein die Dynproselektion, d.h. die Werte, die in Feldern auf dem Dynpro stehen, bevor die F4-Hilfe angefordert wurde, werden auf Wunsch des Benutzers bei der Datenanzeige selektiv berücksichtigt.

Beispiel

data: tabelle like help_info-tabname,
field like help_info-fieldname.
program_name(10) type c,
dynpro_name(4) type n.
data: returncode like sy-subrc,
selection(1) type c,
select_value like help_info-fldvalue,
select_index like sy-tabix.
data: getfields like dynpfld occurs 0 with header line.
data: updfields like dynpfld occurs 0 with header line.
tabelle = 'OBJSUB'.
field = 'OBJECTNAME'
program_name = 'TESTPROG'.
dynpro_name = '0100'.
refresh dynpfields.
move 'OBJSUB-OBJECTTYPE' to dynpfields-fieldname.
append dynpfields.
move 'OBJT-DDTEXT' to dynpfields-fieldname.
append dynpfields.
refresh: getfields, updfields.
move 'OBJSUB' to updfields-tabname.
move 'OBJECTNAME' to updfields-fieldname.
append updfields.
loop at dynpfields.
split dynpfields-fieldname at '-'
into getfields-tabname getfields-fieldname.
split dynpfields-fieldname at '-'
into updfields-tabname updfields-fieldname.
append getfields.
append updfields.
endloop.
call function 'HELP_VALUES_GET_EXTEND'
exporting
display = ' '
dyname = program_name
dynumb = dynpro_name
fieldname = field
input_value = ' '
tabname = tabelle
shrink = 'X'
exporting
returncode = returncode
selection = selection
select_value = selval
select_index = selind
tables
getfields = getfields
updfields = updfields.

Hinweise

Der Funktionsbaustein ist immer dann in der selbstprogrammierten Hilfe zu benutzen, wenn mehrere Felder auf dem Dynpro gleichzeitig in die Selektion der angezeigten Werte einbezogen werden sollen und die selektierten Werte auch wieder in die Dynprofelder zurückgestellt werden sollen. Die Tabelle muß im Dictionary definiert und aktiv sein. Zur Werteeinschränkung siehe auch die Dokumentation zu HELP_VALUES_SHRINK.

Parameterbeschreibung

Parameter Bezugsfeld/-struktur Vorschlagswert

Import-Parameter:
DISPLAY SPACE
DYNAME DD02S-PROG
DYNUMB DD02S-DNUM
FIELDNAME HELP_INFO-FIELDNAME
INPUT_VALUE HELP_INFO-FLDVALUE SPACE
TABNAME HELP_INFO-TABNAME

Export-Parameter:
RETURNCODE SY-SUBRC
SELECTION
SELECT_VALUE HELP_INFO-FLDVALUE
SELECT_INDEX SY-TABIX

Tabellen-Parameter:
GETFIELDS DYNPFLD
UPDFIELDS DYNPFLD

  • Import-Parameter
  • DISPLAY: Anzeigekennzeichen
    Bedeutung: Wird das Anzeigekennzeichen gesetzt ('X'), so
    werden die Werte nur zur Anzeige ausgegeben. Es
    kann nicht aus den Werten ausgewählt werden.
    Wertebereich: SPACE, 'X'.
    Vorbelegung: SPACE

  • DYNAME: Name des Programms (des rufenden Bildschirms)
    Bedeutung: Name des Programms, von dem aus der Funktions-
    baustein aufgerufen wird. Hier nicht sy-repid,
    sondern sy-cprog einsetzen. Grund: der Wert von
    sy-repid ist das Rahmenprogramm der Funktions-
    gruppe des Help-Prozessors.
    Wertebereich: keiner
    Vorbelegung: keine

  • DYNUMB: Nummer des rufenden Bildschirmes
    Bedeutung: Nummer des Dynpros, von dem aus der Aufruf
    erfolgt. Hier kann sy-dynnr gesetzt werden.
    Wertebereich: keiner
    Vorbelegung: keine

  • FIELDNAME: Name eines Tabellenfeldes.
    Bedeutung: Name des Tabellenfeldes, für welches Hilfe
    angefordert wird. Das Feld muß ein Feld einer
    aktiv vorhandenen Dictionarytabelle sein.
    Wertebereich: keiner
    Vorbelegung: keine

  • INPUT_VALUE: Obsolet, nur zur Aufwärtskompatibilität vorhanden.

  • TABNAME: Name einer Tabelle.
    Bedeutung: Name der Tabelle, die das Feld FIELDNAME .
    enthält. Die Tabelle muß im Dictionary aktiv
    vorhanden sein.
    Wertebereich: keiner
    Vorbelegung: keine

  • SHRINK: Flag zur Einschränkung.
    Bedeutung: Ist das Flag gesetzt ('X'), so werden die
    Feldinhalte aus der Tabelle GETFIELDS zur
    Werteeinschränkung Andernfalls wird keine
    Werteeinschränkung durchgeführt.

  • Export-Parameter:
  • RETURNCODE: Rückgabeanzeige, 0: alles ok, 4: nichts gefunden

  • SELECTION: Auswahlkennzeichen.
    Bedeutung: SELECTION = 'X', falls der Benutzer einen Wert
    selektierte. Wird benötigt, um die Aktion
    "Abbrechen" zu qualifizieren.

  • SELECT_VALUE: Ausgewählter Wert
    Bedeutung: Vom Benutzer selektierter Feldinhalt. Bei
    SPACE wurde der Initialwert ausgewählt, falls
    SELECTION gesetzt ist, ansonsten abgebrochen.

  • SELECT_INDEX: Tabellenzeile des ausgewählten Wertes
    Bedeutung: Tabellenzeile des Wertes aus der Anzeige, er
    stimmt i.A. nicht mit der Datenbanktabellenzeile
    überein.

  • Tabellen-Parameter:
  • GETFIELDS: Felder für die Einschränkung der Datenanzeige
    Bedeutung: GETFIELDS enthält die Einschränkungsbedingungen
    für die Datenanzeige. Es werden nur die Werte
    angezeigt, die diesen Bedingungen genügen. Ist
    GETFIELDS leer, so wird keine Einschränkung
    durchgeführt und Flag SHRINK wird übersteuert.
    Die aufgeführten Felder sollten zu einer
    Dictionarytabelle gehören. Ist GETFIELDS
    gefüllt, kann die Tabelle UPDFIELDS leer
    beiben, und der Feldtnsport zurück zum Dynpro
    erfolgt für die in GETFIELDS angegeben
    Dynprofelder.
    Wertebereich: keiner

  • UPDFIELDS: Felder für die Werterückstellung zum Dynpro.
    Bedeutung: Falls GETFIELDS leer ist, aber trotzdem eine
    Werterückstellung für mehrere Dynprofelder
    gewünscht wird, müssen diese in UPDFIELDS
    angegeben werden. Zusätzlich müssen
    Werte vom Benutzer selbst mit Hilfe des
    Funktionsbausteins DYNP_VALUES_UPDATE
    zurückgestellt werden.
    Wertebereich: keiner





Parameter

DISPLAY
DYNAME
DYNUMB
FIELDNAME
GETFIELDS
INPUT_VALUE
RETURNCODE
SELECTION
SELECT_INDEX
SELECT_VALUE
SHRINK
TABNAME
UPDFIELDS

Ausnahmen

Funktionsgruppe

SHL3

Vendor Master (General Section)   RFUMSV00 - Advance Return for Tax on Sales/Purchases  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 11754 Date: 20240523 Time: 060522     sap01-206 ( 82 ms )