Documentation  >  Admin  > 

Holidays

Overview

This document describes the Holidays screen in the Admin screen which can be used for managing holidays and relations between holidays and feeds. The Holidays screen is used to configure the holidays used to calculate ticket and investigation due dates. It also determines when activity is considered after hours for billing purposes.

The main part of the screen is an editable table for changing the names and dates of holidays, as well as for marking which holidays are to be used for each feed. Holidays which are less than 7 days old and newly created and unsaved holidays can be edited. The buttons below the table allow holidays to be copied from the previous to the current year. This copies the holiday entry including the assigned feed. The Copy / Paste buttons allows the holidays to be copied from one feed to another. As changes are made, they are listed in the Pending Changes table in the lower right corner of the screen.

Details

The Holidays admin screen is shown below:

In the top part of the screen there are search controls similar to those in other admin screens. Please note that it is possible to limit both holidays (by date) and feeds (by name and state). Feeds are always sorted alphabetically, while holidays are sorted by date and order of creation. In the main part of the screen there is an editable table which can be used for editing existing holidays. Below it there are several buttons providing additional functionality.

In order to add a new holiday, click on Create button. A dialog box similar to this one will be opened:

The Save button will be enabled only if both the name and the date of the holiday are entered, so it is not possible to enter a holiday with no date or name.

Once a holiday in the screen is edited (or added), search controls will become unavailable until the data is saved or discarded using relevant buttons in the bottom part of the screen.

It is also possible to copy holidays between years. To do so, select one or more holidays (by name or by date) and click the Copy to current year button.

It will create new holidays with the same names and feeds as original holidays. However, if the date of a selected holiday is already in the current year, nothing will be changed. The screen below presents the state after the button was pressed. Note that the Christmas Day holiday for 2007 was created and assigned to all feeds for which the original Christmas Day holiday was assigned. The New Year's Day holiday remained unchanged because its year was equal to 2007, which was the current year at the time when this document was created.

This way 2 new holidays have been created using only a few clicks, and they all have properties (month and day of month, feeds) equal to the original versions. However, there is a holiday whose date should not be equal to the original: Labor Day. In 2006, it fell on the 4th of September, not on the 5th like a year before.

In order to edit the name or date of an existing holiday, double-click on the cell displaying the information that should be changed. If the date or name is cleared, it will be rolled back to the value from right before it was edited.

In order to edit what feeds a holidays is assigned to, click on the relevant cells inside the grid. Note that the feed and holiday names are highlighted as the mouse is moved over the cells.

Note: Not all holidays can be edited - only those which have just been created (including holidays copied from another year), or whose date is no more than 7 days ago from the current date. At the moment of writing, it's October 24, 2006. If a new holiday entry with date before October 17, 2006 (e.g. Labor Day) is created, it can be edited. However, once it is saved, it will no longer be considered new, so it would no longer be possible to modify it.

If a holiday has just been created and not yet saved, it can be deleted using the Delete button in the bottom of the screen.

It is also possible to copy holidays between feeds by using Copy (to clipboard) and Paste (from clipboard). In order to do so, select a feed by clicking its name. Once a feed is selected, all the cells in its column will become highlighted to confirm the selection. To copy a feed to the clipboard, press the Copy button below the table. Note that the feed that is currently in the clipboard is displayed next to the buttons. To copy a feed from the clipboard, select another feed (by clicking its name) and clicking the Paste button.

In this example, holidays are copied from the CEN3 feed to the testfeed1 feed. If a holiday is assigned to the CEN3 feed and is new or no more than a week old (see above), it will be assigned to the testfeed1 feed also. However, if a holiday is editable, but not assigned to a source feed, it will not change assignment of this holiday for destination feed. In the lower right part of the screen is a Pending Changes table.

The Pending Changes table shows what changes have been made that have not yet been saved. These changes will be saved when the Save button is pressed. There are three types of changes listed:

• Create - a new holiday was created with the Create button
• Add - a check box was selected to turn on a holiday for a feed
• Remove - a check box was unmarked to turn off a holiday for a feed

When an action is undone, the corresponding entry is removed from the Pending Changes table. For example, if a check box is checked, an Add entry will be added to the pending changes. If, without saving, the box is unchecked, then the Add entry will be removed from the pending changes list. The Save button will save all of the pending changes and will clear the Pending Changes table. The discard button will also clear the Pending Changes table, but in this case the changes will be discarded and the holiday table will be re-loaded with unchanged data.