|
Functionality
This method stores the employee time data overviews in the databasetables in the target system.
The time data determined can be used as a value guide for recording inanother system (such as in a time sheet or an external system). Notes
By transferring the data to a time sheet, the data is stored in thedatabase tables PTIMEOV1 and PTIMEOV2.
When transferring data to an external system, it is important that thedata is stored in the correct database tables.
If the parameter DELETEOLDDATA is set in the method PTimeOverview.Replicate, thenthe data already existing in the tables PTIMEOV1 and PTIMEOV2 isdeleted in the entire time period from FROMDATE to TODATE for all ofthe employees entered in the EMPLOYEES parameter before the new data issaved.
The method PTimeOverview.Get createsthe overviews.
If the methodPTimeOverview.DeleteReplicatriggers the deletion of the distributed time overviews, then the datain the tables PTIMEOV1 und PTIMEOV2 is deleted in the entire timeperiod from FROMDATE to TODATE for all of the employees entered in theEMPLOYEES parameter.Description
If the DELETEOLDDATA parameter is set, existing data for all of theemployees in the table EMPLOYEES is deleted from the database tablesand replaces it with the new data. Description
The FROMDATE parameter determines the point in time as of whichemployee time data can be deleted in the target system. Description
The TODATE parameter determines the point in time up to which employeetime data can be deleted in the target system. Description
The EMPLOYEES parameter contains the personnel numbers of the employeeswhose time data overviews are to be deleted in the target system.
For more information on personnel numbers, see the corresponding dataelement documentation on the personnel number.Description
Method return code Value range
If an error occurs, this structure contains, for example, the followinginformation:
Message type (TYPE field)
Message code (CODE field)
Message text (MESSAGE field) Default
Critical errors are indicated by E (error) and A (abort),warnings by W, and information and success messages by Iand S respectively.Description
Detail entries for the time data overview are transferred in a specificstructure. For more information on the individual parameters, see thecorresponding data element documentation. Structure:
EMPLOYEENUMBER Personnel number
VALIDITYDATE Validity date
EXTAPPLICATION External application
REGULARHOURS Normal working hours of an employee onone day
REGULARBEGIN Normal start of employee's workingtime
REGULAREND Normal end of employee's working time
HOLIDAYCLASS Public holiday class
NONWORKING Indicator: Employee does not need towork
REGWORKTIMETEXT Text for normal working time on oneday
ATTENDANCEHOURS Attendance hours of an employee onone day
ABSENCEHOURS Absence hours of an employee on oneday
OVERTIMEHOURS Overtime hours of an employee on onedayDescription
The desired time types are transferred in a specific structure. Structure:
EMPLOYEENUMBER Personnel number
VALIDITYDATE Validity date
TIMETYPE Time type of an employee
TIMETYPEVALUE Value of an employee's time type on oneday |