Cancellation Of Leave {P00004-2}

This Menu Option is used by employees to cancel leave applications submitted through the iEnabler Leave functionality.

There are two categories of Leave Applications that may be cancelled, and the employee’s leave applications that meet the criteria are displayed on the screen, under two headings, as detailed below:

·       Leave Applications Awaiting Approval

·       Finalised Leave Applications

 

Leave Applications Awaiting Approval

All Leave Applications that are still in the approval process are displayed; this includes history leave applications for a leave period where the Start and End date is in the past as well as leave applications where the start and end date are in the future.

The user will click on the Routing Number of the Leave Application they wish to cancel.  A screen will open with the Leave Application details, to submit the cancellation, the user must click on the Save Button.  A Cancel Reason may be added prior to saving the record (optional).  By clicking on the Save Button, the cancellation process begins. Additional Supporting Documentation may also be uploaded once the application has been saved.  The user may click on the Return Button to return to the list of leave applications form.

Once saved, the Leave Application will no longer be displayed under the list of leave applications that may be cancelled.

The Leave Application Routing (Routing Type WEBL) setup process is followed.

Finalised Leave Applications:

Leave Applications for the applicant, applied for through the iEnabler functionality, that have been approved, copied into the back office and that meet the criteria detailed below, are displayed under this heading.

The criteria for leave applications, that have been approved and copied into the back office, which the applicant may apply to cancel, is controlled by SOD ‘GA’ {GSC2-11}.  This SOD allows the institution to define how many prior months, validated to the current date, history leave records may be cancelled i.e. if 6 is defined for the SOD and the current date is 01-Mar-2021, leave records where the Start Date is 01-Oct-2020 and later will be displayed.  Future leave applications are also displayed i.e. if Start Date is greater than sysdate, they will be displayed too.

Therefore, if an institution wishes to allow employees to cancel history approved leave applications, the number of months as explained above will be defined for SOD ‘GA’.  Should only the cancellation of approved, future leave records be allowed, then 0 will be defined for SOD ‘GA’.


The following leave records will be excluded from the list:

Once the application to cancel the leave has been successfully saved, a new routing request number is generated for Approval, Routing Type ‘WEBC’ is used.  The same leave approval process as defined for Leave Applications, Routing Type ‘WEBL’ may also be defined for Routing Type ‘WEBC’ {GROU-1}

The following set-up is required for the uploading of supporting documents:.

Prompt Number

Prompt

Reference Type

Object

1

Personnel Number

N

NUM

2

Leave Type

A

Type

3

Leave Start Date

D

SDATE

Routing

Refer to the documentation on the Routing System {GMAIN-4} for information about routing.

  1. When the Leave Application is saved, the System will automatically create a Routing Request for Routing Entry Type "WEBC".
  2. The Routing System may then be configured to notify the persons involved and allow the responsible personnel members to approve or reject the leave application.
  3. The Routing Sequence for final approval should have only two outcomes, i.e. Approved (APPR) or Rejected (REJ); it should lead to a sequence that executes database procedure person.wl01pkg.approve_reject_leave. This procedure will update the Web Leave Applications Table with: the date of final approval, the approval status (Approved or Rejected), and a completed date by which to prepare the approved application that is to be copied into the ITS Leave System with Leave Records {PLOP-8}.
  4. All sequences where the application may be rejected, should lead to the above sequence with the database procedure (person.wl01pkg.approve_reject_leave), if the outcome of the sequence indicates that the application is rejected.
  5. The following information will be written to the Routing Email Instructions for Sequence 0 of the Routing Request, for the lines indicated. (Data from the System between <>). This may be used by the Routing System as text in Email messages and / or to route the application to different personnel members for approval.

Line Number

Email Instruction

1

"Application For Leave"
"Application For Selling Of Leave"
"The Cancellation Of an Application For Leave"
"The Cancellation Of an Application For Selling Of Leave"

2

"Applicant: " <Personnel Number, Name and Surname>

3

<Applicant Primary Email Address>

4

"Email Address: " <Applicant Primary Email>

5

"Telephone Numbers : " <Applicant Primary Contact Numbers>

6

<Routing Request Number>

