Kontakt

Ansicht
Dokumentation

CALENDAR_VISUAL_PRESENTATION_2 - visuelle Kalenderdarstellung (Kalenderblatt ähnlich) Stand 2.1

CALENDAR_VISUAL_PRESENTATION_2 - visuelle Kalenderdarstellung (Kalenderblatt ähnlich) Stand 2.1

TXBHW - Original Tax Base Amount in Local Currency   ABAP Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Funktionalität

Mit Hilfe dieses Funktionsbausteins können datumsbezogene Anwendungsaktivitäten (z.B. Zahlungstermine, Abrechnungstermine) in Form eines Kalenderblatts visuell dargestellt werden. D. h. das Datum auf dem z.B. ein Zahlungstermin fällt wird andersfarbig im Kalenderblatt angezeigt.

Zusätztlich erhält man die Möglichkeit anwendungsspezifische Informationen und Funktionen mit in die Ausgabe des Kalenderblatts einzubinden.

Beispiel

Beispielaufruf:

DATA: HOCID LIKE SCA2-HOCID,
FACID LIKE SCA2-FACID,
DATE LIKE SCA2-DATUM,
DISPLAY LIKE SCA2-NBR_MONAT,
DISP_TYP LIKE SCA2-MODE,
WRITE_FUNCTION LIKE SCA2-FUNCTION
VALUE 'TEST_CALENDAR_WRITE',
PROCESS_FUNCTION LIKE SCA2-FUNCTION
VALUE 'TEST_CALENDAR_PROCESS',
STATUS_FUNCTION LIKE SCA2-FUNCTION
VALUE 'TEST_CALENDAR_SET_STATUS',
OK_CODE LIKE SY-XCODE.


DATA: BEGIN OF ITAB OCCURS 10.
INCLUDE STRUCTURE IATTRIBUT.
DATA: END OF ITAB.

PERFORM FILL_ITAB.
...
...

CALL FUNCTION 'CALENDAR_VISUAL_PRESENTATION'
EXPORTING
HOLIDAY_CALENDAR = HOCID
FACTORY_CALENDAR = FACID
ACTUAL_DATE = DATE
NUMBER_OF_MONTHS = DISPLAY
DISPLAY_MODE = DISP_TYP
WRITE_FUNCTION = WRITE_FUNCTION
PROCESS_FUNCTION = PROCESS_FUNCTION
SET_STATUS_FUNCTION = STATUS_FUNCTION
IMPORTING
RETURN_CODE = OK_CODE
TABLES
ATTRLIST = ITAB
EXCEPTIONS
FACTORY_CALENDAR_NOT_FOUND = 01
HOLIDAY_CALENDAR_NOT_FOUND = 02
DATE_INVALID = 03
DATE_WRONG_FORMAT = 04
DISPLAY_MODE_INVALID = 05
FUNCTION_NOT_FOUND = 06.

Um sich die Funktionalität dieses Funktionbausteins besser veranschaulichen zu können, kann der Report RSSCA2T1 als Testbeispiel aufgerufen werden. Dieser Testreport beinhaltet die bereits oben genannten Funktionsbausteine

Hinweise

Hier noch einige Hinweise, die notwendig sind um diesen Funktionsbaustein problemlos anwenden zu können.

Funktionsbausteine der Anwendung

Beispiel

  • TEST_CALENDAR_SET_STATUS,,,,setzen des GUI-Status

  • TEST_CALENDAR_WRITE,,,,,,schreiben der Anwendungsdaten

  • TEST_CALENDAR_PROCESS,,,,,,verarbeiten der Anwendungsfunktionen

Um eine problemlose Visualisierung gewährleisten zu können müssen die angegebenen Funktionsbausteine bestimmten Anforderungen entsprechen.

Die Funktionsbausteine der Parameter 'SET_STATUS_FUNCTION' und 'WRITE_FUNCTION' müssen folgende Anforderungen erfüllen:

  • keine Import-, Export- und Tabellenparameter enthalten

  • alle Ausnahmen mit MESSAGE ... RAISING erzeugen

Der Funktionbaustein des Parameters 'PROCESS_FUNCTION' muß folgende Anforderungen erfüllen:

  • Importparameter: OK_CODE

  • Exportparameter: RETURN_CODE

  • Tabellen: ATTRLIST und SELLIST

  • alle Ausnahmen mit MESSAGE ... RAISING erzeugen

Beispiel

Funktionsbaustein TEST_CALENDAR_PROCESS

DATA: H_OK_CODE LIKE SY-XCODE,
H_RETURN_CODE LIKE SY-XCODE.

* Tabelle mit Anzeigeattributen (Übergabeparameter)
DATA: BEGIN OF ATTR_TAB OCCURS 50.
INCLUDE STRUCTURE IATTRLIST.
DATA: END OF ATTR_TAB.

* Tabelle der selektierten Einträgen
DATA: BEGIN OF SEL_TAB OCCURS 50.
INCLUDE STRUCTURE ISELLIST.
DATA: END OF SEL_TAB.

CALL FUNCTION TEST_CALENDAR_PROCESS
EXPORTING
OK_CODE = H_OK_CODE
IMPORTING
RETURN_CODE = H_RETURN_CODE
TABLES
ATTRLIST = ATTR_TAB
SELLIST = SEL_TAB.

