Ansicht
Dokumentation

HR_BLP_READ_TIMEDATA - Einlesen von Zeitdaten

RFUMSV00 - Advance Return for Tax on Sales/Purchases   CL_GUI_FRONTEND_SERVICES - Frontend Services  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Der Funktionsbaustein liest Zeitdaten (Leistungslohndaten, Zeitinfotypen, deren Kontierungsdaten, Kontingentabtragung, Kalendereinträge usw.). Er bildet das Interface zwischen der Präsentationsschicht des Arbeitsplatzes Personalzeitmanagement (TMW) und der Datenbankschicht, dem TMW-Puffer. Durch den Funktionsbaustein sind folgende Aufgaben abgedeckt:

1. Einlesen von gepufferten Zeitdaten
2. Einlesen von Strukturen des persönlichen Arbeitszeitplans (nicht gepuffert)
3. Einlesen von Ergebnissen der Zeitauswertung (nicht gepuffert)
4. Beschaffung von abhängigen Zeitdaten (optional)

Beispiel - Abwesenheiten und Kontingentabtragung. Die Abhängigkeiten zwischen den einzelnen Zeitdatentypen sind fest vordefiniert. Die Beschaffung von abhängigen Zeitdaten kann lediglich auf Wunsch ein- oder ausgeschaltet werden.

1. Prüfung der Leseberechtigung für die Sätze der Treffermenge
2. Rückgabe der beim Lesen aufgetretenen Fehler und sonstigen Meldungen

Dadurch wird dem Aufrufer die Wahl überlassen, ob diese Fehler in dem Message-Handler-Puffer eingetragen werden, oder direkt behandelt werden.

Der Zugriff auf die Zeitdaten erfolgt entweder über die Satzkennung (RECUID) oder über die Selektionskriterien

• PERNRGROUP

• SELCATTYPE

• FROMDATE

• TODATE

Ist weder RECUID noch eine Zeile in der Tabelle PERNRGROUP gefüllt, wird eine Ausnahme ausgelöst. Die Vollständigkeit der Treffermenge wird durch die Berechtigungen des Aufrufers bestimmt. Der Rückgabeparameter RETCD gibt den Grad dieser Vollständigkeit an. Ist RETCD größer Null, können die Fehlermeldungen aus dem Rückgabeparameter MESSAGETAB nachgelesen werden.

Der Rückgabeparameter RETCD hat folgende Bedeutungen:

Wert	Bedeutung
0	Es sind keine Fehler aufgetreten
1	Einige Zeitdatensätze wurden wegen mangelnder
	Leseberechtigung übersprungen
2	Alle selektierten Sätze wurden wegen mangelnder
	Leseberechtigung übersprungen
4	Kein Satz entspricht den Selektionskriterien (UID inklusive)
8	Fehler beim Auslesen der dynamischen Kategorien PWS, TIMRES
	Treffermenge ist eventuell unvollständig (Details im
	MESSAGETAB)
16	Technischer Puffer-Fehler: Treffermenge ist unvollständig
	(Details über MESAGETAB)

Im RETCD steht die Summe aller aufgetretenen Fehlercodes.

Beispiel

Hinweise

Lesezugriffe können performanter gestaltet werden, indem man die Filter in der Struktur SELCATTYPE zur Einschränkung der Treffermenge benutzt.

Der Parameter RECORD_STATUS steuert den Satzstatus für die Selektion von gepufferten Zeitdaten. Folgende Eingabewerte sind möglich:

• 0 - letzte fehlerfreie Version (default)

• 1 - Datenbankversion

• 2 - aktuelle Version, auch wenn diese fehlerhaft ist

Da die Zeitdaten zwecks Speicheroptimierung in einer tief geschachtelten Tabellenstruktur zurückgegeben werden, empfiehlt es sich, das Auslesen der verschiedenen Datenkategorien über unterstützende Funktionsbausteine in der Funktionsgruppe HRTIM00_TMWSUPPFUNCPOOL durchzuführen. Z.B. können eingelesene Infotypdaten (Infotypsätze, zugehörige Kontierungsinformation und Langtexte) über den Funktionsbaustein HR_TMW_ITDATA_FROM_BLPREQUEST ausgelesen werden.

Die Arbeitszeitpläne werden zwecks Performanceoptimierung intern "gecached". Der Funtkionsbaustein geht dabei davon aus, daß sich die zum Aufbau des AZPs benötigten Infotypen 0000, 0001, 0002, 0007, 2001, 2002 und 2003 im BLP-Puffer nicht geändert haben. Dadurch werden meistens unnötige Infotyplesezugriffe vermieden. Wenn eine Transkation Zeit- oder Stammdaten ändert und für die Änderung der Zeitdaten nicht den Business Logic Processor benutzt, muß sie selbst darauf achten, daß bei relevanten Änderungen der obigen Infotypen der Lesecache für Arbeitszeitpläne invalidiert wird. Dazu steht der Funktionsbaustein HR_TMW_INVALIDATE_PWS_CACHE zur Verfügung.

Weiterführende Informationen

Parameter

CONTEXT_TAB
FROMDATE
GET_DEPENDENT
MESSAGETAB
NO_AUTHCHECK
PERNRGROUP
RECORD_STATUS
RECUIDLIST
RETCD
SELCATTYPE
TIME_DATA
TODATE

Ausnahmen

MISSING_RECUID_AND_PERNRGROUP
NOT_BUFFERED
RECORD_STATUS_INVALID
RECUID_AND_PERNRGROUP_PASSED
WRONG_CATEGORY

Funktionsgruppe

HRTIM00_TMWPREPROCESSOR

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

Length: 6859 Date: 20240523 Time: 071221     sap01-206 ( 93 ms )