Ansicht
Dokumentation

POPUP_GET_VALUES_USER_HELP - Dialogfenster zum Erfragen von Werten, Aufruf von User-Exits und -Help

BAL_S_LOG - Application Log: Log header data   General Material Data  
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.

Funktionalität

Der Funktionsbaustein sendet ein Dialogfenster und bietet die in der Schnittstellentabelle FIELDS aufgeführten Felder zur Eingabe oder zur Anzeige an. Die in der Tabelle FIELDS angegebenen Felder müssen im Dictionary definiert sein.

Wenn kein Text zu einem Feld übergeben wird, wird das Dictionary-Schlüsselwort angezeigt. Die Schlüsselworte und Felder können normal oder hell leuchtend angezeigt werden. Für die Felder muß außerdem definiert werden, ob sie eingabebereit oder nicht eingabebereit und ob sie obligatorisch oder nicht obligatorisch sind. Für die Felder kann eine Vorbelegung angegeben werden.

Die Eingaben des Anwenders werden übernommen und können an eine externe Unterroutine (User-Exit), die in der Schnittstelle dieses Funktionsbausteins angegeben werden kann, übergeben werden. Wenn keine externe Unterroutine angegeben wird, werden die Daten ungeprüft zurückgegeben.

Wird eine externe Unterroutine angegeben, dann muß deren Schnittstelle aus der Tabelle FIELDS und aus einer Fehlerstruktur bestehen. Die externe Unterroutine wertet die Daten aus, verarbeitet sie ggf. und füllt die Fehlerstruktur im Fehlerfall mit einer Fehlermeldung. Der Funktionsbaustein wertet die Fehlerstruktur aus und beendet die Verarbeitung, oder er sendet die übergebene Fehlermeldung und bietet die Felder erneut zur Eingabe an.

Außerdem besteht die Möglichkeit, User-Exits für die F1- und F4-Hilfe anzugeben, wenn die Standard-F1- und F4-Hilfe nicht angezeigt werden soll.

Der Funktionsbaustein kann verwendet werden, um

• Werte zu erfragen, die mehr als nur gegen die Datenbank zu prüfen sind,

• Werte zu erfragen, um Objekte zu kopieren,

• Prototyping zu unterstützen,

• etc..

Beispiele

Beispiele sind dem Programm RSSPO440 zu entnehmen.

Hinweise

• In den User-Exits kann eine beliebige Verarbeitung erfolgen. Insbesondere können wiederum die Dialogfenster dieser Funktionsgruppe aufgerufen werden

• Konvertierungsexits werden normal berücksichtigt.

• Referenzen von CURR und QUAN Feldern werden beachtet, wenn die Referenzfelder mitübergeben werden. Die Anzeige der Referenzfelder darf unterdrückt werden.

• Zu einem Währungsfeld (Typ CURR) muss auch das im DDIC zugeordnete Feld für den Währungsschlüssel (Typ CUKY) übergeben werden. Andernfalls ist das Währungsfeld nicht eingabebereit. Die Anzeige des Feldes für den Währungsschlüssel darf unterdrückt werden, wenn es initial gefüllt ist.

• Datumswerte werden entsprechend der Definition im Benutzerstamm geprüft.

• Zeitwerte müssen entsprechend der Schablone '__:__:__' eingegeben werden.

• Die F1- und F4-Hilfe wird unterstützt.

• Jedes Feld darf nur einmal angegeben werden. Wiederholfelder oder -gruppen werden nicht unterstützt. Ausnahme ist die Angabe eines Tabellennamens mit vorangestelltem Stern.

• Es sind nur Felder vom ABAP-Typ C, N, T, D, P oder Integer zulässig.

• Es werden keine Updates durchgeführt.

• Es werden maximal 10 Felder in einem Dialogfenster angeboten. Bei mehr als 10 Feldern wird ein Dialogfenster mit Blättermodus und Scrollbar gesendet. Die maximale Anzahl von Feldern pro Dialogfenster kann durch Aufruf des Funktionsbausteins POPUP_GET_VALUES_SET_MAX_FIELD geändert werden.

• Bei der Benutzung des Funktionsbausteins sollte berücksichtigt werden, dass DDIC-Tabellen implizit über Variablen übergeben werden. Eine Crossreferenz über verwendete Tabellen in Programmen kann dann diese Tabelle nicht ermitteln. Deshalb sollten, wenn möglich, die Tabellen im aufrufenden Programm unter TABLES deklariert werden.

• Die in der Tabelle FIELDS übergebenen Felder einer Tabelle dürfen maximal eine Länge von 132 Zeichen besitzen. Andernfalls werden die Werte nach 132 Zeichen abgeschnitten.

Parameter

F1_FORMNAME
F1_PROGRAMNAME
F4_FORMNAME
F4_PROGRAMNAME
FIELDS
FORMNAME
NO_CHECK_FOR_FIXED_VALUES
POPUP_TITLE
PROGRAMNAME
RETURNCODE
START_COLUMN
START_ROW

Ausnahmen

ERROR_IN_FIELDS

Funktionsgruppe

SPO4

General Material Data   General Material Data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 6588 Date: 20240523 Time: 065400     sap01-206 ( 106 ms )