Wichtig ist es, darauf zu achten, daß alle Ausnahmen der Funktionsbausteine mit MESSAGE... RAISING erzeugt werden, da die Ausnahmen von diesem Funktionsbausteins nicht abgefangen werden.

GUI-Status setzen

Der GUI-Status kann von dem aufrufenden Anwendungsprogramm, durch die Übergabe des Anwendungs-Funktionsbausteins in dem Parameter 'SET_STATUS_FUNCTION' gesetzt werden. Wird ein eigener GUI-Status gesetzt, so muß, um alle Kalenderfunktionen zu erhalten, der GUI-Status CALE des Programms SAPLSCA2 in den GUI-Status der Anwendung includiert werden.

Funktionen des Funktionsbausteins

  • $VMO,,,,Voriger Monat

  • $NMO,,,,Nächster Monat

  • $POS,,,,Neue Monatsauswahl

  • $MRK,,,,Tag markieren

  • $MRA,,,,Alle markieren

  • $MRB,,,,Blockbegrenzung markieren

  • $MRL,,,,Alle Markierungen löschen

  • $MBL,,,,Blockmarkierung löschen

Funktionen, die nur dann gesetzt werden, wenn der Status des Visualisierungsbausteins gesetzt wird (der Parameter SET_STATUS_FUNCTIOn wird leer übergeben).

  • $BCK,,Zurück

  • $END,,Beenden

  • $CAN,,Abbrechen

Diese Funktionscode dürfen bei einem eigen definierten GUI-Status nicht verwendet werden.

Gemeinsame Funktion

  • $SEL,,,,Auswählen

Die Funktion $SEL-Auswählen muß in dem GUI-Status des Anwendungsprogramm enthalten sein, damit der Doppelklick sowohl auf die kalender- als auch auf die anwendungsspezifischen Daten angewendet werden kann.

Return-Codes des Anwendungs-Funktionsbausteins des Parameters 'PROCESS_FUNCTION'

Return-Codes

  • $END,,,,Beenden der Anwendung

  • ,,,,,,(Anwendungsfunktion BEENDEN wurde ausgelöst)

  • $CAN,,,,Abbrechen der Anwendung

  • ,,,,,,(Anwendungsfunktion ABBRECHEN wurde ausgelöst)

  • $BCK,,,,Zurück

  • ,,,,,,(entsprechende ZURÜCK Funktion wurde ausgelöst)

  • $MRL,,,,Markierungen löschen

  • $MOD,,,,Liste modifizieren

  • ,,,,,,(es erfolgt kein Bildwechsel)

  • $NEW,,,,Liste neu aufbauen

  • ,,,,,,(es erfolgt ein Bildwechsel)

  • ' ',,Wiederanzeige, alles bleibt unverändert

Diese Return-Codes werden von dem Funktionsbaustein für weitere Steuerungen verwendet.

Ausgabeattribute der datumsbezogenen Anwendungsdaten

Die Einstellungen, mit welchen Ausgabeattribute die datumsbezogenen Anwendungsdaten aufbereitet werden sollen, müssen in der Tabelle ATTRLIST hinterlegt werden. Diese Tabelle wird auch von dem Anwendungs-Funktionsbaustein des Parameters 'PROCESS_FUNCTION' verwendet.

Die Tabelle ATTRLIST hat folgenden Aufbau:

  • VDATE,,,,Datum von

  • BDATE,,,,Datum bis

  • COLOR,,,,Farbe (1,2,3,4,5,7)

  • INTEN,,,,INTENSIFIED (0 = OFF, 1 = ON)

  • INVER,,,,INVERSE (0 = OFF, 1 = ON)

Ausnahmen

  • die Farbe 0 und 6 werden komplett von dem Visualisierungs-Funktionsbausteins verwendet
  • die Angabe zur INVERSE-Darstellung der Farbe ist zur Zeit nur für den Visualisierungs-Funktionsbaustein vorgesehen und sollte somit nur mit OFF übergeben werden

Zusätzlich zu diesem Funktionsbaustein, gibt es noch den Baustein CALENDAR_VISUAL_INFORMATION, der aktuelle Informationen der Kalendervisualisierung zur Verfügung stellt.





Parameter

ACTUAL_DATE
ATTRLIST
COLOR_OF_FREEDAYS
DISPLAY_MODE
FACTORY_CALENDAR
HOLIDAY_CALENDAR
LAYOUT_MODE
NUMBER_OF_MONTHS
PROCESS_FUNCTION
RETURN_CODE
SET_STATUS_FUNCTION
WRITE_FUNCTION

Ausnahmen

DATE_INVALID
DATE_WRONG_FORMAT
DISPLAY_MODE_INVALID
FACTORY_CALENDAR_NOT_FOUND
FUNCTION_NOT_FOUND
HOLIDAY_CALENDAR_NOT_FOUND
NUMBER_OF_MONTH_NOT_FOUND

Funktionsgruppe

SCA2

ABAP Short Reference   Fill RESBD Structure from EBP Component Structure  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 13209 Date: 20240523 Time: 113012     sap01-206 ( 126 ms )