CheckHoliday

Description (v1.2.0)

Release notes

Action parameters

• Holiday list 1 to Holiday list 5: A global parameter of the 'String' type which must contain dates in one of the following formats:
  • DDMM (day from 01 to 31, month from 01 to 12) prefixed and postfixed by a dash (the '-' character).
  • DDMMYYYY (day from 01 to 31, month from 01 to 12, year from 0000 to 9999) prefixed and postfixed by a dash (the '-' character).

A global parameter must not contain more than 255 characters. If more dates are needed than can be fit in 1 parameter, please create a second global parameter.

Example of use

This action allows you to define multiple lists simultaneously. We can benefit from this by keeping the fixed dates and the moving dates separate.

Fixed dates always occur on the same day each year. Example:

• The first of January, indicated in the parameter by '-0101-'
• The twenty fifth of December, indicated in the parameter by '-2512-'

Moving dates don't always occur on the same day each year, and must be defined including the year. Example:

• Easter Sunday, indicated in the parameter by '-23032008-12042009-04042010-24042011-08042012-' and so on. This particular list will cover all Easter Sundays from 2008 to 2012.

If we want to apply these examples to a real life setup, we'll start by defining 2 global parameters of the type 'String' with names of your choice. The value of the first global parameter will contain all 'fixed' dates. The second global parameter will contain moving date. Example:

• holiday_fixed will be set to '-0101-2107-1508-0111-1111-2512-'
• holiday_moving will be set to '-23032008-12042009-04042010-24042011-08042012-11052008-31052009-23052010-'

Next, we will assign 'holiday_fixed' to 'Holiday list 1' and 'holiday_moving' to 'Holiday list 2' in the action. When this action is triggered by a call, it will check if the current date matches a date defined in 'holiday_fixed' or 'holiday_moving'. If the action determines that the call happens during a holiday, we can play a message informing the called that the offices are closed. If not, we'll call the receptionist.

Fixed dates and moving dates can also be combined in 1 global parameter, although this is not recommended as it increases management complexity. Example:

• holiday_all set to '-0101-2107-1508-0111-1111-2512-23032008-12042009-04042010-24042011-08042012-11052008-31052009-23052010-'

Maintaining

• Fixed dates are easy to define: Once defined, no changes are necessary.
• Moving dates change each year and should be revised from time to time to make sure that they are still correct.