11

<Applicant's Personnel Number>

12

<Applicant's Email Address>

13

<Supervisor's Personnel Number>

14

<Supervisor's Email Address>

20

"Applicant From : " <Personnel Number, Name and Surname of the Applicant>.  This may be used by the Routing System to route the application to different personnel members for approval.

21

"Department : " <Applicant's primary Department Code>

22

<Applicant's Primary Department Code>

23

"Number of days : " <Number of Days Applied For>

24

"Start Date : " <Leave Start Date

25

"End Date : " <Leave End Date>

26

"Payment Month : " <Payment Month where it is an Application to Sell Leave>

27

"Type Of Leave : " <Leave Type Name>

28

"Current Status : " <Approval Status>

29

"Please Note: A medical certificate needs to be submitted" (Where Applicable)

30

"Application Date : " <Leave Application Date>

31

<Notes as entered on the Leave Application - The first 80 Characters>

32

<Notes as entered on the Leave Application - The next 80 Characters>

33

<Notes as entered on the Leave Application - The next 80 Characters>

34

<Notes as entered on the Leave Application - The next 80 Characters>

  1. The System may also be configured to write additional information from the Organizational Contacts {GCS-10} to the Routing Email Instructions for Sequence 0 of the Routing Request. This may be used by the Routing System to route the application to different personnel members for approval.

The Organizational Contacts {GCS-10} allows the user to indicate different Communication Levels (e.g. Departments or Faculties) and different Types (e.g. Department Heads, Department Head Secretaries), and to link a Personnel Number as a Contact Person for each Level and Type.
In this way, a list of Department Heads, or a list of their Secretaries may be maintained.

           7.     The instruction to write the additional information should be entered in a line of its own the Routing Email Instructions of the Default Request Information {GROU-1} for Routing Entry Type "WEBL", after line 34, as follows:

                  $OE,Dxxx,nn$  or
            $ON,Dxxx,nn$  or
            $OU,Dxxx,nn$  or
            $OE,Fxxx,nn$  or
            $ON,Fxxx,nn$  or
            $OU,Fxxx,nn$  or

            where

 

The user will click on the Routing Number of the Leave Application they wish to cancel.  A screen will open with the Leave Application details, to submit the cancellation, the user must click on the Save Button.  A Cancel Reason is a mandatory requirement and the cancellation application may not be saved unless completed.  By clicking on the Save Button, the cancellation process begins. Additional Supporting Documentation may also be uploaded once the application has been saved.  The user may click on the Return Button to return to the list of leave applications form.

 

Once saved, the Leave Application will no longer be displayed under the list of leave applications that may be cancelled.

 

Please Note the following:

1.      The Applicant may only re-apply for leave, where cancelled leave dates overlap with the new application dates, after the Approved Leave Cancellation record has been copied {PLOP-8} to the back-office {PLOP-1}.

 

2.      Leave Types where the field "iEnabler Characteristics" in the Leave Package Structure {PLCS-3} is set to the following will be will be excluded from this screen

o   "N" - Cannot Apply via Web, but Display Detail on Web

o   "D" - Cannot Apply via Web, and do not Display Detail on Web

 

3.      Leave Applications where the End Date is before the "Leave Accumulation Date" for the Leave Type {PLCS-2} will not be displayed.

4.      iEnabler leave balance will exclude any cancellation leave applications until approved.

Example

History of Changes

Date System Version By Whom Job Description
30-May-2007 v01.0.0.0 Charlene van der Schyff t137175 New manual format.
15-Aug-2007 v01.0.0.0 Allie t117453 Correct manual for release.
09-Apr-2008 v01.0.0.0 Frans T146449 Upload Supporting Documents.
22-Sep-2008 v01.0.0.1 Frans T152966 Exclude Leave Types and Records.
19-Oct-2008 v01.0.0.1 Magda van der Westhuizen t151711 Update manual:  Language Editing:  Juliet Gillies.
27-Nov-2019 v04.0.0.0 Kerrylee Naidoo t240519 Update manual: exclude any cancellation leave application until approved
05-Mar-2021 v04.1.0.1 Kerrylee naidoo t236797 Update Manual with changes