Kontakt

Ansicht
Dokumentation

CALENDAR_VISUAL_PRESENTATION - visuelle Kalenderdarstellung (Kalenderblatt ähnlich)

CALENDAR_VISUAL_PRESENTATION - visuelle Kalenderdarstellung (Kalenderblatt ähnlich)

ABAP Short Reference   Vendor Master (General Section)  
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.

Mit Hilfe des Paramters LAYOUT_MODE kann gesteuert werden, ob die Monatsübersicht zu Beginn, zum Ende der Ausgabe oder gar ganz ausgeblendet werden soll. (Werte: 1 = oben einblenden, 2 = unten einblenden, 3 = ausblenden) Der Defaultwert ist 1.

Neu zu 3.0D:

Durch die Parameter HOTSPOT_FOR_DAY, HOTSPOT_FOR_WEEK und HOTSPOT_FOR_MONTH kann gesteuert werden, ob die einzelnen Tage, Kalenderwochen oder Monatsbezeichnungen als HOTSPOT ausgegebenen werden sollen oder nicht. Dies hat zur Auswirkung, daß nur noch ein Einfachklick ausreicht um einen Tag, eine Woche oder einen Monat zu selektieren und nicht mehr wie bisher per Doppelklick. Die Parameter sind von einander unabhängig. Um die HOTSPOT-Funktion anzuschalten muß ein 'X' an die einzelnen Parameter übergeben werden. Defaultmäßig wird SPACE angegeben.

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,
LAYOUT LIKE SCA2-LAYOUT,
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
LAYOUT_MODE = LAYOUT
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.

Alle Funktionscodes der Kalendervisualisierung werden an den Verarbeitungsbaustein der Anwendung weitergereicht.

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)

  • $VMO,,,,Voriger Monat (Positionieren auf den vorherigen Monat)

  • $NMO,,,,Nächster Monat (Positionieren auf den nächsten Monat)

  • $POS,,,,Positionieren auf einen anderen Monat
    ,,,,,,(entsprechnd des Übergabemonats der Tabelle SEL_TAB
    ,,,,,,Feld MONTH)

  • $MRL,,,,Markierungen löschen

  • $MOD,,,,Liste modifizieren und alle Markierungen des
    ,,,,,,Kalenderblatts werden gelöscht
    ,,,,,,(es erfolgt kein Bildwechsel)
    $MRM,,,,Liste modifizieren ohne die Markierungen des
    ,,,,,,Kalenderblatts zu löschen

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

  • $MRP,,,,Liste modifizieren ohne die Markierugnen des
    ,,,,,,Kalenderblatts zu löschen sowie die
    ,,,,,,Seitenpositionierung zurücknehmen
    ,,,,,,(es erfolgt kein Bildwechsel)

  • $MMP,,,,Liste modifizieren ohne die Markierungen des
    ,,,,,,Kalenderblatts zu löschen sowie die
    ,,,,,,Seitenpositionierung zurücknehmen
    ,,,,,,(es erfolgt kein Bildwechsel)

  • $ATT,,,,Bereitet die Visualisierung mit den neuen Attributen
    ,,,,,,auf, die mit Hilfe des Funktionsbaustein
    ,,,,,, CALENDAR_VISUAL_NEW_SELECTION
    ,,,,,,innerhalb der Kalendervisualsierung gesetzt werden

  • $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.Funktionalität

Beispiel

Hinweise

Weiterführende Informationen





Parameter

ACTUAL_DATE
ATTRLIST
COLOR_OF_FREEDAYS
DISPLAY_MODE
FACTORY_CALENDAR
HOLIDAY_CALENDAR
HOTSPOT_FOR_DAY
HOTSPOT_FOR_MONTH
HOTSPOT_FOR_WEEK
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

RFUMSV00 - Advance Return for Tax on Sales/Purchases   TXBHW - Original Tax Base Amount in Local Currency  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 15980 Date: 20240605 Time: 090756     sap01-206 ( 162 ms )