SUBPLN script: SUBPLN
AV_VALOR entry point
This entry point can be used when entering working times and/or updating payroll variables to value the number of days and/or hours between two dates, for an employee. This entry point is called before the standard valuation of the employee's planning.
If the value of the OK variable is 0 on leaving this entry point, the standard valuation will be performed.
AP_VALOR entry point
This entry point can be used when entering working times and/or updating payroll variables to revalue the number of days and/or hours between two dates, for an employee. This entry point is called after the standard valuation of the employee's planning.
Context and operating method
Log file
The GTRACE variable must be tested. If GTRACE<> » » a log file is opened, otherwise GTRACE= » ».
Different call cases
The SUBPLN script is called from the following functions:
- Time sheets
- Time entry
- Time adjustment entry
- Global creation of a time line
- Global deletion of a time line
- Time cut-off, if the "Time summary calculations" box or the "Pay variable update" box is selected.
- Time summary
- Employee values, with the "Functions / Sequences" button if the "Time summary calculations" box or the "Pay variable update" box is selected.
- Annual employment report calculation
- Extraction of DADS-U specific situations
The SUBPLN processing calls the AV_VALOR & AP_VALOR entry points once during the valuation of the number of hours and days between two dates.
The AV_VALOR entry point is called before the standard valuation of the days and hours included within a period. This standard valuation is performed based on the planning and updates the variables HEURE (number of hours) and JOUR (number of days). The entry point is used to initialize these values. If you want to prevent the standard valuation performed on leaving this entry point, position the OK variable to 1.
The AP_VALOR entry point is called after the standard valuation of the days and hours included within a period. This standard valuation is performed based on the planning and updates the variables HEURE (number of hours) and JOUR (number of days). The entry point is used to modify these values.
Available variables and masks
Variable or mask |
Definition |
Char() MATRI |
Employee's ID number |
Date DATDEB, DATFIN |
Contains the period to be valued |
Decimal HEURE |
Valuation of the period in number of hours |
Decimal JOUR |
Valuation of the period in number of days |
Char() CODE |
Code of the time event entered for the period |
Char() SITE |
Employee's site |
Char() CTR |
Employee's contract |
Open tables
Table |
Significant |
Table title |
TIMCOD [TIM] |
Yes |
Time events |
EMPLOAD [AD] |
Yes |
Employee's administrative information |
EMPLOCTR [CTR] |
Yes |
Employee's employment contract |
PLANEMP [PLE] |
Yes |
Employee planning |
PLANTYP [PLN] |
Yes |
Reference planning |
TYPWEEK [WTY] |
Yes |
Standard week |
HLYDAY [HLY] |
Yes |
Public holidays |
FACILITY [FCY] |
Yes |
Site |