DocsCalendar configuration
Calendars within Blue Prism represent the concept of the working day. They exist to allow schedules, configured in Control Room, and processes, using the internal Calendars business object, to check if a particular day is a working day according to the rules configured in the calendar.
In order to facilitate this, calendars can be created and configured to specify which days are considered working days and which are not.
A calendar brings together three main concepts:
- Working Week – The days of the week which are considered working days for the calendar.
- Public Holidays – The public holidays, considered non-working days, which apply to the calendar.
- Other Holidays – Other holidays which are to be considered non-working days in the calendar.
A calendar's working days consist of any dates where:
- The day of the week is specified in the 'Working Week' and
- The date is not a public holiday specified in the 'Public Holidays' and
- The date is not a holiday specified in the 'Other Holidays'.
If any of these tests fail for a given date, then the date is not considered a working day according to the calendar.
Changes made to the System > System - Calendar screen are not applied during currently running sessions. If a session is running, the changes will be applied at the start of the next session run.
Default calendar
When Blue Prism is first installed, a calendar is created called "Working Week / No Holidays" which has a "Working Week" of Monday to Friday (inclusive), and specifies no holidays, public or otherwise.
Create a calendar
-
Click the calendar icon in the top right-hand side to create a new calendar.
-
Select a name for the calendar and click OK.
Calendar names must be unique – if the name entered already exists, an error displays and a new name requested.
Configure a calendar
Working Week
The working week of a calendar is defined by the days which are generally considered working days within the week.
The days in the working week are selected by checking the appropriate check boxes.
Public Holidays
Blue Prism supports public holidays lists, grouped by country. Currently, the public holidays in the following areas are directly supported:
Selecting the public holiday group displays the appropriate public holidays in the Public Holidays list.
Select the checkbox next to an entry to enable a public holiday. Enabled holidays are non-working days in a calendar.
You can quickly tick all the listed public holidays by clicking Select All. You can untick all listed public holidays by clicking Select None.
England and Wales
|
Holiday |
Calendar date |
Example |
|---|---|---|
| New Year's Day |
The first working day on or after the 1st of January. |
3rd January 2022 |
| Good Friday | The Friday that occurs immediately before Easter Sunday. | 15th April 2022 |
| Easter Monday | The Monday that occurs immediately after Easter Sunday. | 18th April 2022 |
| Early May Bank Holiday | The first Monday in May. | 2nd May 2022 |
| Spring Bank Holiday | The last Monday in May. | 30th May 2022 |
|
Summer Bank Holiday |
The last Monday in August. |
29th August 2022 |
| Christmas Day |
The first working day on or after the 25th of December. |
26th December 2022 |
| Boxing Day |
The next working day after the Christmas Day holiday. |
27th December 2022 |
Northern Ireland
|
Holiday |
Calendar date |
Example |
|---|---|---|
| New Year's Day |
The first working day on or after the 1st of January. |
2nd January 2022 |
| St Patrick’s Day | The first working day on or after the 17th of March. | 17th March 2022 |
| Good Friday | The Friday that occurs immediately before Easter Sunday. | 15th April 2022 |
| Easter Monday | The Monday that occurs immediately after Easter Sunday. | 18th April 2022 |
| Early May Bank Holiday | The first Monday in May. | 2nd May 2022 |
| Spring Bank Holiday | The last Monday in May. | 30th May 2022 |
| Orangemen’s Day | The first working day on or after the 12th of July. | 12th July 2022 |
|
Summer Bank Holiday |
The last Monday in August. |
29th August 2022 |
| Christmas Day |
The first working day on or after the 25th of December. |
26th December 2022 |
| Boxing Day |
The next working day after the Christmas Day holiday. |
27th December 2022 |
Republic of Ireland
|
Holiday |
Calendar date |
Example |
|---|---|---|
| New Year's Day |
The first working day on or after the 1st of January. |
3rd January 2022 |
| St Patrick’s Day | The first working day on or after the 17th of March. | 17th March 2022 |
| Good Friday | The Friday that occurs immediately before Easter Sunday. | 15th April 2022 |
| Easter Monday | The Monday that occurs immediately after Easter Sunday. | 18th April 2022 |
| Early May Bank Holiday | The first Monday in May. | 2nd May 2022 |
| June Bank Holiday | The first Monday in June. | 6th June 2022 |
| August Bank Holiday |
The first Monday in August. |
1st August 2022 |
| October Bank Holiday | The last Monday in October. | 31st October 2022 |
| Christmas Day |
The first working day on or after the 25th of December. |
26th December 2022 |
|
St Stephen's Day |
The next working day after the Christmas Day holiday. |
27th December 2022 |
Scotland
|
Holiday |
Calendar date |
Example |
|---|---|---|
| New Year's Day |
The first working day on or after the 1st of January. |
3rd January 2022 |
| Second January | The next working day after the New Year's Day holiday. | 4th January 2022 |
| Good Friday | The Friday that occurs immediately before Easter Sunday. | 15th April 2022 |
| Early May Bank Holiday | The first Monday in May. | 2nd May 2022 |
| Spring Bank Holiday | The last Monday in May. | 30th May 2022 |
|
Summer Bank Holiday |
The first Monday in August. |
1st August 2022 |
| St Andrew's Day | The first working day on or after the 30th November. | 30th November 2022 |
| Christmas Day |
The first working day on or after the 25th of December. |
26th December 2022 |
|
St Stephen's Day |
The next working day after the Christmas Day holiday. |
27th December 2022 |
Canada
|
Holiday |
Calendar date |
Example |
|---|---|---|
| New Year's Day |
The first working day on or after the 1st of January. |
3rd January 2022 |
| Good Friday | The Friday that occurs immediately before Easter Sunday. | 15th April 2022 |
| Easter Monday | The Monday that occurs immediately after Easter Sunday. | 18th April 2022 |
| Victoria Day | The Last Monday before the 25th of May. | 23rd May 2022 |
| Canada Day |
The 1st of July.
|
1st July 2022 |
| Labor Day | The first Monday in September. | 5th September 2022 |
| Thanksgiving Day | The second Monday in October. | 10th October 2022 |
|
Remembrance Day |
The first working day on or after the 11th of November. |
11th November 2022 |
| Christmas Day |
The 25th of December.
Christmas Day is currently incorrectly configured but will be fixed in a future version. See Known issues. |
26th December 2022 |
|
Boxing Day |
The 26th of December. |
26th December 2022 |
France
|
Holiday |
Calendar date |
Example |
|---|---|---|
| New Year's Day | The 1st of January. | 1st January 2022 |
| Good Friday | The Friday that occurs immediately before Easter Sunday. | 15th April 2022 |
| Easter Monday | The Monday that occurs immediately after Easter Sunday. | 18th April 2022 |
| May Day/Labor Day | The 1st of May. | 1st May 2022 |
| Victory in Europe Day | The 8th of May. | 8th May 2022 |
| Ascension Day | 39 days after Easter Sunday. | 26th May 2022 |
| Whit Monday | 50 Days after Easter Sunday. | 6th June 2022 |
| Bastille Day | The 14th of July. | 14th July 2022 |
|
Assumption of Mary to Heaven |
The 15th August. |
15th August 2022 |
|
All Saints Day |
The 1st of November. |
1st November 2022 |
|
Armistice Day |
The 11th of November. Armistice has been misspelled as Armistance in the database. This will be corrected in a future version. |
11th November 2022 |
|
Christmas Day |
The 25th of December. |
25th December 2022 |
|
St Stephen's Day |
The 26th of December. |
26th December 2022 |
Germany
|
Holiday |
Calendar date |
Example |
|---|---|---|
| New Year's Day | The 1st of January. | 1st January 2022 |
| Good Friday | The Friday that occurs immediately before Easter Sunday. | 15th April 2022 |
| Easter Monday | The Monday that occurs immediately after Easter Sunday. | 18th April 2022 |
| May Day | The 1st of May. | 1st May 2022 |
| Ascension Day | 39 days after Easter Sunday. | 26th May 2022 |
| Whit Monday | 50 Days after Easter Sunday. | 6th June 2022 |
| Day German Unity | The 3rd of October. | 3rd October 2022 |
| Christmas Day | The 25th of December. | 25th December 2022 |
|
Boxing Day (will be renamed to Second Day of Christmas in a future version). |
The 26th of December. |
26th December 2022 |
USA
|
Holiday |
Calendar date |
Example |
|---|---|---|
| New Year's Day |
The 1st of January.
|
31st December 2021 |
| Martin Luther King Jr. Day | The third Monday in January. | 21st February 2022 |
| President's Day | The third Monday in February. | 17th January 2022 |
| Memorial Day | The last Monday in May. | 30th May 2022 |
| Independence Day |
The 4th of July.
|
4th July 2022 |
| Labor Day | The first Monday in September. | 5th September 2022 |
| Columbus Day | The second Monday in October. | 10th October 2022 |
| Veterans Day |
The 11th of November.
|
11th November 2022 |
|
Thanksgiving Day |
The fourth Thursday in November. |
24th November 2022 |
|
Christmas Day |
The 25th of December.
|
25th December 2022 |
Japan
If your organization does not observe the January 2, January 3, or December 31 holidays, you can clear the checkbox for those dates so that they are not included in the calendar.
|
Holiday |
Calendar date |
Example |
|---|---|---|
| New Year's Day |
The 1st of January. If this is a Sunday, the holiday is moved to the next week day. |
1st January 2022 |
| January 2 Bank Holiday |
The day after New Year’s Day. If this is a Sunday, the holiday is moved to the next working day. |
3rd January 2022 |
| January 3 Bank Holiday |
The day after January 2 Bank Holiday. If this is a Sunday, the holiday is moved to the next working day. |
4th January 2022 |
| Coming of Age Day | The second Monday in January. | 10th January 2022 |
| National Foundation Day |
The 11th of February. If this is a Sunday, the holiday is moved to the next working day. |
11th February 2022 |
| Showa |
The 29th of April. If this is a Sunday, the holiday is moved to the next working day. |
29th April 2022 |
| Constitution Memorial Day |
The 3rd of May. If this is a Sunday, the holiday is moved to the next working day. |
3rd May 2022 |
| Greenery Day |
The day after Constitution Memorial Day. If this is a Sunday, the holiday is moved to the next working day. |
4th May 2022 |
|
Children's Day |
The day after Greenery Day. If this is a Sunday, the holiday is moved to the next working day. |
5th May 2022 |
|
Marine Day |
The third Monday in July. |
18th July 2022 |
|
Mountain Day |
The 11th August. If it's a Sunday, the holiday is moved to the next working day. |
11th August 2022 |
|
Respect for the Aged Day |
The third Monday in September. |
19th September 2022 |
|
Health and Sports Day |
The second Monday in October. |
10th October 2022 |
|
Culture Day |
The 3rd of November. If this is a Sunday, the holiday is moved to the next working day. |
3rd November 2022 |
|
Labor Thanksgiving Day |
The 23rd of November. If this is a Sunday, the holiday is moved to the next working day. |
23rd November 2022 |
|
December 31 Bank Holiday |
The 31st of December. If this is a Sunday, the holiday is moved to the next working day. |
31st December 2022 |
Hong Kong
|
Holiday |
Calendar date |
Example |
|---|---|---|
| New Year's Day |
The 1st of January. If this is a Sunday, the holiday is moved to the next working day. |
2nd January 2022 |
|
Hong Kong Special Administrative Region Establishment Day |
The 1st of July. If this is a Sunday, the holiday is moved to the next working day. |
1st July 2022 |
| National Day |
The 1st of October. If this is a Sunday, the holiday is moved to the next working day. |
1st October 2022 |
| Christmas Day |
The 25th of December. If this is a Sunday, the holiday is moved to the next working day. |
26th December 2022 |
| Boxing Day |
The day after the Christmas Day holiday. If this is a Sunday, the holiday is moved to the next working day. |
27th December 2022 |
China
|
Holiday |
Calendar date |
Example |
|---|---|---|
| New Year's Day | The first working day on or after the 1st of January. | 2nd January 2022 |
| Labor Day | The first working day on or after the 1st of May. | 2nd May 2022 |
| National Day |
The 1st of October. If this is a Sunday, the holiday is moved to the next working day. |
3rd October 2022 |
Mexico
|
Holiday |
Calendar date |
Example |
|---|---|---|
| New Year's Day | The 1st of January. | 1st January 2022 |
| Constitution Day | The 5th of February. | 5th February 2022 |
| Day off for Constitution Day | The first Monday in February. | 7th February 2022 |
| Day off for Benito Juarez's birthday memorial | The third Monday in March. | 21st March 2022 |
| Benito Juarez's birthday memorial | The 21st of March. | 21st March 2022 |
| Labor Day | The 1st of May. | 1st May 2022 |
| Independence Day | The 16th of September. | 16th September 2022 |
| Day off for Revolution Day | The third Monday in November. | 21st November 2022 |
|
Revolution Day |
The 20th of November. |
20th November 2022 |
|
Christmas Day |
The 25th of December. |
25th December 2022 |
Other Holidays
Any other days to be treated as non-working days can be specified in the Other Holidays list.
To add a holiday, select a date and click Add.
To remove a holiday, select the date in the list and click Remove.
Save a calendar
Click the save icon to save the calendar to the database.
Delete a calendar
Click the delete icon to delete the calendar.
