Ansicht
Dokumentation

RS_EXTERNAL_SELSCREEN_STATUS - Selektionsbild: eigener, in Funktionsgruppe definierter GUI-Status

Addresses (Business Address Services)   Addresses (Business Address Services)  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Mitteilung an das Laufzeitsystem, daß auf dem Selektionsbild ein eigener GUI-Status gesetzt werden soll, und zwar ein in einer Funktionsgruppe extern definierter.

Dieser Funktionsbaustein kann jederzeit während des (oder auch vor dem) Prozessieren des Selektionsbildes aufgerufen werden (also z.B. in der Routine INIT oder PBO im Datenbankprogramm SAPDBxyz oder aber bei INITIALIZATION oder AT SELECTION-SCREEN OUTPUT im Report selbst).

Dem Laufzeitsystem wird im Parameter P_FB der Name eines Funktionsbausteins mitgeteilt. Jedesmal, wenn 'normalerweise' der GUI-Status für das Selektionsbild gesetzt wird, wird nun stattdessen der mitgeteilte Funktionsbaustein aufgerufen. Dieser kann per SET PF-STATUS .... den gewünschten Status setzen. Auch kann per SET TITLEBAR ... ein eigener Titel für das Selektionsbild gesetzt werden.

Der Funktionsbaustein muß(!!) folgende Schnittstelle haben:

IMPORT-Parameter P_SUBMIT_MODE: Diesem werden je nach Art der aktuellen
Programmausführung folgende Werte
übergeben:
Blank: normaler SUBMIT
'V': Submit für Variantenpflege
'J': SUBMIT VIA JOB:
Hintergrundeinplanung.
Mit dieser Information kann der richtige Status für die richtige
Situation gesetzt werden (also beispielsweise kein 'Ausführen' bei
der Variantenpflege). Auch besteht die Möglichkeit, beispielsweise
bei der Variantenpflege und der Hintergrundeinplanung überhaupt
keinen eigenen Status zu setzen, indem man in diesen Situationen
die Ausnahme NO_ACTION auslöst. In diesem Fall wird der
Standard-Status gesetzt.

Tabellen-Parameter P_EXCLUDE mit Struktur RSEXFCODE.
Diese Tabelle wird an den Funktionsbaustein übergeben. Sie enthält
die Funktionscode, die in der aktuellen Situation auf jeden Fall
ausgeschlossen werden müssen. Der Funktionsbaustein ist also
verpflichtet(!!), an den SET PF-STATUS ... den Zusatz
EXCLUDING P_EXCLUDE anzuhängen.

Ausnahme NO_ACTION: Bedeutet, daß kein eigener Status gesetzt wird
(s.o).

Achtung: Werden Funktionstasten verwendet (oder aus dem Standardstatus mit übernommen), die einen dynamischen Text haben, so werden die Texte aus den entsprechenden Dictionaryfeldern der Funktionsgruppe genommen, bei der der Gui-Status definiert ist. Ein Beispiel hierfür ist die Drucktaste für die freien Abgrenzungen, deren Text zur Laufzeit aus dem Feld SSCRTEXTS-DYNSEL versorgt wird. Wird diese Taste im extern gesetzten Status beibehalten, so muß die Funktionsgruppe eine Anweisung
TABLES SSCRTEXTS.
enthalten, und das Feld SSCRTEXTS-DYNSEL muß den Text ('Freie Abgrenzungen') enthalten.

Beispiel

Beispiel für den Aufruf von RS_EXTERNAL_SELSCREEN_STATUS:

PROGRAM SAPDBxyz DEFINING DATABASE xyz.

...
FORM INIT.
CALL FUNCTION 'RS_EXTERNAL_SELSCREEN_STATUS'
EXPORTING P_FB = 'TEST_EXTERNAL_STATUS'.
ENDFORM.
...

Beispiel für den Funktionsbaustein, der den Status setzt:

FUNCTION TEST_EXTERNAL_STATUS.
*"------------------------------------------------------
*"*"Lokale Schnittstelle:
*" IMPORTING
*" P_SUBMIT_MODE
*" TABLES
*" P_EXCLUDE STRUCTURE RSEXFCODE
*" EXCEPTIONS
*" NO_ACTION
*"-------------------------------------------------------------

IF P_SUBMIT_MODE NE SPACE.
RAISE NO_ACTION.
ENDIF.
SET PF-STATUS 'TEST' EXCLUDING P_EXCLUDE.
SET TITLEBAR 'TST'.

ENDFUNCTION.

Weiterführende Informationen

Parameter

P_FB

Ausnahmen

Funktionsgruppe

SLDB

BAL Application Log Documentation   SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 4390 Date: 20240523 Time: 121137     sap01-206 ( 58 ms )