Ansicht
Dokumentation

CIFIDYNP_VALUES_READ - Dynpro Feldwerte lesen vor PAI Feldtransport

Addresses (Business Address Services)   rdisp/max_wprun_time - Maximum work process run time  
Diese Dokumentation steht unter dem Copyright der SAP AG.
Vorbemerkung

Dieser Funktionsbaustein ist freigegeben.

Die Dokumentation des Funktionsbausteins wird noch überarbeitet, so daß sie auch formal den Anforderungen genügt, die an freigegebene Funktionsbausteine gestellt werden.

Funktionsbaustein: DYNP_VALUES_READ

Aufgabe: Lesen von Feldinhalten auf dem Dynpro und Feldtransport zum
Helpprozessor

Funktionsgruppe: SHL2 - Help-Funktionen

Freigabe: für Kunden freigegeben

DOKUMENTATION

Funktionalität

Mit Hilfe dieses Funktionsbausteines können Feldinhalte aus dem Dynpro ausgelesen werden, welche von den Hilfebausteinen weiter verarbeitet werden können. Der Funktionsbaustein ist nur im POV (process on value-request) eines Dynpros einsetzbar.

Beispiel

data: dyname like d020s-prog value 'TESTPROG',

dynumb like d020s-dnum value '100'.

data: begin of dynpfields occurs 3.

include structure dynpread.

data: end of dynpfields.

move 'TABNAME' to dynpfields-fieldname.

append dynpfields.

move 'FIELDNAME' to dynpfields-fieldname.

append dynpfields.

call function 'DYNP_VALUES_READ'

exporting

dyname = dymame

dynumb = dynumb

translate_to_upper = 'X'

tables

dynpfields = dynpfields

exceptions

invalid_abapworkarea = 01

invalid_dynprofield = 02

invalid_dynproname = 03

invalid_dynpronummer = 04

invalid_request = 05

no_fielddescription = 06

undefind_error = 07.

Hinweise

Die in DYNPFIELDS eingelesenen Feldinhalte werden in den Funktionsbau- steinen zur externen Hilfe, HELP_VALUES_GET_WITH_TABLE_EXT sowie HELP_VALUES_GET_WITH_DD_NAME (ebenso ..NO_DD_NAME) verwendet. Die Rückstellung der Werte erfolgt mittels DYNP_VALUES_UPDATE.

Die Feldnamen in DYNPFIELDS dürfen vom Benutzer selbst definiert werden wie im Beispiel oben, wo auf dem Dynpro die Felder TABNAME und FIELDNAME vorkommen. Ein Dictionarybezug dieser Felder (... like...) ist davon unbenommen.

Alle Ausnahmen werden von der C-Funktion HELP_GET_FIELDS hervorgerufen.

Um in Steploops die aktuelle Zeile zu erhalten, muß vor Aufruf von DYNP_VALUES_READ der Funktionsbaustein DYNP_GET_STEPL gerufen werden.

Parameterbeschreibung

Parameter Bezugsfeld/-struktur Vorschlagswert

Import-Parameter
DYNAME D020S-PROG
DYNUMB D020S-DNUM
TRANSLATE_TO_UPPER SPACE

Tabellen-Parameter
DYNPFIELDS DYNPREAD

Ausnahmen:
INVALID_ABAPWORKAREA
INVALID_DYNPROFIELD
INVALID_DYNPRONAME
INVALID_DYNPRONUMMER
INVALID_REQUEST
NO_FIELDDESCRIPTION
UNDEFINED_ERROR

• Import-Parameter:

• DYNAME: Name des Programms (des rufenden Bildschirms)
  Bedeutung: Name des Programms, von dem aus der Funktions-
  baustein aufgerufen wird. Hier keine SY-Felder
  setzen, da diese beim Aufruf von Funktionsbau-
  steinen dynamisch versorgt werden.
  Wertebereich: keiner
  Vorbelegung: keine

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

• TRANSLATE_TO_UPPER: Kennzeichen für Großbuchstabenkonvertierung
  Bedeutung: Falls gesetzt, dann werden die gelesenen
  Feldinhalte in Großbuchstaben konvertiert,
  auch dann, wenn im Dictionary Kleinschreibung
  für die verwendete Domäne vermerkt ist.
  Falls nicht gesetzt, dann werden die
  Feldinhalte gemäß der gepflegten Einstellung
  in der Domäne zurückgestellt.

• Tabellen-Parameter:

• DYNPFIELDS: Tabelle zum Lesen der aktuellen Dynprowerte.
  Bedeutung: Die Tabelle enthält vor dem Aufruf des
  Funktionsbausteins den Namen der zu lesenden
  Dynprofelder und nach dem Aufruf zusätzlich
  die gelesenen Werte sowie die Step-Loop-Zeilen,
  falls es sich um ein Step-Loop-Dynpro handelt.
  Ab Release 3.0A wird auch die Information
  zurückgegeben, ob das Feld eingabebereit ist
  (DYNPFIELDS-FIELDINP).

• Ausnahmen:

• INVALID_ABAPWORKAREA: Kein Arbeitsbereich
  Bedeutung: Es existiert kein gültiger ABAP-Arbeitsbereich.

• INVALID_DYNPROFIELD: Kein gültiges Dynprofeld
  Bedeutung: Das angegebene Dynprofeld ist nicht auf dem
  Dynpro vorhanden.

• INVALID_DYNPRONAME: Kein gültiger Dynproname
  Bedeutung: Das angegebene Programm ist nicht vorhanden.

• INVALID_DYNPRONUMMER: Keine gültige Dynpronummer
  Bedeutung: Das angegebene Dynpro ist gar nicht oder
  nicht in generierter Form vorhanden.

• INVALID_REQUEST: Allgemeiner Anforderungsfehler
  Bedeutung: In der Anforderung zum Dynproauslesen trat
  ein Fehler beim Systemfunktionsaufruf auf.

• NO_FIELDDESCRIPTION: Keine Feldbeschreibung vorhanden
  Bedeutung: Zum angegebenen Dynprofeld ist keine
  Beschreibung vorhanden.

• UNDEFINED_ERROR: Undefinierter Fehler
  Bedeutung: Beim Aufruf der Systemfunktion trat ein
  unbekannter Fehler auf.

Parameter

DETERMINE_LOOP_INDEX
DYNAME
DYNPFIELDS
DYNUMB
PERFORM_CONVERSION_EXITS
PERFORM_INPUT_CONVERSION
REQUEST
TRANSLATE_TO_UPPER

Ausnahmen

DOUBLE_CONVERSION
INVALID_ABAPWORKAREA
INVALID_DYNPROFIELD
INVALID_DYNPRONAME
INVALID_DYNPRONUMMER
INVALID_PARAMETER
INVALID_REQUEST
NO_FIELDDESCRIPTION
STEPL_NOT_FOUND
UNDEFIND_ERROR

Funktionsgruppe

CIFI

CPI1466 during Backup   ABAP Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 9628 Date: 20240523 Time: 154040     sap01-206 ( 65 ms )