This chapter discusses the procedure to create a Holiday Calendar and generate a list of weekend and holiday dates. Individual applications may consume the holiday calendar events in different ways, so refer to application-specific user guides and/or the Cash Flow Engine Reference Guide for more details.
Topics:
· Overview of Holiday Calendars
· Searching for a Holiday Calendar
· Executing the Holiday Calendar
A Holiday is a day designated as having special significance for which individuals, a government, or some religious groups have deemed that observance is warranted and thus no business is carried on this day. The Holiday Calendar code can range from 1 to 99999.
The procedure for working with and managing a Holiday Calendar is similar to that of other OFSAA business rules. It includes the following steps:
· Searching for a Holiday Calendar.Viewing and Updating a Holiday Calendar.
· Copying a Holiday Calendar
· Deleting a Holiday Calendar
· Checking Dependencies in the Holiday Calendar definitions
· Refreshing the Holiday Calendar Summary page
Search for a Holiday Calendar to perform any of the following tasks:
· View
· Edit
· Copy
· Delete
· Check Dependencies
· Refresh
Figure 1: Holiday Calendar Summary page
Prerequisites
Predefined Holiday Calendar
To add a new Holiday Calendar rule, follow these steps:
1. Navigate to the Holiday Calendar Summary page. This page holds all Holiday Calendars and related functionality. You can navigate to other pages relating to the Holiday Calendar from this page.
2. Enter the name of the Holiday Calendar and click Search.
Only holiday calendars that match the search criteria are displayed.
|
NOTE |
You can control the number of rows to display on-screen by selecting Pagination Options from the action bar. |
You create holiday calendars to capture holidays for a given date range for any organiza-tion. It is possible to create and use multiple Holiday Calendars.
To create a Holiday Calendar, follow these steps:
1. Navigate to the Holiday Calendar Summary page.
2. Click Add Holiday Calendar.
3. The Holiday Calendar Definition page is displayed.
Figure 2: Holiday Calendar Definition page
This illustration shows the Holiday Calendar parameters of the Holiday Calendar Definition page. Select the Weekend Days from Monday, Tuesday, Wednesday, Thursday, Fri-day, Saturday, and Sunday using the corresponding checkboxes. Define the Holiday Period using the Calendar icon. Click Add (
) to enter the holiday details. You must follow these steps.
4. Enter a code value for the new holiday calendar.
The code is a numeric identifier for the holiday calendar. The code value must be a number between 1 and 99999. The code value you assign to the new holiday calendar must be unique.
5. Enter the name and a brief description of the holiday calendar.
The name you assign to the holiday calendar must be unique. The Name field can hold a maximum of 30 characters.
6. In the Holiday Properties pane, select not more than two weekend days, then choose the Holiday Period. The Holiday Period can be defined for a range of up to 40 years less than the current date and 40 years greater than the current date, totally spanning a maximum of 80 years.
In the Holiday Details pane, define the Holiday details for any period within the holiday range defined in Step 6. Two types of holidays can be defined: Fixed and Moving.
A fixed holiday is one which is deemed as a holiday for every year in the holiday pe-riod, for that particular day.
Example:
25th December - Christmas, is a fixed holiday.
|
NOTE |
To define a fixed holiday, input the holiday date for the first occurrence in the date range. For example, if your Date Range runs from 01-JAN-2000 to 31-DEC-2050, you should input the fixed holiday, Christmas, as 25-DEC-2000. The holiday calendar procedure will populate all subsequent 25-DEC entries in the holiday list table (FSI_HOLIDAY_LIST). |
A HOLIDAY_TYPE code = 0 is a Fixed type holiday, code = 1 is a Moving type holiday, and code = 2 is a weekend.
The holiday calendar procedure will also ensure that holiday and weekend entries are not duplicated. For example, if weekends are defined as Saturday or Sunday and Christmas falls on a weekend day, there will be only one entry in the FSI_HOLIDAY_LIST table. The PREVIOUS_WORKINGDAY and NEXT_WORKINGDAY fields designate the valid prior and following working days, respectively.
A moving holiday is one which is deemed as a holiday only for that particular date and year, and not for every year in the holiday period. All occurrences of a moving holiday must be entered manually.
For example, 10th April 2020 is a moving holiday for Good Friday.
7. After the holiday calendar definition is saved, its status in the Summary page is marked as defined.
8. A holiday calendar created can also be deleted. Select one or more rows of holiday calendar definitions and click Delete control.
Excel Import or Export functionality is used for adding or editing holiday calendar definitions.
Figure 3: Holiday Details
You can execute a holiday calendar definition to generate calendar dates listing the types of holidays for a given holiday period.
Prerequisites
Predefined Rules
To execute the Holiday Calendar, follow these steps:
1. Navigate to the Holiday Calendar Summary page.
2. Search for a rule.
3. Select a Holiday Calendar and click Generate Calendar Dates to execute the selected holiday calendar. The following message appears:
Holiday list for holiday ID #1 generated successfully. (where #1 is the holiday calendar code). The holiday list can be confirmed by querying the FSI_HOLIDAY_LIST table.
4. The status of a holiday calendar where holiday dates have been generated displays as Processed in the Status column in the Summary page.
If you do not want to Generate Calendar Dates immediately, you can select that particular holiday calendar anytime later from the Summary page with its status defined, and then click Generate Calendar Dates to execute the selected holiday calendar.
5. The generated holiday list is no longer valid if the following occurs:
a. There is a change in the definition of the holiday calendar.
b. There is any update or modification to the Holiday Exceptions defined for that holiday calendar.
If these occur, the following message displays:
This holiday calendar has been modified, Please generate the holiday list again and the Holiday Calendar state will be changed to Defined until the holiday list is regenerated with a new definition.
You can specify exceptions to holidays. As a prerequisite, a holiday calendar must be properly defined and the status of the holiday calendar in the Summary page must be Processed. Generating the holiday list will populate the holidays (weekends, fixed and moving) along with the working days. Then the Show Exceptions button is enabled in the Detail page. Any changes in the holiday definition will disable the Show Exceptions button. You must generate the holiday list again to define or view the exceptions.
1. Click Show Exceptions to open the Holiday Exceptions pane.
2. The search block in the Holiday Exceptions page has the following fields:
§ From (Year) and To (Year): Denotes the range of years which is a subset out of the holiday list generated, for which exceptions are required to be defined.
§ Fixed Holidays: You can filter the list of holidays by the type of Fixed Holidays.
§ Moving Holidays: You can filter the list of holidays by the type of Moving Holidays.
§ Holiday Date: For a particular known holiday date, exceptions can be defined.
§ All Exceptions: Selecting this check box lists all the exceptions, if already defined, for the holidays within the From, To Date range.
The search result gives the list of all holidays based on the selection of these search criteria fields.
3. In the Holiday Exceptions pane, there are two types of exceptions that can be defined: Not a Holiday and Shift to.
Any holiday can be marked as not a holiday, if that day is removed from the Holiday List. If the drop-down list in the Exception Type is selected as Not a Holiday, then the Shift to date picker field is disabled.
Spring earlier considered as a holiday in the holiday calendar can be marked as Not a Holiday in the Exceptions Window. Further, you can write comments or remarks in the Notes text box next to the Exception Type drop-down list.
Any holiday can be shifted to another day. When this occurs, the earlier declared holiday is removed from the Holiday List, while the shift to day is included as a holiday.